QSurfaceFormat类

成员函数文档

QSurfaceFormat::QSurfaceFormat()

构造一个默认初始化的QSurfaceFormat。

QSurfaceFormat::QSurfaceFormat(QSurfaceFormat::FormatOptions options)

使用给定的格式options构造一个QSurfaceFormat。

QSurfaceFormat::QSurfaceFormat(const QSurfaceFormat &other)

构造一个other的副本。

[noexcept] QSurfaceFormat::~QSurfaceFormat()

销毁 QSurfaceFormat。

int QSurfaceFormat::alphaBufferSize() const

获取颜色缓冲区alpha通道的位数。

另请参阅setAlphaBufferSize。

int QSurfaceFormat::blueBufferSize() const

获取颜色缓冲区blue通道的位数。

另请参阅setBlueBufferSize。

const QColorSpace &QSurfaceFormat::colorSpace() const

返回颜色空间。

另请参阅setColorSpace。

[static] QSurfaceFormat QSurfaceFormat::defaultFormat()

返回全局默认表面格式。

当未调用setDefaultFormat()时，这是一个默认构造的QSurfaceFormat。

另请参阅setDefaultFormat。

int QSurfaceFormat::depthBufferSize() const

返回深度缓冲区的尺寸。

另请参阅setDepthBufferSize。

int QSurfaceFormat::greenBufferSize() const

获取颜色缓冲区green通道的位数。

另请参阅setGreenBufferSize。

bool QSurfaceFormat::hasAlpha() const

如果_alpha_缓冲区大小大于零，则返回true。

这意味着该表面可能用于像素级半透明效果。

int QSurfaceFormat::majorVersion() const

返回主要的OpenGL版本。

默认版本是2.0。

另请参阅setMajorVersion。

int QSurfaceFormat::minorVersion() const

返回次要OpenGL版本。

另请参阅setMinorVersion。

QSurfaceFormat::FormatOptions QSurfaceFormat::options() const

返回当前设置的格式选项。

另请参阅setOption，setOptions和testOption。

QSurfaceFormat::OpenGLContextProfile QSurfaceFormat::profile() const

获取配置的OpenGL上下文配置文件。

如果请求的OpenGL版本小于3.2，则忽略此设置。

另请参阅setProfile。

int QSurfaceFormat::redBufferSize() const

获取颜色缓冲区红色通道的位数大小。

另请参阅setRedBufferSize。

QSurfaceFormat::RenderableType QSurfaceFormat::renderableType() const

获取可渲染的类型。

在桌面OpenGL、OpenGL ES和OpenVG之间进行选择。

另请参阅setRenderableType。

int QSurfaceFormat::samples() const

当启用多采样时，返回每像素的样本数，或者当禁用多采样时返回-1。默认返回值是-1。

另请参阅setSamples。

void QSurfaceFormat::setAlphaBufferSize(int size)

设置颜色缓冲区_alpha_通道所需的位数大小。

另请参阅alphaBufferSize。

void QSurfaceFormat::setBlueBufferSize(int size)

设置颜色缓冲区蓝色通道所需的位数大小。

另请参阅blueBufferSize。

[自6.0开始] void QSurfaceFormat::setColorSpace(const QColorSpace &colorSpace)

设置首选的色彩空间。

例如，这允许在支持该功能的平台上请求默认帧缓冲区支持sRGB的窗口。

此函数是在 Qt 6.0 中引入的。

参见：colorSpace()。

[静态] void QSurfaceFormat::setDefaultFormat(const QSurfaceFormat &format)

设置全局默认表面格式。

此格式默认用于 QOpenGLContext，QWindow，QOpenGLWidget 等类似类。

可以使用相关类的自身 setFormat() 函数以实例方式覆盖此格式。然而，在应用程序启动时一次性为所有窗口设置格式往往更方便。它还确保在需要共享上下文的情况下正确行为，因为通过此函数设置格式可保证所有上下文和表面（包括 Qt 内部创建的），都将使用相同的格式。

参见：defaultFormat()。

void QSurfaceFormat::setDepthBufferSize(int size)

设置最小深度缓冲区大小为 size。

参见：depthBufferSize()。

void QSurfaceFormat::setGreenBufferSize(int size)

设置色彩缓冲区绿色通道所需的 size 比特。

参见：greenBufferSize()。

void QSurfaceFormat::setMajorVersion(int major)

设置所需的 major OpenGL 版本。

参见：majorVersion()。

void QSurfaceFormat::setMinorVersion(int minor)

设置所需的 minor OpenGL 版本。

默认版本是2.0。

参见：minorVersion()。

void QSurfaceFormat::setOption(QSurfaceFormat::FormatOption option, bool on = true)

如果 on 为 true，则设置格式选项 option；否则，清除选项。

为验证选项是否得到尊重，在创建表面/上下文后比较实际的格式与请求的格式。

参见：setOptions(), options 以及 testOption()。

void QSurfaceFormat::setOptions(QSurfaceFormat::FormatOptions options)

设置格式选项为options。

为验证选项是否得到尊重，在创建表面/上下文后比较实际的格式与请求的格式。

另请参阅options() 和 testOption。

void QSurfaceFormat::setProfile(QSurfaceFormat::OpenGLContextProfile profile)

设置期望的OpenGL上下文profile。

如果请求的OpenGL版本小于3.2，则忽略此设置。

另请参阅profile。

void QSurfaceFormat::setRedBufferSize(int size)

设置颜色缓冲区红色通道期望的size位。

另请参阅redBufferSize。

void QSurfaceFormat::setRenderableType(QSurfaceFormat::RenderableType type)

设置期望的可渲染type。

在桌面OpenGL、OpenGL ES和OpenVG之间进行选择。

另请参阅renderableType。

void QSurfaceFormat::setSamples(int numSamples)

当启用多采样时，设置每像素首选样本数到numSamples。默认情况下，多采样是禁用的。

另请参阅samples。

void QSurfaceFormat::setStencilBufferSize(int size)

设置期望的模板缓冲区大小为size位。

另请参阅stencilBufferSize。

void QSurfaceFormat::setStereo(bool enable)

如果enable为true，将启用立体缓冲区；否则禁用立体缓冲区。

默认情况下，立体缓冲区是禁用的。

立体缓冲区提供了额外的颜色缓冲区来生成左眼和右眼图像。

另请参阅stereo。

void QSurfaceFormat::setSwapBehavior(QSurfaceFormat::SwapBehavior behavior)

设置表面的交换behavior。

交换行为指定是否需要单缓冲、双缓冲或三缓冲。默认情况下，DefaultSwapBehavior给出了平台的默认交换行为。

另请参阅swapBehavior。

void QSurfaceFormat::setSwapInterval(int interval)

设置首选的交换间隔。交换间隔指定在缓冲区交换之前显示的最小视频帧数。这可以用来将GL绘图与屏幕的垂直刷新同步。

将interval值设置为0将关闭垂直刷新同步，任何大于0的值将打开垂直同步。将interval设置为更高的值，例如10，意味着每交换一次缓冲区之间有10次垂直扫描。

默认间隔是1。

更改交换间隔可能不被底层平台支持。在这种情况下，请求将被静默忽略。

另请参阅 swapInterval。

void QSurfaceFormat::setVersion(int major, int minor)

设置所需的 major 和 minor OpenGL 版本。

默认版本是2.0。

另请参阅 version。

int QSurfaceFormat::stencilBufferSize() const

返回束线缓冲区的大小（位）。

另请参阅 setStencilBufferSize。

bool QSurfaceFormat::stereo() const

如果启用立体缓冲区，则返回 true；否则返回 false。立体缓冲区默认情况下是禁用的。

另请参阅 setStereo。

QSurfaceFormat::SwapBehavior QSurfaceFormat::swapBehavior() const

返回配置的交换行为。

另请参阅 setSwapBehavior。

int QSurfaceFormat::swapInterval() const

返回交换间隔。

另请参阅 setSwapInterval。

bool QSurfaceFormat::testOption(QSurfaceFormat::FormatOption option) const

如果设置了格式选项 option，则返回 true；否则返回 false。

另请参阅 options。

QPair<int, int> QSurfaceFormat::version() const

返回一个表示 OpenGL 版本的 QPair<int, int>。

对于版本检查很有用，例如 format.version() >= qMakePair(3, 2)

另请参阅 setVersion。

QSurfaceFormat &QSurfaceFormat::operator=(const QSurfaceFormat &other)

将 other 赋值给此对象。