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: |
Propiedades
- augmentShader : url
- clearColor : color
- commands : list<RenderCommand>
- depthClearValue : real
- materialMode : RenderPass::MaterialModes
- overrideMaterial : Material
- passMode : RenderPass::PassMode
- renderTargetFlags : RenderPass::RenderTargetFlags
- stencilClearValue : int
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.
| Constante | Descripción |
|---|---|
RenderPass.OriginalMaterial | Utiliza el material original del objeto. |
RenderPass.AugmentMaterial | Aumentar el material original con código shader personalizado. |
RenderPass.OverrideMaterial | Sobreescribir 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.
| Constante | Descripción |
|---|---|
RenderPass.UserPass | Un pase de render especificado por el usuario. |
RenderPass.SkyboxPass | Qt Quick Pase de renderizado de la caja celeste incorporado en 3D. |
RenderPass.Item2DPass | Qt 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:
| Constante | Descripción |
|---|---|
RenderPass.RenderTargetFlags.None | Ningún comportamiento especial. |
RenderPass.RenderTargetFlags.PreserveColorContents | Preserva el contenido de color del objetivo de renderizado entre fotogramas. |
RenderPass.RenderTargetFlags.PreserveDepthStencilContents | Conserva los contenidos de profundidad y stencil del objetivo de renderizado entre fotogramas. |
RenderPass.RenderTargetFlags.DoNotStoreDepthStencilContents | No 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.