blob: b8083641c2e6b444b662b5f88b5229bf593e9dd1 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
|
// Copyright (C) 2016 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
#include "qsurface.h"
#include "qopenglcontext.h"
#include <qpa/qplatformintegration.h>
#include <QtGui/private/qguiapplication_p.h>
QT_BEGIN_NAMESPACE
QT_IMPL_METATYPE_EXTERN_TAGGED(QSurface*, QSurface_ptr)
/*!
\class QSurface
\inmodule QtGui
\since 5.0
\brief 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.
*/
/*!
\enum QSurface::SurfaceClass
The SurfaceClass enum describes the actual subclass of the surface.
\value Window The surface is an instance of QWindow.
\value Offscreen The surface is an instance of QOffscreenSurface.
*/
/*!
\enum QSurface::SurfaceType
The SurfaceType enum describes what type of surface this is.
\value RasterSurface The surface is is composed of pixels and can be rendered to using
a software rasterizer like Qt's raster paint engine.
\value OpenGLSurface The surface is an OpenGL compatible surface and can be used
in conjunction with QOpenGLContext.
\value RasterGLSurface The 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.
\value OpenVGSurface The surface is an OpenVG compatible surface and can be used
in conjunction with OpenVG contexts.
\value VulkanSurface The surface is a Vulkan compatible surface and can be used
in conjunction with the Vulkan graphics API.
\value MetalSurface The surface is a Metal compatible surface and can be used
in conjunction with Apple's Metal graphics API. This surface type is only supported
on \macos and iOS.
\value Direct3DSurface The surface is a Direct 3D 11 and 12 compatible
surface and can be used in conjunction with the DXGI and Direct3D APIs. This
surface type is only supported on Windows.
*/
/*!
\fn QSurfaceFormat QSurface::format() const
Returns the format of the surface.
*/
/*!
Returns true if the surface is OpenGL compatible and can be used in
conjunction with QOpenGLContext; otherwise returns false.
\since 5.3
*/
bool QSurface::supportsOpenGL() const
{
SurfaceType type = surfaceType();
if (type == RasterSurface) {
QPlatformIntegration *integ = QGuiApplicationPrivate::instance()->platformIntegration();
return integ->hasCapability(QPlatformIntegration::OpenGLOnRasterSurface);
}
return type == OpenGLSurface || type == RasterGLSurface;
}
/*!
\fn QPlatformSurface *QSurface::surfaceHandle() const
Returns a handle to the platform-specific implementation of the surface.
*/
/*!
\fn SurfaceType QSurface::surfaceType() const
Returns the type of the surface.
*/
/*!
\fn QSize QSurface::size() const
Returns the size of the surface in pixels.
*/
/*!
Creates a surface with the given \a type.
*/
QSurface::QSurface(SurfaceClass type)
: m_type(type), m_reserved(nullptr)
{
}
/*!
Destroys the surface.
*/
QSurface::~QSurface()
{
#ifndef QT_NO_OPENGL
QOpenGLContext *context = QOpenGLContext::currentContext();
if (context && context->surface() == this)
context->doneCurrent();
#endif
}
/*!
Returns the surface class of this surface.
*/
QSurface::SurfaceClass QSurface::surfaceClass() const
{
return m_type;
}
QT_END_NAMESPACE
#include "moc_qsurface.cpp"
|
