The QSurfaceFormat 類錶示格式為 QSurface . 更多...
| 頭： | #include <QSurfaceFormat> |
| qmake: | QT += gui |
| Since: | Qt 5.0 |
| enum | FormatOption { StereoBuffers, DebugContext, DeprecatedFunctions, ResetNotification } |
| flags | FormatOptions |
| enum | OpenGLContextProfile { NoProfile, CoreProfile, CompatibilityProfile } |
| enum | RenderableType { DefaultRenderableType, OpenGL, OpenGLES, OpenVG } |
| enum | SwapBehavior { DefaultSwapBehavior, SingleBuffer, DoubleBuffer, TripleBuffer } |
| QSurfaceFormat () | |
| QSurfaceFormat (FormatOptions options ) | |
| QSurfaceFormat (const QSurfaceFormat & other ) | |
| ~QSurfaceFormat () | |
| int | alphaBufferSize () const |
| int | blueBufferSize () const |
| int | depthBufferSize () const |
| int | greenBufferSize () const |
| bool | hasAlpha () const |
| int | majorVersion () const |
| int | minorVersion () const |
| QSurfaceFormat::FormatOptions | options () const |
| OpenGLContextProfile | profile () const |
| int | redBufferSize () const |
| RenderableType | renderableType () const |
| int | samples () const |
| void | setAlphaBufferSize (int size ) |
| void | setBlueBufferSize (int size ) |
| void | setDepthBufferSize (int size ) |
| void | setGreenBufferSize (int size ) |
| void | setMajorVersion (int major ) |
| void | setMinorVersion (int minor ) |
| void | setOption (FormatOption option , bool on = true) |
| void | setOptions (QSurfaceFormat::FormatOptions options ) |
| void | setProfile (OpenGLContextProfile profile ) |
| void | setRedBufferSize (int size ) |
| void | setRenderableType (RenderableType type ) |
| void | setSamples (int numSamples ) |
| void | setStencilBufferSize (int size ) |
| void | setStereo (bool enable ) |
| void | setSwapBehavior (SwapBehavior behavior ) |
| void | setSwapInterval (int interval ) |
| void | setVersion (int major , int minor ) |
| int | stencilBufferSize () const |
| bool | stereo () const |
| SwapBehavior | swapBehavior () const |
| int | swapInterval () const |
| bool | testOption (FormatOption option ) const |
| QPair<int, int> | version () const |
| QSurfaceFormat & | operator= (const QSurfaceFormat & other ) |
| QSurfaceFormat | defaultFormat () |
| void | setDefaultFormat (const QSurfaceFormat & format ) |
| bool | operator!= (const QSurfaceFormat & a , const QSurfaceFormat & b ) |
| bool | operator== (const QSurfaceFormat & a , const QSurfaceFormat & b ) |
The QSurfaceFormat 類錶示格式為 QSurface .
The format includes the size of the color buffers, red, green, and blue; the size of the alpha buffer; the size of the depth and stencil buffers; and number of samples per pixel for multisampling. In addition, the format contains surface configuration parameters such as OpenGL profile and version for rendering, whether or not to enable stereo buffers, and swap behaviour.
此枚舉包含的格式選項用於 QSurfaceFormat .
| 常量 | 值 | 描述 |
|---|---|---|
QSurfaceFormat::StereoBuffers
|
0x0001
|
用於請求錶麵格式的立體緩衝。 |
QSurfaceFormat::DebugContext
|
0x0002
|
Used to request a debug context with extra debugging information. |
QSurfaceFormat::DeprecatedFunctions
|
0x0004
|
Used to request that deprecated functions be included in the OpenGL context profile. If not specified, you should get a forward compatible context without support functionality marked as deprecated. This requires OpenGL version 3.0 or higher. |
QSurfaceFormat::ResetNotification
|
0x0008
|
Enables notifications about resets of the OpenGL context. The status is then queryable via the context's isValid() function. Note that not setting this flag does not guarantee that context state loss never occurs. Additionally, some implementations may choose to report context loss regardless of this flag. |
FormatOptions 類型是 typedef 對於 QFlags <FormatOption>。它存儲 FormatOption 值的 OR 組閤。
This enum is used to specify the OpenGL context profile, in conjunction with QSurfaceFormat::setMajorVersion () 和 QSurfaceFormat::setMinorVersion ().
Profiles are exposed in OpenGL 3.2 and above, and are used to choose between a restricted core profile, and a compatibility profile which might contain deprecated support functionality.
Note that the core profile might still contain functionality that is deprecated and scheduled for removal in a higher version. To get access to the deprecated functionality for the core profile in the set OpenGL version you can use the QSurfaceFormat format option QSurfaceFormat::DeprecatedFunctions .
| 常量 | 值 | 描述 |
|---|---|---|
QSurfaceFormat::NoProfile
|
0
|
OpenGL version is lower than 3.2. For 3.2 and newer this is same as CoreProfile. |
QSurfaceFormat::CoreProfile
|
1
|
Functionality deprecated in OpenGL version 3.0 is not available. |
QSurfaceFormat::CompatibilityProfile
|
2
|
Functionality from earlier OpenGL versions is available. |
此枚舉指定錶麵的渲染後端。
| 常量 | 值 | 描述 |
|---|---|---|
QSurfaceFormat::DefaultRenderableType
|
0x0
|
默認，未指定渲染方法 |
QSurfaceFormat::OpenGL
|
0x1
|
桌麵 OpenGL 渲染 |
QSurfaceFormat::OpenGLES
|
0x2
|
OpenGL ES 2.0 渲染 |
QSurfaceFormat::OpenVG
|
0x4
|
開放嚮量圖形渲染 |
此枚舉用於 QSurfaceFormat to specify the swap behaviour of a surface. The swap behaviour is mostly transparent to the application, but it affects factors such as rendering latency and throughput.
| 常量 | 值 | 描述 |
|---|---|---|
QSurfaceFormat::DefaultSwapBehavior
|
0
|
默認，平颱未指定交換行為。 |
QSurfaceFormat::SingleBuffer
|
1
|
Used to request single buffering, which might result in flickering when OpenGL rendering is done directly to screen without an intermediate offscreen buffer. |
QSurfaceFormat::DoubleBuffer
|
2
|
This is typically the default swap behaviour on desktop platforms, consisting of one back buffer and one front buffer. Rendering is done to the back buffer, and then the back buffer and front buffer are swapped, or the contents of the back buffer are copied to the front buffer, depending on the implementation. |
QSurfaceFormat::TripleBuffer
|
3
|
This swap behaviour is sometimes used in order to decrease the risk of skipping a frame when the rendering rate is just barely keeping up with the screen refresh rate. Depending on the platform it might also lead to slightly more efficient use of the GPU due to improved pipelining behaviour. Triple buffering comes at the cost of an extra frame of memory usage and latency, and might not be supported depending on the underlying platform. |
構造默認初始化 QSurfaceFormat .
注意： 默認情況下 OpenGL 2.0 is requested since this provides the highest grade of portability between platforms and OpenGL implementations.
構造 QSurfaceFormat 采用給定格式 options .
構造副本為 other .
銷毀 QSurfaceFormat .
Get the size in bits of the alpha channel of the color buffer.
另請參閱 setAlphaBufferSize ().
Get the size in bits of the blue channel of the color buffer.
另請參閱 setBlueBufferSize ().
[static]
QSurfaceFormat
QSurfaceFormat::
defaultFormat
()
返迴全局默認錶麵格式。
當 setDefaultFormat () 未被調用，這是默認構造的 QSurfaceFormat .
該函數在 Qt 5.4 引入。
另請參閱 setDefaultFormat ().
返迴深度緩衝大小。
另請參閱 setDepthBufferSize ().
Get the size in bits of the green channel of the color buffer.
另請參閱 setGreenBufferSize ().
返迴
true
if the alpha buffer size is greater than zero.
This means that the surface might be used with per pixel translucency effects.
Returns the major OpenGL 版本。
默認版本為 2.0。
另請參閱 setMajorVersion ().
Returns the minor OpenGL 版本。
另請參閱 setMinorVersion ().
返迴目前設置的格式選項。
該函數在 Qt 5.3 引入。
另請參閱 setOption (), setOptions ()，和 testOption ().
Get the configured OpenGL context profile.
This setting is ignored if the requested OpenGL version is less than 3.2.
另請參閱 setProfile ().
Get the size in bits of the red channel of the color buffer.
另請參閱 setRedBufferSize ().
獲取可渲染類型。
Chooses between desktop OpenGL , OpenGL ES, and OpenVG .
另請參閱 setRenderableType ().
Returns the number of samples per pixel when multisampling is enabled. By default, multisampling is disabled.
另請參閱 setSamples ().
設置期望 size in bits of the alpha channel of the color buffer.
另請參閱 alphaBufferSize ().
設置期望 size in bits of the blue channel of the color buffer.
注意： On Mac OSX, be sure to set the buffer size of all color channels, otherwise this setting will have no effect. If one of the buffer sizes is not set, the current bit-depth of the screen is used.
另請參閱 blueBufferSize ().
[static]
void
QSurfaceFormat::
setDefaultFormat
(const
QSurfaceFormat
&
format
)
Sets the global default surface format .
This format is used by default in QOpenGLContext , QWindow , QOpenGLWidget and similar classes.
It can always be overridden on a per-instance basis by using the class in question's own setFormat() function. However, it is often more convenient to set the format for all windows once at the start of the application. It also guarantees proper behavior in cases where shared contexts are required, because settings the format via this function guarantees that all contexts and surfaces, even the ones created internally by Qt, will use the same format.
注意： When setting Qt::AA_ShareOpenGLContexts , it is strongly recommended to place the call to this function before the construction of the QGuiApplication or QApplication . Otherwise format will not be applied to the global share context and therefore issues may arise with context sharing afterwards.
該函數在 Qt 5.4 引入。
另請參閱 defaultFormat ().
Set the minimum depth buffer size to size .
另請參閱 depthBufferSize ().
設置期望 size in bits of the green channel of the color buffer.
注意： On Mac OSX, be sure to set the buffer size of all color channels, otherwise this setting will have no effect. If one of the buffer sizes is not set, the current bit-depth of the screen is used.
另請參閱 greenBufferSize ().
設置期望 major OpenGL 版本。
另請參閱 majorVersion ().
設置期望 minor OpenGL 版本。
默認版本為 2.0。
另請參閱 minorVersion ().
Sets the format option option if on is true; otherwise, clears the option.
該函數在 Qt 5.3 引入。
另請參閱 setOptions (), options ()，和 testOption ().
Sets the format options to options .
該函數在 Qt 5.3 引入。
另請參閱 options () 和 testOption ().
設置期望 OpenGL context profile .
This setting is ignored if the requested OpenGL version is less than 3.2.
另請參閱 profile ().
設置期望 size in bits of the red channel of the color buffer.
注意： On Mac OSX, be sure to set the buffer size of all color channels, otherwise this setting will have no effect. If one of the buffer sizes is not set, the current bit-depth of the screen is used.
另請參閱 redBufferSize ().
設置期望可渲染 type .
Chooses between desktop OpenGL , OpenGL ES, and OpenVG .
另請參閱 renderableType ().
Set the preferred number of samples per pixel when multisampling is enabled to numSamples . By default, multisampling is disabled.
另請參閱 samples ().
將首選蠟紙緩衝大小設為 size 位。
另請參閱 stencilBufferSize ().
若 enable is true enables stereo buffering; otherwise disables stereo buffering.
默認情況下，立體緩衝是禁用的。
Stereo buffering provides extra color buffers to generate left-eye and right-eye images.
另請參閱 stereo ().
設置交換 behavior 為錶麵。
The swap behavior specifies whether single, double, or triple buffering is desired. The default, DefaultSwapBehavior , gives the default swap behavior of the platform.
另請參閱 swapBehavior ().
Sets the preferred swap interval. The swap interval specifies the minimum number of video frames that are displayed before a buffer swap occurs. This can be used to sync the GL drawing into a window to the vertical refresh of the screen.
Setting an interval value of 0 will turn the vertical refresh syncing off, any value higher than 0 will turn the vertical syncing on. Setting interval to a higher value, for example 10, results in having 10 vertical retraces between every buffer swap.
默認間隔為 1。
Changing the swap interval may not be supported by the underlying platform. In this case, the request will be silently ignored.
該函數在 Qt 5.3 引入。
另請參閱 swapInterval ().
設置期望 major and minor OpenGL versions.
默認版本為 2.0。
另請參閱 version ().
返迴蠟紙緩衝大小 (以位為單位)。
另請參閱 setStencilBufferSize ().
返迴
true
if stereo buffering is enabled; otherwise returns false. Stereo buffering is disabled by default.
另請參閱 setStereo ().
返迴配置的交換行為。
另請參閱 setSwapBehavior ().
返迴交換間隔。
該函數在 Qt 5.3 引入。
另請參閱 setSwapInterval ().
返迴 true 若格式選項 option 有設置；否則返迴 false。
該函數在 Qt 5.3 引入。
另請參閱 options ().
返迴 QPair <int, int> 錶示 OpenGL 版本。
Useful for version checks, for example format.version() >= qMakePair (3, 2)
另請參閱 setVersion ().
賦值 other 到此對象。
返迴
false
若所有選項對於兩
QSurfaceFormat
對象
a
and
b
相等；否則返迴
true
.
返迴
true
若所有選項對於兩
QSurfaceFormat
對象
a
and
b
相等。