Version: Unity 6.2 Alpha (6000.2)
Language : English
Introduction to static and dynamic branching
Branch in a shader via built-in macros

Static and dynamic branching in a shader

For more information, refer to Introduction to static and dynamic branching in shaders.

Static branching

You can use static branching in your shadersA program that runs on the GPU. More info
See in Glossary in the following ways:

  • In hand-coded shaders:
    • Use #if, #elif, #else, and #endif preprocessor directives, or #ifdef and #ifndef preprocessor directives to create static branches.
    • Use an if statement that evaluates a compile-time constant value. Although if statements can also be used for dynamic branches, the compiler detects the compile-time constant value and creates a static branch instead.
    • Unity provides built-in macros for some compile-time constants that you can use with static branches.

Note: Static branching is available only in hand-coded shaders. You cannot create static branches in Shader Graph.

Dynamic branching

You can use dynamic branching in your shaders in the following ways:

  • In hand-coded shaders:
    • Optional: Set up shader keywords for use with with dynamic branching. You can use dynamic branching without shader keywords, but this provides simple set up and per-material configuration.
    • Use an if statement that evaluates the shader keywords (if used) or any other runtime state. You can use attributes to force the GPU to execute both branches, or to execute only one branch.
  • In Shader Graph, use a Branch Node. This always executes both branches.
对文档有任何疑问，请移步至开发者社区提问，我们将尽快为您解答
Introduction to static and dynamic branching
Branch in a shader via built-in macros
Copyright © 2023 Unity Technologies
优美缔软件（上海）有限公司 版权所有
"Unity"、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属机构在美国及其他地区的商标或注册商标。其他名称或品牌是其各自所有者的商标。
公安部备案号:
31010902002961