En esta página

RenderPass QML Type

El tipo RenderPass define un pase de renderizado personalizado para renderizar contenido 3D. Más...

Import Statement: import QtQuick3D
Since: Qt 6.11
Inherits:

Object3D

Propiedades

Descripción detallada

Un RenderPass le permite definir un paso de renderizado personalizado en el pipeline de renderizado. Puede especificar varias propiedades como el color claro, el modo de material y los materiales de anulación. Además, puedes definir una lista de comandos de renderizado que dictan cómo debe realizarse el renderizado.

Exponer datos a los shaders

Al igual que con los Efectos y Materiales Personalizados, el RenderPass expondrá, y actualizará, las propiedades definidas por el usuario al shader automáticamente.

Documentación de Propiedades

augmentShader : url

Esta propiedad contiene la URL del sombreador de aumento para el pase de renderizado cuando materialMode se establece en AugmentMaterial.

El archivo shader debe contener una función con la siguiente firma:

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

Esta función se combinará con el fragment shader existente del material que está siendo utilizado por el objeto que está siendo renderizado en este pase de render. Permitiendo a los usuarios aumentar el shader de material existente con código personalizado.

clearColor : color [default: Qt.black]

Esta propiedad contiene el color claro para el pase de renderizado.

commands : list<RenderCommand>

Esta propiedad contiene la lista de comandos de renderizado para el pase de renderizado.

Los comandos de la lista se ejecutan en el orden en que aparecen en ella.

Nota: Los comandos para RenderPass y Efectos son similares pero no iguales, solo aquellos marcados como compatibles pueden ser usados con este RenderPass.

Ver también renderTargetBlend, PipelineStateOverride, RenderablesFilter, RenderPassTexture, ColorAttachment, DepthTextureAttachment, DepthStencilAttachment, y AddDefine.

depthClearValue : real [default: 1.0]

Esta propiedad contiene el valor de limpieza de profundidad para el pase de renderizado.

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

Esta propiedad contiene el modo de material para el pase de render.

ConstanteDescripción
RenderPass.OriginalMaterialUtiliza el material original del objeto.
RenderPass.AugmentMaterialAumentar el material original con código shader personalizado.
RenderPass.OverrideMaterialSobreescribir el material original con un material especificado por el usuario material.

overrideMaterial : Material

Esta propiedad contiene el material de anulación para el pase de renderizado cuando materialMode se establece en OverrideMaterial.

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

Esta propiedad contiene el modo de pase para el pase de renderizado.

Además de los pases de render estándar de usuario, Qt Quick 3D permite a los usuarios activar manualmente pases de render internos para renderizar el skybox y los elementos 2D.

ConstanteDescripción
RenderPass.UserPassUn pase de render especificado por el usuario.
RenderPass.SkyboxPassQt Quick Pase de renderizado de la caja celeste incorporado en 3D.
RenderPass.Item2DPassQt Quick Pase de renderizado de elementos 2D incorporado en 3D.

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

Esta propiedad contiene las banderas del objetivo de renderizado para el pase de renderizado.

Los valores posibles son:

ConstanteDescripción
RenderPass.RenderTargetFlags.NoneNingún comportamiento especial.
RenderPass.RenderTargetFlags.PreserveColorContentsPreserva el contenido de color del objetivo de renderizado entre fotogramas.
RenderPass.RenderTargetFlags.PreserveDepthStencilContentsConserva los contenidos de profundidad y stencil del objetivo de renderizado entre fotogramas.
RenderPass.RenderTargetFlags.DoNotStoreDepthStencilContentsNo almacena los contenidos de profundidad y stencil del objetivo de renderizado después de renderizar.

Véase también QRhiTextureRenderTarget::Flags.

stencilClearValue : int [default: 0]

Esta propiedad contiene el valor del stencil clear para el pase de renderizado.

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