Macros del preprocesador Shader predefinidas

Unity define varias macros preprocessor cuando se compile programas Shader.

Plataforma destino

SHADER_API_MOBILE se define en todas las plataformas móviles (GLES, GLES3, METAL, PSP2).

Adicionalmente, SHADER_TARGET_GLSL se define cuando el lenguaje de shading destino es GLSL (siempre true para plataformas OpenGL/GLES).

Modelo destino shader

SHADER_TARGET se define con un valor numérico que coincida con el modelo de compilación de destino Shader (es decir, que coincida con la directiva #pragma target). Por ejemplo, SHADER_TARGET es30 al compilar en Shader modelo 3.0. Puede usarlo en el código Shader para realizar comprobaciones condicionales. Por ejemplo:

#if SHADER_TARGET < 30
    // less than Shader model 3.0:
    // very limited Shader capabilities, do some approximation
#else
    // decent capabilities, do a better thing
#endif

Versión de Unity

UNITY_VERSION contiene el valor numérico de la versión de Unity. Por ejemplo, UNITY_VERSION es 501 para Unity 5.0.1. Esto se puede utilizar para comparaciones de versiones si necesita escribir Shaders que utilicen la funcionalidad integrada de Shader. Por ejemplo, una comprobación #if UNITY_VERSION >= 500 preprocessor sólo pasa en versiones 5.0.0 o posterior.

Shader stage being compiled

Preprocessor macros SHADER_STAGE_VERTEX, SHADER_STAGE_FRAGMENT, SHADER_STAGE_DOMAIN, SHADER_STAGE_HULL, SHADER_STAGE_GEOMETRY, SHADER_STAGE_COMPUTE are defined when compiling each Shader stage. Typically they are useful when sharing Shader code between pixel Shaders and compute Shaders, to handle cases where some things have to be done slightly differently.

Ayudas de diferencia de plataforma

Direct use of these platform macros is discouraged, as they don’t always contribute to the future-proofing of your code. For example, if you’re writing a Shader that checks for D3D11, you may want to ensure that, in the future, the check is extended to include Vulkan. Instead, Unity defines several helper macros (in HLSLSupport.cginc):

• UNITY_REVERSED_Z - defined on plaftorms using reverse Z buffer. Stored Z values are in the range 1..0 instead of 0..1.

Macros de shadow mapping

La declaración y el muestreo de mapas de sombra pueden ser muy diferentes dependiendo de la plataforma. Unity tiene varios macros para ayudar con esto:

NOTE: Not all graphics cards support shadowmaps. Use SystemInfo.SupportsRenderTextureFormat to check for support.

Macros buffer constantes

Direct3D 11 agrupa todas las variables Shader en “buffers constantes”. La mayoría de las variables incorporadas de Unity ya están agrupadas, pero para las variables en sus propios Shaders podría ser más óptimo ponerlas en buffers constantes independientes dependiendo de la frecuencia esperada de actualizaciones.

Utilice las macros CBUFFER_START(name) y CBUFFER_END para esto:

CBUFFER_START(MyRarelyUpdatedVariables)
    float4 _SomeGlobalValue;
CBUFFER_END

Declaración de macros Texture/Sampler

Por lo general, se utiliza texture2D en código Shader para declarar un par de texturas y muestras. Sin embargo, en algunas plataformas (como DX11), Textures y Samplers son GameObjects separados, y el número máximo posible de muestreadores es bastante limitado. Unity tiene algunas macros para declarar Textures sin Samplers, y para muestrear una Texture utilizando un Sampler de otra Texture. Utilice esto si termina terminando en los límites de Sampler, y usted sabe que varias de sus Texturas pueden de hecho compartir un Sampler (Los Samplers definen el filtro de Texturas y modo de wrapping (envoltura)).

For more information, see documentation on Sampler States.

Indicadores Surface Shader pass

Cuando se compilan Surface Shaders,se generan una gran cantidad de código para varios pases para hacer la iluminación. Al compilar cada pase, se define una de las macros siguientes:

Disable Auto-Upgrade

UNITY_SHADER_NO_UPGRADE allows you to disable Unity from automatically upgrading or modifying your shader file.

Mirar también

• Archivos include Shader integrados
• Built-in Shader variables
• Ejemplos de Programas Vertex y Fragment

• 2017–05–16 Page amended with no editorial review