En esta página

QSurface Class

La clase QSurface es una abstracción de las superficies renderizables en Qt. Más...

Cabecera: #include <QSurface>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Heredado por:

QOffscreenSurface y QWindow

Tipos Públicos

enum SurfaceClass { Window, Offscreen }
enum SurfaceType { RasterSurface, OpenGLSurface, OpenVGSurface, VulkanSurface, MetalSurface, Direct3DSurface }

Funciones Públicas

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

Funciones protegidas

QSurface(QSurface::SurfaceClass type)

Descripción detallada

El tamaño de la superficie es accesible con la función size(). Los atributos específicos de renderizado de la superficie son accesibles mediante la función format().

Documentación de tipos de miembros

enum QSurface::SurfaceClass

El enum SurfaceClass describe la subclase real de la superficie.

ConstanteValorDescripción
QSurface::Window0La superficie es una instancia de QWindow.
QSurface::Offscreen1La superficie es una instancia de QOffscreenSurface.

enum QSurface::SurfaceType

El enum SurfaceType describe de qué tipo de superficie se trata.

ConstanteValorDescripción
QSurface::RasterSurface0La superficie está compuesta de píxeles y puede ser renderizada usando un rasterizador de software como el motor de pintura raster de Qt.
QSurface::OpenGLSurface1La superficie es compatible con OpenGL y puede utilizarse junto con QOpenGLContext.
QSurface::OpenVGSurface3La superficie es compatible con OpenVG y puede utilizarse con contextos OpenVG.
QSurface::VulkanSurface4La superficie es compatible con Vulkan y puede utilizarse junto con la API gráfica Vulkan.
QSurface::MetalSurface5La superficie es compatible con Metal y puede utilizarse junto con la API de gráficos Metal de Apple. Este tipo de superficie solo es compatible con macOS e iOS.
QSurface::Direct3DSurface6La superficie es compatible con Direct 3D 11 y 12 y puede utilizarse junto con las API DXGI y Direct3D. Este tipo de superficie sólo es compatible con Windows.

Documentación de las funciones miembro

[explicit protected] QSurface::QSurface(QSurface::SurfaceClass type)

Crea una superficie con la dirección type.

[virtual noexcept] QSurface::~QSurface()

Destruye la superficie.

[pure virtual] QSurfaceFormat QSurface::format() const

Devuelve el formato de la superficie.

[pure virtual] QSize QSurface::size() const

Devuelve el tamaño de la superficie en píxeles.

bool QSurface::supportsOpenGL() const

Devuelve true si la superficie es compatible con OpenGL y puede utilizarse junto con QOpenGLContext; en caso contrario devuelve false.

QSurface::SurfaceClass QSurface::surfaceClass() const

Devuelve la clase de superficie de esta superficie.

[pure virtual] QPlatformSurface *QSurface::surfaceHandle() const

Devuelve un manejador a la implementación específica de la plataforma de la superficie.

[pure virtual] QSurface::SurfaceType QSurface::surfaceType() const

Devuelve el tipo de la superficie.

© 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.