if (Instrucción)

Ejecute condicionalmente una serie de instrucciones, en función de la evaluación de la expresión condicional.

[Attribute] if ( Conditional ) { Statement Block; }

Parámetros

Atributo

Parámetro opcional que controla cómo se compila la instrucción.

Atributo	Descripción
branch	Evalúe solo un lado de la instrucción if en función de la condición especificada. Nota: Cuando se usa shader Model 2.x o Shader Model 3.0, cada vez que se usa la bifurcación dinámica se consumen recursos. Por lo tanto, si usa la bifurcación dinámica excesivamente al dirigirse a estos perfiles, puede recibir errores de compilación.
quitar información de estructura jerárquica	Evalúe ambos lados de la instrucción if y elija entre los dos valores resultantes.

Condicional

Expresión condicional. La expresión se evalúa y, si es true, se ejecuta el bloque de instrucciones.

Bloque de instrucciones

Una o varias instrucciones HLSL.

Comentarios

Cuando el compilador usa el método de rama para compilar una instrucción if, generará código que solo evaluará un lado de la instrucción if en función de la condición especificada. Por ejemplo, en la instrucción if:

[branch] if(x)
{
    x = sqrt(x);
}

La instrucción if tiene un bloque else implícito, que equivale a x = x. Dado que hemos dicho al compilador que use el método de rama con el atributo de rama anterior, el código compilado evaluará x y ejecutará solo el lado que se debe ejecutar; si x es cero, ejecutará el otro lado y, si es distinto de cero, ejecutará el lado después .

Por el contrario, si se usa el atributo flatten , el código compilado evaluará ambos lados de la instrucción if y elegirá entre los dos valores resultantes mediante el valor original de x. Este es un ejemplo de uso del atributo flatten:

[flatten] if(x)
{
    x = sqrt(x);
}

Hay determinados casos en los que el uso de los atributos de rama o acoplado puede generar un error de compilación. El atributo de rama puede producir un error si cualquiera de los lados de la instrucción if contiene una función de degradado, como tex2D. El atributo flatten puede producir un error si el lado de la instrucción if contiene una instrucción append de secuencia o cualquier otra instrucción que tenga efectos secundarios.

Una instrucción if también puede usar un bloque else opcional. Si la expresión if es true, se procesa el código del bloque de instrucciones asociado a la instrucción if. De lo contrario, se procesa el bloque de instrucciones asociado al bloque opcional else.

Consulte también

Control de flujo