QSurface Class
Die Klasse „QSurface“ ist eine Abstraktion von darstellbaren Oberflächen in Qt. Mehr...
| Header: | #include <QSurface> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Vererbt an: |
Öffentliche Typen
| enum | SurfaceClass { Window, Offscreen } |
| enum | SurfaceType { RasterSurface, OpenGLSurface, OpenVGSurface, VulkanSurface, MetalSurface, Direct3DSurface } |
Öffentliche Funktionen
| virtual | ~QSurface() |
| virtual QSurfaceFormat | format() const = 0 |
| virtual QSize | size() const = 0 |
| bool | supportsOpenGL() const |
| QSurface::SurfaceClass | surfaceClass() const |
| virtual QPlatformSurface * | surfaceHandle() const = 0 |
| virtual QSurface::SurfaceType | surfaceType() const = 0 |
Geschützte Funktionen
| QSurface(QSurface::SurfaceClass type) |
Detaillierte Beschreibung
Die Größe der Oberfläche kann mit der Funktion ` size()` abgerufen werden. Die renderingspezifischen Attribute der Oberfläche sind über die Funktion ` format()` zugänglich.
Dokumentation zum Mitgliedstyp
enum QSurface::SurfaceClass
Die Enumeration „SurfaceClass“ beschreibt die tatsächliche Unterklasse der Oberfläche.
| Konstante | Wert | Beschreibung |
|---|---|---|
QSurface::Window | 0 | Die Oberfläche ist eine Instanz von „ QWindow “. |
QSurface::Offscreen | 1 | Die Oberfläche ist eine Instanz von ` QOffscreenSurface`. |
enum QSurface::SurfaceType
Die Enumeration „SurfaceType“ beschreibt, um welche Art von Oberfläche es sich handelt.
| Konstante | Wert | Beschreibung |
|---|---|---|
QSurface::RasterSurface | 0 | Die Oberfläche besteht aus Pixeln und kann mit einem Software-Rasterisierer wie der Raster-Paint-Engine von Qt gerendert werden. |
QSurface::OpenGLSurface | 1 | Die Oberfläche ist eine OpenGL-kompatible Oberfläche und kann in Verbindung mit „ QOpenGLContext “ verwendet werden. |
QSurface::OpenVGSurface | 3 | Die Oberfläche ist eine OpenVG-kompatible Oberfläche und kann in Verbindung mit OpenVG-Kontexten verwendet werden. |
QSurface::VulkanSurface | 4 | Die Oberfläche ist eine Vulkan-kompatible Oberfläche und kann in Verbindung mit der Vulkan-Grafik-API verwendet werden. |
QSurface::MetalSurface | 5 | Die Oberfläche ist Metal-kompatibel und kann in Verbindung mit Apples Metal-Grafik-API verwendet werden. Dieser Oberflächentyp wird nur unter macOS und iOS unterstützt. |
QSurface::Direct3DSurface | 6 | Die Oberfläche ist eine Direct 3D 11- und 12-kompatible Oberfläche und kann in Verbindung mit den DXGI- und Direct3D-APIs verwendet werden. Dieser Oberflächentyp wird nur unter Windows unterstützt. |
Dokumentation der Mitgliedsfunktionen
[explicit protected] QSurface::QSurface(QSurface::SurfaceClass type)
Erzeugt eine Fläche mit dem angegebenen „ type “.
[virtual noexcept] QSurface::~QSurface()
Zerstört die Oberfläche.
[pure virtual] QSurfaceFormat QSurface::format() const
Gibt das Format der Fläche zurück.
[pure virtual] QSize QSurface::size() const
Gibt die Größe der Fläche in Pixeln zurück.
bool QSurface::supportsOpenGL() const
Gibt „true“ zurück, wenn die Oberfläche OpenGL-kompatibel ist und in Verbindung mit „ QOpenGLContext “ verwendet werden kann; andernfalls wird „false“ zurückgegeben.
QSurface::SurfaceClass QSurface::surfaceClass() const
Gibt die Oberflächenklasse dieser Oberfläche zurück.
[pure virtual] QPlatformSurface *QSurface::surfaceHandle() const
Gibt ein Handle auf die plattformspezifische Implementierung der Oberfläche zurück.
[pure virtual] QSurface::SurfaceType QSurface::surfaceType() const
Gibt den Typ der Oberfläche zurück.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
