RenderPass QML Type

RenderPass 类型定义了用于渲染 3D 内容的自定义渲染通行证。更多

• 所有成员（包括继承成员）的列表

属性

• augmentShader : url
• clearColor : color
• commands : list<RenderCommand>
• depthClearValue : real
• materialMode : RenderPass::MaterialModes
• overrideMaterial : Material
• passMode : RenderPass::PassMode
• renderTargetFlags : RenderPass::RenderTargetFlags
• stencilClearValue : int

详细说明

通过 RenderPass，您可以在渲染管道中定义自定义渲染步骤。您可以指定各种属性，如透明色、材质模式和覆盖材质。此外，你还可以定义一个渲染命令列表，以指定渲染的执行方式。

向着色器公开数据

与 "效果 "和 "自定义材质 "一样，RenderPass 也会自动向着色器公开和更新用户定义的属性。

属性文档

augmentShader : url

当materialMode 设置为AugmentMaterial 时，该属性将保存用于渲染传递的增强着色器 URL。

着色器文件应包含一个具有以下签名的函数：

void MAIN_FRAGMENT_AUGMENT() {
    // Custom shader code here
}

此函数将与此渲染传递中被渲染对象所使用材质的现有片段着色器相结合。允许用户使用自定义代码增强现有的材质着色器。

clearColor : color [default: Qt.black]

该属性用于保存渲染传递的透明色。

commands : list<RenderCommand>

此属性包含渲染传递的渲染命令列表。

列表中的命令会按照它们在列表中出现的顺序执行。

另请参阅 renderTargetBlend,PipelineStateOverride,RenderablesFilter,RenderPassTexture,ColorAttachment,DepthTextureAttachment,DepthStencilAttachment 和AddDefine 。

depthClearValue : real [default: 1.0]

此属性用于保存渲染传递的深度清除值。

materialMode : RenderPass::MaterialModes [default: RenderPass.OriginalMaterial]

此属性用于保存渲染传递的材质模式。

overrideMaterial : Material

当materialMode 设置为OverrideMaterial 时，此属性将保存用于渲染传递的覆盖材质。

passMode : RenderPass::PassMode [default: RenderPass.UserPass]

此属性用于保存渲染传递的传递模式。

除了标准的用户渲染通道外，Qt Quick 3D 还支持用户手动触发内部渲染通道，以渲染天空盒和 2D 项目。

renderTargetFlags : RenderPass::RenderTargetFlags [default: RenderPass.RenderTargetFlags.None]

此属性用于保存渲染传递的渲染目标标志。

可能的值有

另请参阅 QRhiTextureRenderTarget::Flags 。

stencilClearValue : int [default: 0]

该属性用于保存渲染传递的模板清除值。