En esta página

AddDefine QML Type

Añade una definición de preprocesador a la compilación del shader para un « pass ». Más...

Import Statement: import QtQuick3D
Since: Qt 6.11
Inherits:

Command

Propiedades

Descripción detallada

El tipo AddDefine se utiliza para insertar una definición de preprocesador ( #define ) en la compilación del shader para un paso de renderizado ( RenderPass). Esto permite ramificar el comportamiento del shader en tiempo de compilación en función del paso que se esté ejecutando.

En el código del shader, la definición se puede utilizar con las directivas estándar del preprocesador #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 }
    ]
}

Documentación de propiedades

name : string

El nombre de la macro del preprocesador que se va a definir. Este se convierte en el identificador que se utiliza en las comprobaciones de tipo « #ifdef » o « #if » en el código del shader.

value : int

El valor entero asignado a la macro del preprocesador. El valor por defecto es « 1 ». Cuando es distinto de cero, « #if NAME » se evalúa como « true » en el shader.

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