本页内容

PipelineStateOverride QML Type

为单个pass 定义管道状态覆盖规则。更多...

Import Statement: import QtQuick3D
Since: Qt 6.11
Inherits:

Command

属性

详细说明

PipelineStateOverride 是一个Command ,可添加到RenderPass 的命令列表中。执行时,它将根据PipelineStateOverride上设置的属性,在渲染阶段覆盖管道状态。只有已设置的值才会覆盖现有管道状态的值。 若要将已被覆盖的值重置为默认值,请将该属性设置为undefined 。

另请参阅 renderTargetBlend 。

属性文档

blendEnabled : bool

如果设置为true ,则启用渲染通道的混合功能;如果设置为false ,则禁用混合功能。若要设置每个附件的混合参数,请使用targetBlend0 至targetBlend7 属性。

cullMode : enumeration

设置渲染通道的面剔除模式。

常量描述
PipelineStateOverride.None不进行面剔除。
PipelineStateOverride.Front剔除朝向前方的多边形。
PipelineStateOverride.Back剔除背向多边形。

depthFunction : enumeration

设置渲染通道的深度比较函数。

常量描述
PipelineStateOverride.Never深度测试永远不会通过。
PipelineStateOverride.Less当传入的深度小于存储的深度时,深度测试通过。
PipelineStateOverride.Equal当传入的深度等于存储的深度时,深度测试通过。
PipelineStateOverride.LessOrEqual当传入的深度小于或等于存储的深度时,深度测试通过。
PipelineStateOverride.Greater当传入的深度大于存储的深度时,深度测试通过。
PipelineStateOverride.NotEqual当传入的深度不等于存储的深度时,深度测试通过。
PipelineStateOverride.GreaterOrEqual当传入深度大于或等于存储深度时,深度测试通过。
PipelineStateOverride.Always深度测试总是通过。

depthTestEnabled : bool

如果设置为true ,则为渲染通道启用深度测试;如果设置为false ,则禁用深度测试。将此属性设置为true 时,渲染通道必须具有深度附件。

depthWriteEnabled : bool

如果设置为true ,则为渲染通道启用深度写入。如果设置为false ,则禁用深度写入。将此属性设置为true 时,渲染通道需要一个深度附件。

polygonMode : enumeration

设置渲染通道的多边形光栅化模式。

常量说明
PipelineStateOverride.Fill多边形被填充(默认)。
PipelineStateOverride.Line多边形边以线条形式绘制(线框)。

scissor : rect

设置渲染通道的剪裁矩形。位于该矩形之外的片段将被舍弃。要求usesScissor 的值设置为true 。

stencilReference : uint

设置渲染通道的模板参考值。当usesStencilReference 为true 时,该值将用于模板比较运算。

stencilWriteMask : uint

设置渲染通道的模板写入掩码。每个位控制是否可以写入模板缓冲区中的相应位。

targetBlend0 : renderTargetBlend

设置渲染通道中颜色附件 0 的混合参数。

另请参阅 renderTargetBlend 。

targetBlend1 : renderTargetBlend

设置渲染通道中颜色附件 1 的混合参数。

另请参阅 renderTargetBlend 。

targetBlend2 : renderTargetBlend

设置渲染通道中第 2 个颜色附件的混合参数。

另请参阅 renderTargetBlend 。

targetBlend3 : renderTargetBlend

设置渲染通道中第3个颜色附件的混合参数。

另请参阅 renderTargetBlend 。

targetBlend4 : renderTargetBlend

设置渲染通道中第4个颜色附着层的混合参数。

另请参阅 renderTargetBlend 。

targetBlend5 : renderTargetBlend

设置渲染通道中第5个颜色附件的混合参数。

另请参阅 renderTargetBlend 。

targetBlend6 : renderTargetBlend

设置渲染通道中第6个颜色附件的混合参数。

另请参阅 renderTargetBlend 。

targetBlend7 : renderTargetBlend

设置渲染通道中第 7 个颜色附件的混合参数。

另请参阅 renderTargetBlend 。

usesScissor : bool

如果设置为true ,则为渲染通道启用剪切测试。如果设置为false ,则禁用剪切测试。请使用scissor 属性来设置剪切矩形。

usesStencilReference : bool

如果设置为true ,则启用在渲染通道中使用模板参考值。如果设置为false ,则禁用在渲染通道中使用模板参考值。

viewport : rect

设置渲染通道的视口矩形。该矩形以像素为单位(x、y、宽度、高度)指定渲染目标中要绘制的区域。如果未设置,则使用渲染目标的完整尺寸。

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