AddDefine QML Type

Ajoute une définition de préprocesseur à la compilation du shader pour un « pass ». En savoir plus…

• Liste de tous les membres, y compris les membres hérités

Propriétés

• name : string
• value : int

Description détaillée

Le type AddDefine sert à injecter une #define dans la compilation du shader pour une RenderPass. Cela permet de moduler le comportement du shader lors de la compilation en fonction du pass en cours d'exécution.

Dans le code du shader, la directive define peut être utilisée avec les directives standard de préprocesseur #ifdef / #if:

#ifdef CUSTOM_PASS_MODE
// code compiled only when this define is present
#endif

RenderPass {
    commands: [
        ColorAttachment { name: "color0"; target: colorTexture },
        AddDefine { name: "CUSTOM_PASS_MODE" },
        AddDefine { name: "OUTPUT_VERSION"; value: 2 }
    ]
}

Documentation sur les propriétés

name : string

Nom de la macro de préprocesseur à définir. Il s'agit de l'identifiant utilisé dans les vérifications de type « #ifdef » ou « #if » dans le code du shader.

value : int

Valeur entière attribuée à la macro du préprocesseur. La valeur par défaut est « 1 ». Lorsqu’elle est différente de zéro, l’expression « #if NAME » est évaluée comme « true » dans le shader.