AddDefine QML Type

Fügt der Shader-Kompilierung eine Präprozessor-Definition für „ pass “ hinzu. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• name : string
• value : int

Ausführliche Beschreibung

Der Typ „AddDefine“ wird verwendet, um eine „ #define “ in die Shader-Kompilierung für einen „ RenderPass “ einzufügen. Dadurch können Sie das Shader-Verhalten zur Kompilierungszeit in Abhängigkeit davon verzweigen, welcher Durchlauf gerade ausgeführt wird.

Im Shader-Code kann die Definition mit den Standard-Präprozessor-Direktiven „ #ifdef “ und „ #if “ verwendet werden:

#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 }
    ]
}

Dokumentation zu den Eigenschaften

name : string

Der Name des zu definierenden Präprozessor-Makros. Dieser wird als Bezeichner für die Prüfungen „ #ifdef “ oder „ #if “ im Shader-Code verwendet.

value : int

Der ganzzahlige Wert, der dem Präprozessor-Makro zugewiesen wird. Der Standardwert ist „ 1 “. Ist der Wert ungleich Null, wird „ #if NAME “ im Shader zu „ true “ ausgewertet.