Version: 2022.2
言語: 日本語
シェーダーにおける分岐
シェーダーバリアントの数の確認

シェーダーバリアント

Shader variants, also sometimes called shader permutations, are one way of introducing conditional behavior into shader code.

Unity compiles shader source files into shader programs. Each compiled shader program has one or more variants: different versions of the shader program for different conditions. At runtime, Unity uses the variant that matches the current requirements. You configure variants using shader keywords.

For a general overview of conditionals in shader code and when to use which technique, see Conditionals in shader code. For more information on how Unity loads shader variants, see Shader loading.

Shaders with a large number of variants are called “mega shaders” or “uber shaders”. Unity’s Standard Shader is an example of such a shader.

Advantages and disadvantages of shader variants

The main advantage of shader variants is that they allow you to use runtime conditionals in your shader programs, without the GPU performance impact of dynamic branching. The main disadvantage of shader variants is that a large number of them can lead to both build time and runtime performance issues.

When Unity creates shader variants, it uses static branching to create multiple small, specialized shader programs. At runtime, Unity uses the shader program that matches the conditions. This means that you can use shader variants for code that would likely result in reduced GPU performance in a dynamic branch, without suffering a GPU performance penalty.

However, a large number of variants can result in increased build times, file sizes, runtime memory usage, and loading times. It also leads to greater complexity when manually preloading (“prewarming”) shaders. When a project contains a very large number of shader variants, these issues can lead to significant problems with performance and workflow.

Warning: It is easy to inadvertently create an excessively large number of shader variants, which can lead to significant performance problems. It is therefore very important to understand how Unity determines the number of shader variants, how to exclude (“strip”) unneeded variants from compilation, and when to use other types of conditionals in shaders.

シェーダーバリアントの数

ビルド時に、Unity は現在のビルドターゲットの各グラフィックス API に対して 1 セットのシェーダーバリアントをコンパイルします。各グラフィックス API とビルドターゲットの組み合わせに対するバリアントの数は、シェーダーのソースファイルとシェーダーキーワードの使用に依存します。

You can check how many shader variants you have.

グラフィックス API

Unity は現在のビルドターゲットの各グラフィックス API に対して 1 セットのシェーダーバリアントをコンパイルします。シェーダーは、各ビルドターゲットとグラフィックス API の組み合わせごとに異なります。例えば、Unity は iOS の Metal と macOS の Metal に対して、異なるシェーダーをコンパイルします。

シェーダープログラムやキーワードによっては、指定のグラフィックス API やビルドターゲットのみを対象とするものもあります。そのため、グラフィックス API とビルドターゲットの組み合わせごとのバリアントの数は異なります。ただし、これらのバリアントをコンパイルする手順は同じです。

現在のビルドターゲットのグラフィックス API のリストを表示および編集するには、Player 設定 ウィンドウ、または PlayerSettings API を使用します。

シェーダープログラムの数

Unity は、現在のビルドターゲットとグラフィックス API の組み合わせに対して、コンパイルするシェーダープログラム数を決定する必要があります。

ビルドに含まれるシェーダーのソースファイルごとに、固有のシェーダープログラムをいくつ定義するかが決定されます。

  • コンピュートシェーダーアセットは、1 つのシェーダープログラムを定義します。
  • ハンドコードされたシェーダーでは、シェーダープログラムの数はコードに依存します。総数は以下から構成されます。
    • ソースファイルのすべてのパスのすべてのシェーダーステージ。例えば、各頂点ステージで 1 つのシェーダープログラムを定義し、各フラグメントステージで 1 つのシェーダープログラムを定義する、というように。
    • ソースファイルの依存関係にあるすべてのパスのすべてのシェーダーステージ。これには、すべての フォールバックシェーダーUsePass コマンド を使用するすべてのパスが含まれます。
  • Shader Graph シェーダーでは、シェーダープログラムの数は、Unity がグラフから生成するコードに依存します。Unity が生成するシェーダーコードを見るには、Shader Graph アセットを右クリックし、 See generated code を選択します。その後、ハンドコードされたシェーダーの場合と同じ方法で、シェーダープログラムの総数が決まります。

ノート: シェーダーのソースファイルは、ビルドのシーンで参照されている場合、Resources フォルダーの何かによって参照されている場合、Graphics Settings ウィンドウの Always-included Shaders セクションに含まれている場合に、そのビルドに含まれます。

シェーダープログラムに影響を与えるキーワード

Unity は、現在のビルドターゲットとグラフィックス API に対して、コンパイルするシェーダープログラム数を決定し、次に、各シェーダープログラムに対してコンパイルしなければならないシェーダーバリアントの数を決定します。

For each shader program, Unity determines the combination of shader keywords that result in different variants. This comprises:

Unity が 1 つのシェーダープログラムに対してコンパイルするシェーダーバリアントの数は、キーワードの積です。つまり、Unity は各セットから 1 つの要素を含むすべての組み合わせに対して 1 つのバリアントをコンパイルします。

For example, this set contains three shader variant keywords:

  • COLOR_RED
  • COLOR_GREEN
  • COLOR_BLUE

This set contains four shader variant keywords:

  • QUALITY_LOW
  • QUALITY_MEDIUM
  • QUALITY_HIGH
  • QUALITY_ULTRA

A shader program affected by those shader variant keywords will result in the following twelve variants:

  • COLOR_RED、QUALITY_LOW
  • COLOR_RED、QUALITY_MEDIUM
  • COLOR_RED、QUALITY_HIGH
  • COLOR_RED、QUALITY_ULTRA
  • COLOR_GREEN、QUALITY_LOW
  • COLOR_GREEN、QUALITY_MEDIUM
  • COLOR_GREEN、QUALITY_HIGH
  • COLOR_GREEN、QUALITY_ULTRA
  • COLOR_BLUE and QUALITY_LOW
  • COLOR_BLUE and QUALITY_MEDIUM
  • COLOR_BLUE and QUALITY_HIGH
  • COLOR_BLUE and QUALITY_ULTRA

The number of variants that Unity compiles can grow very rapidly as you add more sets of shader variant keywords. The term for this very rapid growth is combinatorial explosion.

For example, consider a fairly typical use case, where a shader has a number of sets of shader variant keywords that contain two keywords each (<feature name>_ON and <feature name>_OFF). If the shader has two such sets of keywords, this results in four variants. If the shader has ten such sets of keywords, this results in 1024 variants.

シェーダーバリアントの重複排除

コンパイル後、Unity は同一パス内の同一バリアントを自動的に識別し、これらの同一バリアントが同じバイトコードを指すようにします。これを 重複排除 と呼びます。

Deduplication prevents identical variants in the same Pass from increasing file size; however, identical variants still result in wasted work during compilation, and increased memory usage and shader loading times at runtime. With this in mind, it is always best to strip unneeded variants.

シェーダーにおける分岐
シェーダーバリアントの数の確認