QSurface Class

The QSurface class is an abstraction of renderable surfaces in Qt. More...

Header: #include <QSurface>
qmake: QT += gui
Since: Qt 5.0
Inherited By:

QOffscreenSurface and QWindow

Public Types

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

Public Functions

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

Static Public Members

const QMetaObject staticMetaObject

Protected Functions

QSurface(QSurface::SurfaceClass type)

Protected Variables

QSurfacePrivate *m_reserved
QSurface::SurfaceClass m_type

Detailed Description

The QSurface class is an abstraction of renderable surfaces in Qt.

The size of the surface is accessible with the size() function. The rendering specific attributes of the surface are accessible through the format() function.

Member Type Documentation

enum QSurface::SurfaceClass

The SurfaceClass enum describes the actual subclass of the surface.

ConstantValueDescription
QSurface::Window0The surface is an instance of QWindow.
QSurface::Offscreen1The surface is an instance of QOffscreenSurface.

enum QSurface::SurfaceType

The SurfaceType enum describes what type of surface this is.

ConstantValueDescription
QSurface::RasterSurface0The surface is is composed of pixels and can be rendered to using a software rasterizer like Qt's raster paint engine.
QSurface::OpenGLSurface1The surface is an OpenGL compatible surface and can be used in conjunction with QOpenGLContext.
QSurface::RasterGLSurface2The surface can be rendered to using a software rasterizer, and also supports OpenGL. This surface type is intended for internal Qt use, and requires the use of private API.
QSurface::OpenVGSurface3The surface is an OpenVG compatible surface and can be used in conjunction with OpenVG contexts.
QSurface::VulkanSurface4The surface is a Vulkan compatible surface and can be used in conjunction with the Vulkan graphics API.
QSurface::MetalSurface5The surface is a Metal compatible surface and can be used in conjunction with Apple's Metal graphics API. This surface type is supported on macOS only.

Member Function Documentation

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

Creates a surface with the given type.

[virtual] QSurface::~QSurface()

Destroys the surface.

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

Returns the format of the surface.

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

Returns the size of the surface in pixels.

bool QSurface::supportsOpenGL() const

Returns true if the surface is OpenGL compatible and can be used in conjunction with QOpenGLContext; otherwise returns false.

This function was introduced in Qt 5.3.

QSurface::SurfaceClass QSurface::surfaceClass() const

Returns the surface class of this surface.

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

Returns a handle to the platform-specific implementation of the surface.

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

Returns the type of the surface.

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