このページでは、カスタムの Unity シェーダーに GPU インスタンシングのサポートを追加する方法について説明します。まず、カスタム Unity シェーダーが GPU インスタンシングをサポートするために必要とする、シェーダーキーワード、変数、および関数について説明します。その上で、サーフェスシェーダーと頂点/フラグメントシェーダーの両方にインスタンスごとのデータを追加する方法を示すサンプルを記載しています。
機能 | ビルトインレンダーパイプライン | ユニバーサルレンダーパイプライン (URP) | HD レンダーパイプライン (HDRP) | カスタムのスクリプタブルレンダーパイプライン (SRP) |
---|---|---|---|---|
カスタムの GPU インスタンシングシェーダー | 可 | なし | なし | なし |
このセクションには、GPU インスタンシングに関連する、シェーダーの追加についての情報が記載されています。
追加コード | 説明 |
---|---|
#pragma multi_compile_instancing |
インスタンシングバリアントを生成します。フラグメントシェーダーと頂点シェーダーには必要です。サーフェスシェーダーの場合は任意です。 |
#pragma instancing_options
|
Unity がインスタンスに使用するオプションを指定します。利用可能なオプションスイッチについては、#pragma instancing_options を参照してください。 |
UNITY_VERTEX_INPUT_INSTANCE_ID |
頂点シェーダーの出入力構造にインスタンス ID を定義します。このマクロを使用するには、INSTANCING_ON シェーダーキーワードを有効にします。これを行わないと Unity はインスタンス ID を設定しません。 インスタンス ID にアクセスするには、#ifdef INSTANCING_ON ブロック内で vertexInput.instanceID を使用します。このブロックを使用しないと、バリアントがコンパイルに失敗します。 |
UNITY_INSTANCING_BUFFER_START(bufferName) |
bufferName という名前のインスタンスごとの定数バッファの開始を宣言します。このマクロを UNITY_INSTANCING_BUFFER_END と共に使用して、インスタンスごとに固有にしたいプロパティの宣言をラップできます。UNITY_DEFINE_INSTANCED_PROP を使用して、バッファ内でプロパティを宣言します。 |
UNITY_INSTANCING_BUFFER_END(bufferName) |
bufferName という名前のインスタンスごとの定数バッファの終了を宣言します。このマクロを UNITY_INSTANCING_BUFFER_START と共に使用して、インスタンスごとに固有にしたいプロパティの宣言をラップできます。UNITY_DEFINE_INSTANCED_PROP を使用して、バッファ内でプロパティを宣言します。 |
UNITY_DEFINE_INSTANCED_PROP(type, propertyName) |
シェーダーごとのプロパティを型と名前を指定して定義します。下記の例では、_Color プロパティが固有です。 |
UNITY_SETUP_INSTANCE_ID(v); |
シェーダー関数のインスタンス ID へのアクセスを可能にします。頂点シェーダーでは、このマクロが最初に必要です。フラグメントシェーダーでは、この追加は任意です。サンプルについては 頂点シェーダーとフラグメントシェーダーの例 を参照してください。 |
UNITY_TRANSFER_INSTANCE_ID(v, o); |
頂点シェーダーで入力構造体から出力構造体へインスタンス ID をコピーします。フラグメントシェーダーでは、インスタンスごとのデータにアクセスする必要がある時に使用してください。 |
UNITY_ACCESS_INSTANCED_PROP(bufferName, propertyName) |
インスタンシング定数バッファ内のインスタンスごとのシェーダープロパティにアクセスします。Unity は、インスタンス ID を使用して、インスタンスデータ配列内にインデックスします。bufferName は、指定のプロパティを含む定数バッファの名前と一致する必要があります。このマクロのコンパイルは、INSTANCING_ON と非インスタンシングバリアントで異なります。 |
インスタンスごとのプロパティを複数使用する場合、MaterialPropertyBlock
オブジェクトにその全てを記入する必要はありません。また、プロパティが欠落したインスタンスがある場合、Unity は、参照されているマテリアルからデフォルト値を取得します。マテリアルにそのプロパティのデフォルト値がない場合、Unity は値を 0 に設定します。インスタンシングされていないプロパティを MaterialPropertyBlock
に入れるとインスタンシングが無効になるため、これは行わないでください。代わりに、それらのために別のマテリアルを作成してください。
[#pragma instancing_options](#pragma-instancing_options) ディレクティブは以下のスイッチを使用できます。
スイッチ | 説明 |
---|---|
forcemaxcount:batchSize と maxcount:batchSize
|
ほとんどのプラットフォームでは、Unity は自動的にインスタンシングデータ配列サイズを計算します (ターゲットデバイス上の最大定数バッファサイズを、全てのインスタンスごとのプロパティを含む構造体のサイズで割ります)。通常はバッチサイズに関して心配する必要はありません。ただし、一部のプラットフォームは固定の配列サイズを必要とします。それらのプラットフォームでバッチサイズを強制するには maxcount オプションを使用してください。他のプラットフォームはこのオプションを無視します。全てのプラットフォームで同じバッチサイズを強制するには forcemaxcount を使用してください。これは例えば、プロジェクトが RenderMeshInstanced を使用して 256 個のインスタンス化されたスプライトのドローコールを発行している場合などに役立ちます。この 2 つのオプションのデフォルト値は 500 です。 |
assumeuniformscaling |
Unity に、全てのインスタンスが統一されたスケールを持つ (X、Y、Z 全ての軸のスケールが同じ) ことを想定するように命令します。 |
nolodfade |
Unity が LOD フェード値に GPU インスタンシングを適用しないようにします。 |
nolightprobe |
Unity が ライトプローブ の値とそのオクルージョンデータに GPU インスタンシングを適用しないようにします。このオプションを ON に設定すると、プロジェクトに GPU インスタンシングとライトプローブの両方を使用するゲームオブジェクトが含まれていない場合に、パフォーマンスが向上する可能性があります。 |
nolightmap |
Unity がライトマップアトラス情報の値に GPU インスタンシングを適用しないようにしま す。このオプションを ON に設定すると、プロジェクトに GPU インスタンシングとライトマップの両方を使用するゲームオブジェクトが含まれていない場合に、パフォーマンスが向上する可能性があります。 |
procedural:FunctionName |
Graphics.RenderMeshIndirect で使用する追加のバリアントを生成します。 頂点シェーダーステージの最初に、Unity は、コロンの後に指定された関数を呼び出します。インスタンスデータを手動で設定するには、シェーダーにインスタンスごとのデータを追加する通常の方法で、この関数にインスタンスごとのデータを追加します。また Unity は、フェッチされたインスタンスプロパティのいずれかがフラグメントシェーダーに含まれている場合は、フラグメントシェーダーの最初にもこの関数を呼び出します。 |
#pragma
ディレクティブに noinstancing
を指定しない限り、Unity はデフォルトで、インスタンシング バリアント を使用してサーフェスシェーダーを生成します。Unity はサーフェスシェーダーでは #pragma multi_compile_instancing の使用を無視します。
Unity のスタンダードシェーダーと StandardSpecular シェーダーは、デフォルトでインスタンシングをサポートしていますが、Transform 以外のインスタンスごとのプロパティを持っていません。
GPU インスタンシングが有効にされたゲームオブジェクトがシーンにない場合、Unity はインスタンシングシェーダーバリアントをストリッピングします。ストリッピングの挙動をオーバーライドするには以下を行ってください。
デフォルトでは、Unity は、インスタンス化されたドローコールごとに異なる Transform でゲームオブジェクトを GPU インスタンシングします。インスタンスにバリエーションを加えるには、シェーダーに変更を加えてインスタンスごとのプロパティ (色など) を追加します。これはサーフェスシェーダーと頂点/フラグメントシェーダーの両方で行うことができます。
カスタムシェーダーは、インスタンス単位のデータを必要としませんが、インスタンス ID は必要です (ワールドマトリックスが正しく機能するために必要なため)。サーフェスシェーダーは自動的にインスタンス ID を設定しますが、カスタムの頂点シェーダーとフラグメントシェーダーはそうではありません。カスタムの頂点シェーダーとフラグメントシェーダーで ID を設定するには、シェーダーの最初で UNITY_SETUP_INSTANCE_ID を使用します。この方法を示す例については、頂点シェーダーとフラグメントシェーダーの例 を参照してください。
インスタンス化されたプロパティを宣言すると、Unity は、ゲームオブジェクトに設定された MaterialPropertyBlock オブジェクトから全てのプロパティ値を 1 回のドローコールに集めます。MaterialPropertyBlock オブジェクトを使用してランタイムにインスタンスごとのデータを設定する方法の例については、ランタイムにインスタンスごとのデータを変更する例 を参照してください。
マルチパスシェーダーにインスタンス単位のデータを追加する場合は、以下の点に注意してください。
以下の例は、インスタンスごとにカラー値が異なる、インスタンス化されたサーフェスシェーダーを作成する方法を示しています。
Shader "Custom/InstancedColorSurfaceShader"
{
Properties
{
_Color ("Color", Color) = (1,1,1,1)
_MainTex ("Albedo (RGB)", 2D) = "white" {}
_Glossiness ("Smoothness", Range(0,1)) = 0.5
_Metallic ("Metallic", Range(0,1)) = 0.0
}
SubShader
{
Tags { "RenderType"="Opaque" }
LOD 200
CGPROGRAM
// Uses the physically based standard lighting model with shadows enabled for all light types.
#pragma surface surf Standard fullforwardshadows
// Use Shader model 3.0 target
#pragma target 3.0
sampler2D _MainTex;
struct Input
{
float2 uv_MainTex;
};
half _Glossiness;
half _Metallic;
UNITY_INSTANCING_BUFFER_START(Props)
UNITY_DEFINE_INSTANCED_PROP(fixed4, _Color)
UNITY_INSTANCING_BUFFER_END(Props)
void surf (Input IN, inout SurfaceOutputStandard o) {
fixed4 c = tex2D (_MainTex, IN.uv_MainTex) * UNITY_ACCESS_INSTANCED_PROP(Props, _Color);
o.Albedo = c.rgb;
o.Metallic = _Metallic;
o.Smoothness = _Glossiness;
o.Alpha = c.a;
}
ENDCG
}
FallBack "Diffuse"
}
以下の例は、インスタンスごとにカラー値が異なる、インスタンス化された頂点/フラグメントシェーダーを作成する方法を示しています。サーフェスシェーダーと異なり、頂点シェーダーやフラグメントシェーダーを作成する時は、UNITY_SETUP_INSTANCE_ID を使用して手動でインスタンス ID を設定する必要があります。
Shader "Custom/SimplestInstancedShader"
{
Properties
{
_Color ("Color", Color) = (1, 1, 1, 1)
}
SubShader
{
Tags { "RenderType"="Opaque" }
LOD 100
Pass
{
CGPROGRAM
#pragma vertex vert
#pragma fragment frag
#pragma multi_compile_instancing
#include "UnityCG.cginc"
struct appdata
{
float4 vertex : POSITION;
UNITY_VERTEX_INPUT_INSTANCE_ID
};
struct v2f
{
float4 vertex : SV_POSITION;
UNITY_VERTEX_INPUT_INSTANCE_ID // use this to access instanced properties in the fragment shader.
};
UNITY_INSTANCING_BUFFER_START(Props)
UNITY_DEFINE_INSTANCED_PROP(float4, _Color)
UNITY_INSTANCING_BUFFER_END(Props)
v2f vert(appdata v)
{
v2f o;
UNITY_SETUP_INSTANCE_ID(v);
UNITY_TRANSFER_INSTANCE_ID(v, o);
o.vertex = UnityObjectToClipPos(v.vertex);
return o;
}
fixed4 frag(v2f i) : SV_Target
{
UNITY_SETUP_INSTANCE_ID(i);
return UNITY_ACCESS_INSTANCED_PROP(Props, _Color);
}
ENDCG
}
}
}
以下の例は、MaterialPropertyBlock オブジェクトを使用してランタイムにゲームオブジェクトのグループにインスタンスごとのデータを設定する方法を示しています。これは、上記のシェーダーサンプルの _Color
プロパティをランダムな色に設定します。
重要: MaterialPropertyBlock は SRP バッチャーの互換性を破ります。詳しくは GPU インスタンシング: 要件と互換性 を参照してください。
using UnityEngine;
public class MaterialPropertyBlockExample : MonoBehaviour
{
public GameObject[] objects;
void Start()
{
MaterialPropertyBlock props = new MaterialPropertyBlock();
MeshRenderer renderer;
foreach (GameObject obj in objects)
{
float r = Random.Range(0.0f, 1.0f);
float g = Random.Range(0.0f, 1.0f);
float b = Random.Range(0.0f, 1.0f);
props.SetColor("_Color", new Color(r, g, b));
renderer = obj.GetComponent<MeshRenderer>();
renderer.SetPropertyBlock(props);
}
}
}
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.