Стандартные шейдерные предпроцессорные макросы

Unity defines several preprocessor macros when compiling Shader programs.

Целевая платформа

SHADER_API_MOBILE is defined for all general mobile platforms (GLES, GLES3, METAL).

В случае, если GLSL выбран как целевой язык программирования шейдеров, дополнительно определяется SHADER_TARGET_GLSL (всегда true, если определен SHADER_API_GLES; и может быть true для SHADER_API_OPENGL при использовании #pragma glsl).

Shader target model

SHADER_TARGET is defined to a numeric value that matches the Shader target compilation model (that is, matching #pragma target directive). For example, SHADER_TARGET is 30 when compiling into Shader model 3.0. You can use it in Shader code to do conditional checks. For example:

#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

Unity version

UNITY_VERSION contains the numeric value of the Unity version. For example, UNITY_VERSION is 501 for Unity 5.0.1. This can be used for version comparisons if you need to write Shaders that use different built-in Shader functionality. For example, a #if UNITY_VERSION >= 500 preprocessor check only passes on versions 5.0.0 or later.

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.

Вспомогательные макросы для определения различий в платформах

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.

Макросы для работы с картами теней

Объявление и использование карт теней может существенно отличаться в зависимости от выбранной платформы, поэтому Unity предлагает набор вспомогательных макросов:

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

Макросы буферов констант

Direc3D 11 группирует все переменные шейдеров в “буфер констант”. Большинство встроенных в Unity переменных сгруппированы по умолчанию, но для собственных шейдеров более оптимальным подходом является распределение переменных по отдельным буферам констант в зависимости от предполагаемой частоты обновлений.

Для этого можно использовать макрос CBUFFER_START(name) и CBUFFER_END:

CBUFFER_START(MyRarelyUpdatedVariables)
    float4 _SomeGlobalValue;
CBUFFER_END

Texture/Sampler declaration macros

Usually you would use texture2D in Shader code to declare a Texture and Sampler pair. However on some platforms (such as DX11), Textures and Samplers are separate GameObjects, and maximum possible Sampler count is quite limited. Unity has some macros to declare Textures without Samplers, and to sample a Texture using a Sampler from another Texture. Use this if you end up running into Sampler limits, and you know that several of your Textures can in fact share a Sampler (Samplers define Texture filtering and wrapping modes).

For more information, see documentation on Sampler States.

Индикаторы проходов (pass) для поверхностных шейдеров

Компиляция поверхностных шейдеров (Surface Shader), генерирует большое количество кода различных проходов для вычисления освещения. При компиляции каждого прохода определяется один из следующих макросов:

Disable Auto-Upgrade

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

Смотрите так же

• Built-in Shader include files
• Built-in Shader variables
• Vertex and Fragment program examples

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