シェーダーバリアントはシェーダー順列とも呼ばれ、シェーダーコードに条件付き動作を導入する方法の 1 つです。
Unity は、シェーダーのソースファイルをシェーダープログラムにコンパイルします。コンパイルされた各シェーダープログラムは、1 つまたは複数の バリアント を持っています。これにより、さまざまな条件に応じて、さまざまなバージョンのシェーダープログラムを使用できます。ランタイム に、Unity は現在の要件に一致するバリアントを使用します。シェーダーキーワード を使用してバリアントを設定します。
シェーダーコードにおける条件に関する概要と、どちらの手法をどのような場合に使用するかについては、シェーダーコードにおける条件分岐 を参照してください。Unity がシェーダーバリアントをロードする方法の詳細は、シェーダーのロード を参照してください。
多くのバリアントを持つシェーダーは、“メガシェーダー” または “ウーバーシェーダー” と呼ばれます。Unity のスタンダードシェーダーは、その一例です。
シェーダーバリアントの主な利点は、動的分岐 の GPU パフォーマンスへの影響なしに、シェーダープログラムでランタイム条件を使用できることです。シェーダーバリアントの主な欠点は、バリアントの数が多いと、ビルド時 とランタイムの両方のパフォーマンスの問題の原因になる可能性があることです。
Unity がシェーダーバリアントを作成するとき。静的分岐 を使って、小さな特化型シェーダープログラムを複数作成します。ランタイムに、Unity は条件に一致するシェーダープログラムを使用します。つまり、GPU パフォーマンスのペナルティを受けることなく、動的ブランチで GPU パフォーマンスの低下を引き起こす可能性のあるコードにシェーダーバリアントを使用できます。
ただし、多数のバリアントがあると、ビルド時間、ファイルサイズ、ランタイムメモリ使用量、ロード時間が増加します。また、手動でシェーダーをプリロード (事前準備) する場合の複雑さが増すことにもつながります。プロジェクトに非常に多くのシェーダーバリアントが含まれる場合、これらの問題はパフォーマンスとワークフローに重大な問題をもたらす可能性があります。
注意: 不注意に過剰な数のシェーダーバリアントを作成することは簡単で、これは重大なパ フォーマンス問題につながる可能性があります。したがって、Unity がシェーダーバリアントの数を決定する方法、コンパイルから不要なバリアントを除外 (ストリップ) する方法、シェーダーでいつ他のタイプの条件を使用するか を理解することが非常に重要です。
ビルド時に、Unity は現在のビルドターゲットの各グラフィックス API に対して 1 セットのシェーダーバリアントをコンパイルします。各グラフィックス API とビルドターゲットの組み合わせに対するバリアントの数は、シェーダーのソースファイルとシェーダーキーワードの使用に依存します。
シェーダーバリアントの数を確認 できます。
Unity は現在のビルドターゲットの各グラフィックス API に対して 1 セットのシェーダーバリアントをコンパイルします。シェーダーは、各ビルドターゲットとグラフィックス API の組み合わせごとに異なります。例えば、Unity は iOS の Metal と macOS の Metal に対して、異なるシェーダーをコンパイルします。
シェーダープログラムやキーワードによっては、指定のグラフィックス API やビルドターゲットのみを対象とするものもあります。そのため、グラフィックス API とビルドターゲットの組み合わせごとのバリアントの数は異なります。ただし、これらのバリアントをコンパイルする手順は同じです。
現在のビルドターゲットのグラフィックス API のリストを表示および編集するには、Player 設定 ウィンドウ、または PlayerSettings API を使用します。
Unity は、現在のビルドターゲットとグラフィックス API の組み合わせに対して、コンパイルするシェーダープログラム数を決定する必要があります。
ビルドに含まれるシェーダーのソースファイルごとに、固有のシェーダープログラムをいくつ定義するかが決定されます。
ノート: シェーダーのソースファイルは、ビルドのシーンで参照されている場合、Resources フォルダーの何かによって参照されている場合、Graphics Settings ウィンドウの Always-included Shaders セクションに含まれている場合に、そのビルドに含まれます。
Unity は、現在のビルドターゲットとグラフィックス API に対して、コンパイルするシェーダープログラム数を決定し、次に、各シェーダープログラムに対してコンパイルしなければならないシェーダーバリアントの数を決定します。
各シェーダープログラムに対して、Unity はそのプログラムに影響を与えるシェーダーキーワードの組み合わせを決定します。これは以下によって構成されています。
Unity が 1 つのシェーダープログラムに対してコンパイルするシェーダーバリアントの数は、キーワードの積です。つまり、Unity は各セットから 1 つの要素を含むすべてのセットに対して 1 つのバリアントをコンパイルします。
例えば、このセットには 3 つのシェーダーバリアントキーワードが含まれています。
このセットには 4 つのシェーダーバリアントキーワードが含まれています。
これらのシェーダーバリアントキーワードの影響を受けるシェーダープログラムは、以下の 12 バリアントになります。
シェーダーバリアントキーワードのセットを追加すると、Unity がコンパイルするバリアントの数は非常に急速に増加する可能性があります。この非常に急速な増加を表す用語は “組合せ爆発” (combinatorial explosion) です。
例えば、かなり典型的なユースケースを考えてみましょう。シェーダーが、それぞれ 2 つのキーワード (<feature name>_ON
と <feature name>_ OFF
) を持つ多くのキーワードセットを持っている場合です 。シェーダーがそのキーワードセットを 2 個持っている場合、これは 4 つのバリアントになります。シェーダーがそのキーワードセットを 10 個持っている場合は、1024 つのバリアントになります。
コンパイル後、Unity は同一パス内の同一バリアントを自動的に識別し、これらの同一バリアントが同じバイトコードを指すようにします。これを 重複排除 と呼びます。
重複排除は、同一パス内の同一バリアントによるファイルサイズの増加を防ぎますが、同一バリアントがあると、コンパイル時に無駄な作業が発生したり、実行時にメモリ使用量やシェーダーのロード時間が増加したりします。この点を考慮して、常に、必要のないバリアントのストリッピング を行うことが大切です。
Did you find this page useful? Please give it a rating:
Thanks for rating this page!
What kind of problem would you like to report?
Thanks for letting us know! This page has been marked for review based on your feedback.
If you have time, you can provide more information to help us fix the problem faster.
Provide more information
You've told us this page needs code samples. If you'd like to help us further, you could provide a code sample, or tell us about what kind of code sample you'd like to see:
You've told us there are code samples on this page which don't work. If you know how to fix it, or have something better we could use instead, please let us know:
You've told us there is information missing from this page. Please tell us more about what's missing:
You've told us there is incorrect information on this page. If you know what we should change to make it correct, please tell us:
You've told us this page has unclear or confusing information. Please tell us more about what you found unclear or confusing, or let us know how we could make it clearer:
You've told us there is a spelling or grammar error on this page. Please tell us what's wrong:
You've told us this page has a problem. Please tell us more about what's wrong:
Thank you for helping to make the Unity documentation better!
Your feedback has been submitted as a ticket for our documentation team to review.
We are not able to reply to every ticket submitted.