RenderPass QML Type
Le type RenderPass définit une passe de rendu personnalisée pour le rendu de contenu 3D. Plus d'informations...
| Import Statement: | import QtQuick3D |
| Since: | Qt 6.11 |
| Inherits: |
Propriétés
- augmentShader : url
- clearColor : color
- commands : list<RenderCommand>
- depthClearValue : real
- materialMode : RenderPass::MaterialModes
- overrideMaterial : Material
- passMode : RenderPass::PassMode
- renderTargetFlags : RenderPass::RenderTargetFlags
- stencilClearValue : int
Description détaillée
Un RenderPass vous permet de définir une étape de rendu personnalisée dans le pipeline de rendu. Vous pouvez spécifier diverses propriétés telles que la couleur claire, le mode de matériau et les matériaux de remplacement. En outre, vous pouvez définir une liste de commandes de rendu qui dictent la manière dont le rendu doit être effectué.
Exposition des données aux nuanceurs
Comme pour les effets et les matériaux personnalisés, le RenderPass expose et met à jour automatiquement les propriétés définies par l'utilisateur au shader.
Documentation sur les propriétés
augmentShader : url
Cette propriété contient l'URL du shader d'augmentation pour la passe de rendu lorsque materialMode est défini sur AugmentMaterial.
Le fichier de shaders doit contenir une fonction avec la signature suivante : "Cette fonction sera combinée avec le shader de fragment existant du matériau utilisé par l'objet dans cette passe de rendu :
void MAIN_FRAGMENT_AUGMENT() {
// Custom shader code here
}Cette fonction sera combinée avec le fragment shader existant du matériau utilisé par l'objet rendu dans cette passe de rendu. Cette fonction sera combinée avec le shader de fragment existant du matériau utilisé par l'objet dont le rendu est effectué dans cette passe de rendu.
clearColor : color [default: Qt.black]
Cette propriété contient la couleur claire pour la passe de rendu.
commands : list<RenderCommand>
Cette propriété contient la liste des commandes de rendu pour la passe de rendu.
Les commandes de la liste sont exécutées dans l'ordre où elles apparaissent dans la liste.
Remarque : les commandes pour RenderPass et Effects sont similaires mais pas identiques, seules celles qui sont marquées comme compatibles peuvent être utilisées avec cette propriété RenderPass.
Voir aussi renderTargetBlend, PipelineStateOverride, RenderablesFilter, RenderPassTexture, ColorAttachment, DepthTextureAttachment, DepthStencilAttachment, et AddDefine.
depthClearValue : real [default: 1.0]
Cette propriété contient la valeur de transparence de la profondeur pour la passe de rendu.
materialMode : RenderPass::MaterialModes [default: RenderPass.OriginalMaterial]
Cette propriété contient le mode de matériau pour la passe de rendu.
| Constante | Description |
|---|---|
RenderPass.OriginalMaterial | Utilise le matériau d'origine de l'objet. |
RenderPass.AugmentMaterial | Augmenter le matériau d'origine à l'aide d'un code de nuanceur personnalisé. |
RenderPass.OverrideMaterial | Remplacer le matériau d'origine par un matériau spécifié par l'utilisateur material. |
overrideMaterial : Material
Cette propriété contient le matériau de remplacement pour la passe de rendu lorsque materialMode est défini sur OverrideMaterial.
passMode : RenderPass::PassMode [default: RenderPass.UserPass]
Cette propriété contient le mode de passage pour le passage de rendu.
En plus des passes de rendu utilisateur standard, Qt Quick 3D permet aux utilisateurs de déclencher manuellement des passes de rendu internes pour le rendu de la boîte à ciel et des éléments 2D.
| Constante | Description |
|---|---|
RenderPass.UserPass | Passe de rendu spécifiée par l'utilisateur. |
RenderPass.SkyboxPass | Qt Quick Passe de rendu de la boîte à ciel intégrée à 3D. |
RenderPass.Item2DPass | Qt Quick Passe de rendu des éléments 2D intégrée à 3D. |
renderTargetFlags : RenderPass::RenderTargetFlags [default: RenderPass.RenderTargetFlags.None]
Cette propriété contient les drapeaux de la cible de rendu pour la passe de rendu.
Les valeurs possibles sont
| Constante | Description |
|---|---|
RenderPass.RenderTargetFlags.None | Pas de comportement particulier. |
RenderPass.RenderTargetFlags.PreserveColorContents | Préserve le contenu des couleurs de la cible de rendu entre les images. |
RenderPass.RenderTargetFlags.PreserveDepthStencilContents | Préserve la profondeur et le contenu du pochoir de la cible de rendu entre les images. |
RenderPass.RenderTargetFlags.DoNotStoreDepthStencilContents | Ne pas stocker la profondeur et le contenu du pochoir de la cible de rendu après le rendu. |
Voir également QRhiTextureRenderTarget::Flags.
stencilClearValue : int [default: 0]
Cette propriété contient la valeur d'effacement du pochoir pour la passe de rendu.
© 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.