QRhiColorAttachment 类

成员函数文档

[constexpr noexcept] QRhiColorAttachment::QRhiColorAttachment()

构建一个空的颜色附加描述。

QRhiColorAttachment::QRhiColorAttachment(QRhiTexture *texture)

构建一个颜色附加描述，指定 texture 作为关联的颜色缓冲。

QRhiColorAttachment::QRhiColorAttachment(QRhiRenderBuffer *renderBuffer)

构建一个颜色附加描述，指定 renderBuffer 作为关联的颜色缓冲。

int QRhiColorAttachment::layer() const

返回层索引（立方体贴图面或数组层）。默认为0。

另请参阅：setLayer。

int QRhiColorAttachment::level() const

返回_mip_级别。默认为0。

另请参阅：setLevel。

[since 6.7] int QRhiColorAttachment::multiViewCount() const

返回当前设置的视图数。默认为0，表示带有此颜色附加的渲染目标将不用于多视图渲染。

此函数从Qt 6.7引入。

另请参阅：setMultiViewCount。

QRhiRenderBuffer *QRhiColorAttachment::renderBuffer() const

返回此附加描述引用的渲染缓冲区，如果没有则返回 nullptr。

在实践中，在通过多采样颜色渲染缓冲区设置多采样渲染时，将 QRhiRenderBuffer 与 QRhiColorAttachment 关联最有意义，该缓冲区在渲染流程结束时解析到一个非多采样纹理中。

另请参阅：setRenderBuffer。

int QRhiColorAttachment::resolveLayer() const

返回当前设置的解析纹理层。默认为0。

另见 setResolveLayer()。

int QRhiColorAttachment::resolveLevel() const

返回当前设置的解析纹理MIP级别。默认为0。

另见 setResolveLevel()。

QRhiTexture *QRhiColorAttachment::resolveTexture() const

返回此附件描述引用的解析纹理，如果没有则返回 nullptr。

设置非空解析纹理适用于此附加引用了多采样纹理或渲染缓冲区的情况。然后在 resolveTexture() 中的 QRhiTexture 是非多采样的2D纹理（或纹理数组），具有相同的大小（但样本数为1）。在每个渲染过程中结束时，会将多采样内容自动解析到该纹理中。

另见 setResolveTexture()。

void QRhiColorAttachment::setLayer(int layer)

设置 层 索引。

另见 layer()。

void QRhiColorAttachment::setLevel(int level)

设置 MIP 级别。

另见 level()。

[自6.7起] void QRhiColorAttachment::setMultiViewCount(int count)

设置 视图 数量。将值设置为大于1表示将使用多视图渲染。默认值为0。小于2的值表示不进行多视图渲染。

当 count 设置为 2 或更大时，颜色附加必须与2D纹理数组相关联。 layer() 和 multiViewCount() 一起定义了在多视图渲染期间的目标纹理数组元素范围。

例如，如果 layer 是 0 且 multiViewCount 是 2，则纹理数组必须有两个（或更多）元素，多视图渲染将针对元素0和1。此时，着色器中的 gl_ViewIndex 变量的值为 0 或 1，其中视图 0 对应纹理数组元素 0，视图 1 对应数组元素 1。

有关多视图渲染的更多详细信息，请参阅GL_OVR_multiview。请注意，Qt在OpenGL（ES）上运行时，也需要GL_OVR_multiview2。

只有在报告MultiView功能受支持时，才可使用isFeatureSupported()，多视图渲染才是可用的。

此函数从Qt 6.7引入。

另请参阅multiViewCount()。

void QRhiColorAttachment::setRenderBuffer(QRhiRenderBuffer *rb)

设置渲染缓冲区rb。

另请参阅renderBuffer。

void QRhiColorAttachment::setResolveLayer(int layer)

设置使用的解决纹理layer。

另请参阅resolveLayer。

void QRhiColorAttachment::setResolveLevel(int level)

设置使用的解决纹理米普level。

另请参阅resolveLevel。

void QRhiColorAttachment::setResolveTexture(QRhiTexture *tex)

设置使用的解决纹理tex。

tex预期是一个2D纹理或一个2D纹理数组。在任一情况下，解决都将针对tex的单个层（数组元素）的单个米普级别。米普级别和数组层由resolveLevel()和resolveLayer()指定。

一个例外是multiview：当颜色附件与一个纹理数组和启用多视图相关联时，解决纹理也必须是一个有足够元素供所有视图使用的纹理数组。在这种情况下，所有对应于视图的元素都将自动解决；行为类似于以下伪代码

for (i = 0; i < multiViewCount(); ++i)
    resolve texture's layer() + i into resolveTexture's resolveLayer() + i

将非多采样纹理设置在着色器传递结束时自动解决多采样纹理或渲染缓冲区，通常比使用多采样纹理（不设置解决纹理）更可取，因为这避免了编写仅与多采样纹理（sampler2DMS、texelFetch等）工作的专用片段着色器的需要，而允许使用与该附件纹理最初未被多采样一样相同的片段着色器。这以一个额外资源（非多采样tex）为代价。

另请参阅resolveTexture。

void QRhiColorAttachment::setTexture(QRhiTexture *tex)

设置纹理tex。

另请参阅纹理。

QRhiTexture *QRhiColorAttachment::texture() const

返回此附件描述引用的纹理，如果没有，则返回nullptr。

另请参阅setTexture。