HLSL でシェーダーモデルと GPU 機能を特定する

#pragma ディレクティブ を使うと、シェーダーが特定の GPU 機能を必要とすることを示すことができます。ランタイムに、Unity はこの情報を使ってシェーダープログラムが使用中のハードウェアと互換性があるかどうかを判断します。

#pragma require ディレクティブで個々の GPU 機能を指定したり、シェーダーモデル を指定したりすることができます。シェーダーモデルとは、一群の GPU 機能のことです。これは内部的には、同じ機能を持つ #pragma require ディレクティブのようなものです。

シェーダーが必要とする GPU 機能を正しく記述することが重要です。シェーダーが要件リストに含まれていない機能を使用すると、 コンパイル時にエラーが発生したり、デバイスが実行時にシェーダーをサポートできなくなる可能性があります。

デフォルトの動作

デフォルトでは、Unity はシェーダーを #pragma require derivatives でコンパイルします。これは #pragma target 2.5 に相当します。

シェーダーステージの特別な要件

シェーダーが特定のシェーダーステージを定義する場合、Unity は自動的に要件リストに項目を追加します。

• シェーダーが (#pragma geometryによって) ジオメトリステージを定義する場合、Unity は自動的に geometry を要件リストに追加します。
• シェーダーが (#pragma hull または #pragma domainによって) テッセレーションのステージを定義する場合、Unity は自動的に tessellation を要件リストに追加します。

要件のリスト (または同等のターゲット値) にこれらの値がまだ含まれていない場合、Unity はシェーダーのコンパイル時に、これらの要件を追加したことを示す警告メッセージを表示します。この警告メッセージが表示されないようにするには、明示的に要件を追加するか、コードで適切なターゲット値を使用してください。

GPU 機能かシェーダーモデルの指定

必須の機能を指定するには、#pragma require ディレクティブの後に、スペースで区切られた値のリストを使用します。例えば、以下のようになります。

# pragma require integers mrt8

#pragma require ディレクティブの後に、コロンとスペースで区切られた シェーダーキーワードのリスト を表記して使用することもできます。これは、指定されたキーワードのいずれかが有効になっているときに使用されるバリアントにのみ要件が適用されることを意味します。

例:

# pragma require integers mrt8 : EXAMPLE_KEYWORD OTHER_EXAMPLE_KEYWORD

複数の #pragma require 行を使用することができます。この例では、シェーダーはすべての場合に 整数 を要求し、EXAMPLE_KEYWORD が有効な場合には mrt8 を要求します。

# pragma require integers
# pragma require integers mrt8 : EXAMPLE_KEYWORD

シェーダーモデルを指定するには、#pragma target ディレクティブを使用します。例えば、以下のようになります。

# pragma target 4.0

#pragma target ディレクティブの後に、スペースで区切られた シェーダーキーワードのリスト を表記して使用することもできます。これは、指定されたキーワードのいずれかが有効になっているときに使用されるバリアントにのみ要件が適用されることを意味します。

例:

# pragma target 4.0 EXAMPLE_KEYWORD OTHER_EXAMPLE_KEYWORD

ノート： #pragma require と #pragma target のキーワードを指定する構文は若干異なります。#pragma require のキーワードを指定する場合は、コロンを使用します。#pragma target のキーワードを指定する場合は、コロンを使用しません。

‘#pragma target’ 値のリスト

以下は、Unity が使用するシェーダーモデルのリストと、それぞれが対応する #pragma require の値の組み合わせです。

ノート： Unity のシェーダーモデルは、DirectX のシェーダーモデルや OpenGL のバージョン要件と似ていますが、完全に対応しているわけではありません。説明をよく読んで、違いを確実に理解してください。

コンソールプラットフォームでのシェーダーモデルのサポートについては、プラットフォーム別のドキュメントを参照してください。

ノート:

• DirectX の定義では、シェーダーモデル 4.0 には mrt8 が、シェーダーモデル 5.0 には interpolators32 と cubearray が含まれています。Unity には、互換性を高めるために、これらの機能は含まれていません。これらの機能を必須にするには、明示的に #pragma require ディレクティブを使用してください。
• geometry を必要とするターゲットを使用しているが、シェーダーがジオメトリステージを定義していない場合、Unity はコンパイル時に geometry を要件リストから削除します。
• tessellation を必要とするターゲットを使用しているが、シェーダーがハルまたはドメインステージを定義していない場合、Unity はコンパイル時に tessellation を要件リストから削除します。

‘#pragma require’ 値のリスト

#pragma require ディレクティブに有効なすべての値配下の通りです。