ShaderLab: マテリアルプロパティの定義

このページは、ShaderLab コードの Properties ブロックを使用して、Shader オブジェクトのマテリアルプロパティを定義するための情報を掲載しています。

概要

ShaderLab コードでは、マテリアルプロパティ を定義することができます。マテリアルプロパティとは、Unity がマテリアルアセットの一部として保存するプロパティのことです。 これにより、アーティストは様々な構成のマテリアルを作成、編集、共有することができます。

マテリアルプロパティを使用する場合

• マテリアルの関数を呼び出すことで、Shader オブジェクトの変数の値を取得または設定することができます (Material.SetFloat など)。
• マテリアルインスペクターを使って値を表示編集することができます。
• Unity は、行った変更をマテリアルアセットの一部として保存します。そのため、変更はセッション間で保持されます。

マテリアルプロパティを使用しない場合 * マテリアルの関数を呼び出しによっても、Shader オブジェクトの変数の値を取得したり設定したりすることができます。 * これらの値のビジュアルエディターはありません。 * 変更はセッション間で持続しません。

マテリアルプロパティを作成しないのは、通常、シェーダープロパティの値をスクリプトを使ってすべて設定したい場合 (プロシージャルコンテンツを作っている場合など) や、プロパティをマテリアルプロパティにできない場合、 Inspector で編集されたくない場合などです。

レンダーパイプラインの互換性

Properties ブロックの使用

ShaderLab の Shader オブジェクトにマテリアルプロパティを割り当てるには、Properties ブロックを Shader ブロックの中に配置します。

マテリアルのプロパティ宣言

すべてのマテリアルのプロパティ宣言は、この基本的な形式に沿っています。

[optional: attribute] name("display text in Inspector", type name) = default value

正確な構文は、型によって異なります。

このセクションには、以下の情報が含まれています。

• 型別のマテリアルプロパティ宣言構文
• マテリアルのプロパティ属性

型別のマテリアルプロパティ宣言構文

型名とデフォルト値の構文は、プロパティの型によって異なります。

シェーダーコードの場合。すべてのプロパティ名はアンダースコアで始まるのが一般的です。このページの例では、この規則に従っています。

マテリアルのプロパティ属性

マテリアルのプロパティ宣言には、どのように処理するかを Unity に指示するオプション属性を付けることができます。

ここに挙げた属性に加えて、同じ構文を使って、マテリアルプロパティにMaterialPropertyDrawer を追加することができます。これらによって、マテリアルプロパティが Inspector ウィンドウにどのように表示されるかを制御することができます。

C#コードによるマテリアルプロパティの使用

マテリアルプロパティは、C#コードでは MaterialProperty クラスで表されます。

HLSL コードで定義された変数にアクセスするには、Material.GetFloat、Material.SetFloat を呼び出します。他にも似たようなメソッドがあります。完全なリストは Material API ドキュメント を参照してください。これらの API を使用して HLSL 変数にアクセスする場合、その変数がマテリアルのプロパティであるかどうかは問題ではありません。

Unity エディターでは、Inspector ウィンドウに表示されるマテリアルのプロパティを制御することができます。最も簡単な方法は、MaterialPropertyDrawer を使うことです。より複雑なニーズがある場合は、MaterialEditor 、MaterialProperty 、ShaderGUI クラスを使用できます。シェーダ用のカスタム GUI の作成については、ShaderLab:assigning a custom editor を参照してください。

マテリアルプロパティを使って ShaderLab コードに変数を設定

マテリアルプロパティから ShaderLab コードの変数の値を設定するには、ShaderLab コードでマテリアルプロパティ名を角かっこ [] で囲みます。

このサンプルコードは、マテリアルプロパティを使用して、ShaderLab Offset コマンドの units 値を設定するための構文を示しています。

Shader "Examples/MaterialPropertyShaderLab"
{
    Properties
    {
        // マテリアルインスペクターでこの値を変更して、Offset コマンドの値に影響を与えます
        _OffsetUnitScale ("Offset unit scale", Integer) = 1
    }
    SubShader
    {
        // SubShader の残りの部分を定義するコードをここに記述

        Pass
        {
            Offset 0, [_OffsetUnitScale]

           // Pass の残りの部分を定義するコードをここに記述
        }
    }
}

マテリアルプロパティを使って HLSL コードの変数を設定

マテリアルプロパティを使って HLSL コードの変数の値を設定するには、マテリアルプロパティにシェーダープロパティと同じ名前を付けます。

このテクニックに関しては、以下のページも参照してください。実際のコード例も掲載されています。

• ビルトインレンダーパイプライン用の頂点シェーダーとフラグメントシェーダーの書き方
• ユニバーサルレンダーパイプライン用のカスタムシェーダーの作成