Unreal Engine のマテリアル Parameter 表現式 | Unreal Engine 5.4 ドキュメンテーション

コレクションパラメータ

コレクションパラメータ表現式 は、パラメータコレクションアセットの参照に使用します。マテリアル、ブループリントなどの様々なアセットで簡単に再利用できるパラメータグループです。

パラメータコレクションで一度グローバル値を変更すると、そのコレクションを参照する複数のマテリアルに伝搬させることができます。詳細については、「マテリアルパラメータコレクション」ドキュメントを参照してください。

クリックして画像を拡大

1 つのマテリアルは、最大 2 つの異なる MaterialParameterCollections を参照することができます。1 つは通常、ゲーム全体の値として使用され、もう 1 つは、レベル固有のパラメータとして使用できます。1 つのコレクションは、最大で 1024 個のスカラーパラメータと 1024 個のベクターパラメータを保持できます。

DynamicParameter

DynamicParameter 表現式は、パーティクルエミッタが任意の方法で使用されるマテリアルに最大 4 つの値を渡すためのコンジットを提供します。これらの値は、エミッタに配置された ParameterDynamic モジュールを介して カスケード に設定されます。

プロパティ	説明
Param Names	パラメータ名の配列です。この値は、マテリアルエディタの表現式の出力に表示されるテキストを決定し、カスケードの ParameterDynamic モジュールのパラメータを参照するために使用される名前になります。
Default Value	パラメータが出力する初期値を指定します (Vector4)。
出力
Param1	Param Names プロパティの最初のパラメータの値を出力します。この出力の名前は Param Names プロパティに基づいて変更できます。
Param2	Param Names プロパティの 2 番目のパラメータの値を出力します。この出力の名前は Param Names プロパティに基づいて変更できます。
Param3	Param Namesプロパティの 3 番目のパラメータの値を出力します。この出力の名前は Param Names プロパティに基づいて変更できます。
Param4	Param Namesプロパティの 4 番目のパラメータの値を出力します。この出力の名前は Param Names プロパティに基づいて変更できます。

FontSampleParameter

FontSampleParameter 表現式は、マテリアルインスタンス定数でフォントベースのパラメータをエクスポーズする手段を提供することにより、様々なインスタンスで様々なフォントを簡単に使用できます。フォントのアルファチャンネルには、フォントアウトライン値が格納されます。有効なフォントページのみを指定できます。

アイテム	説明
プロパティ
Parameter Name	マテリアルのインスタンスおよびコードを通じてパラメータの識別に使用する名前を指定します。
Group	MaterialInstanceConstant 内でパラメータ名をグループまたはカテゴリに整理できます。同じグループプロパティ名を持つマテリアル内のすべてのパラメータは、インスタンスエディタのそのカテゴリの下にリストされます。
Font	表現式で使用するデフォルトのフォントアセット (コンテンツブラウザから) を保持します。
Font Texture Page	テクスチャの一部として使用する現在のフォントのテクスチャページです。

ScalarParameter

ScalarParameter 表現式は、マテリアルのインスタンス内かコードによってオンザフライでアクセスおよび変更できる、単一の浮動小数点値 (constant) を出力します。

プロパティ	説明
Parameter Name	マテリアルのインスタンスおよびコードを通じてパラメータの識別に使用する名前を指定します。
Group	MaterialInstanceConstant 内でパラメータ名をグループまたはカテゴリに整理できます。同じグループプロパティ名を持つマテリアル内のすべてのパラメータは、インスタンスエディタのそのカテゴリの下にリストされます。
Default Value	定数が受け取る初期値を指定します。

スカラーパラメータの値を更新すれば、マテリアルを再コンパイルすることなく、すぐに結果を確認することができます。

スカラーパラメータを 0 から 10 に更新。

StaticSwitchParameter

StaticSwitchParameter 表現式は 2 つの入力を取り、パラメータの値が「true」の場合は最初の入力を、そうでない場合は 2 番目の入力を出力します。

このパラメータは、ランタイム時に変更できないため、「static (スタティック)」という名前が付けられます。また、マテリアルインスタンスエディタでのみ設定できます。スタティックスイッチは、ランタイム時ではなくコンパイル時に適用されます。つまり、マテリアルのブランチがドロップされても実行されないため、ランタイム時にスタティックスイッチが効率よく解放されます。一方で、マテリアルはスタティックパラメータを 使用して 作成するごとに、その新しいバージョンをコンパイルする必要があります。そのため、これを乱用するとシェーダが容量やメモリを占有してしまう可能性があります。そのため、マテリアルのスタティックパラメータの数と、実際に使用されるスタティックパラメータの順列数を最小限に抑えるようにしてください。

プロパティ	説明
Parameter Name	マテリアルのインスタンスおよびコードを通じてパラメータの識別に使用する名前を指定します。
Group	MaterialInstanceConstant 内でパラメータ名をグループまたはカテゴリに整理できます。同じグループプロパティ名を持つマテリアル内のすべてのパラメータは、インスタンスエディタのそのカテゴリの下にリストされます。
Default Value	true の場合、最初の入力が出力されます。それ以外の場合、2 番目の入力が出力されます。
Extended Caption Display	true の場合、表現式のタイトルバーに表現式の値が表示されます。
入力
A	任意の数のチャンネルの値を受け取ります。
B	任意の数のチャンネルの値を受け取ります。

使用例： スタティックスイッチを使用して、ランタイムコストなしでマテリアルのブランチ全体を削除できます。マテリアルインスタンスは異なる値を持つことができます。パフォーマンスロスなしにテンプレート化したシェーダーを設定することが可能になります。

スタティックスイッチを True から False に更新。

StaticBoolParameter

StaticBoolParameter は、ブール値のパラメータのみを作成しスイッチは実装しないこと以外は、StaticSwitchParameter と同様に機能します。StaticBoolParameter を使用すると、マテリアル関数のブーリアン入力にデフォルト値を渡すことができます。

プロパティ	説明
Parameter Name	マテリアルのインスタンスおよびコードを通じてパラメータの識別に使用する名前を指定します。
Group	MaterialInstanceConstant 内でパラメータ名をグループまたはカテゴリに整理できます。同じグループプロパティ名を持つマテリアル内のすべてのパラメータは、インスタンスエディタのそのカテゴリの下にリストされます。
Default Value	パラメータのデフォルトのブール値です。「True (チェック済み)」または「False」で指定します。

スタティックスイッチはコンパイル時に適用されます (ランタイムでは適用されません)。つまり、マテリアルインスタンスエディタでパラメータを上書きすることはできますが、ゲームプレイ中に変更することはできません。つまり、マテリアルのブランチがドロップされても実行されないため、ランタイム時にスタティックスイッチが効率よく解放されます。一方で、マテリアルはスタティックパラメータを 使用して 作成するごとに、その新しいバージョンをコンパイルする必要があります。そのため、これを乱用するとシェーダが容量やメモリを占有してしまう可能性があります。そのため、マテリアルのスタティックパラメータの数と、実際に使用されるスタティックパラメータの順列数を最小限に抑えるようにしてください。

このノードは MaterialFunctions で使用します。

StaticComponentMaskParameter

StaticComponentMaskParameter 表現式は、インスタンスによってマスク値を設定できることを除いて、通常のコンポーネントマスクと同じように動作します。

プロパティ	説明
Parameter Name	マテリアルのインスタンスおよびコードを通じてパラメータの識別に使用する名前を指定します。
Group	MaterialInstanceConstant 内でパラメータ名をグループまたはカテゴリに整理できます。同じグループプロパティ名を持つマテリアル内のすべてのパラメータは、インスタンスエディタのそのカテゴリの下にリストされます。
Default R	チェックされている場合、入力値の赤または最初のチャンネルが出力に渡されます。
Default G	チェックされている場合、入力値の緑または 2 番目のチャンネルが出力に渡されます。
Default B	チェックされている場合、入力値の青または 3 番目のチャンネルが出力に渡されます。
Default A	チェックされている場合、入力値のアルファまたは 4 番目のチャンネルが出力に渡されます。

使用例： スタティックコンポーネントマスクを使用すると、インスタンスが使用するマスクテクスチャのチャンネルを選択できます。マスクがスタティック (ランタイム時に変更が不必要) な場合、チャンネルをマスクするためにベクターパラメータでテクスチャルックアップを乗算する代わりに常にこの方法を使用します。

チェックされたチャンネルは出力に通過し、チェックされていないチャンネルは破棄されます。

VectorParameter

VectorParameter 表現式は、パラメータであり、マテリアルのインスタンスであることとコードを介して変更できること以外は、Constant4Vector と同じです。VectorParameter の優れた点の 1 つは、カラーピッカーを使用して値を設定できることです。

プロパティ	説明
Parameter Name	マテリアルのインスタンスおよびコードを通じてパラメータの識別に使用する名前を指定します。
Group	MaterialInstanceConstant 内でパラメータ名をグループまたはカテゴリに整理できます。同じグループプロパティ名を持つマテリアル内のすべてのパラメータは、インスタンスエディタのそのカテゴリの下にリストされます。
Default Value [REGION:prop_sublist] R G B A [/REGION]	The vector to output by default unless overridden by a MaterialInstanceConstant. [REGION:prop_sublist] 表現式が出力するベクターの赤または 1 番目のチャンネルの浮動小数点値を指定します。表現式が出力するベクターの緑または 2 番目の浮動小数点値を指定します。表現式が出力するベクターの青または 3 番目の浮動小数点値を指定します。表現式が出力するベクターのアルファまたは 4 番目の浮動小数点値を指定します。 [/REGION]

VertexColor は、補間が制限されているため、Transform ノードと相互に排他的な関係となっています。Transform ノードと VertexColor を両方使用すると、 VertexColor は全て白になります。

プログラマー向け: スプライトパーティクルの場合、色は頂点ごとにシェーダに伝えられますが、メッシュパーティクルの色はシェーダ定数として設定されます。

TextureObjectParameter

TextureObjectParameter 表現式は、テクスチャパラメータを定義します。この式は、テクスチャ入力のあるマテリアル関数にテクスチャパラメータを渡すために頻繁に使用されます。Material Function ノードの Texture 入力は、TextureSample 2D ノードの Float3 データとは互換性がないため、Texture Object (T2d) が必要です。このノードは実際にテクスチャをサンプリングしないため、TextureSample ノードと組み合わせて使用する必要があります。

プロパティ	説明
Parameter Name	マテリアルのインスタンスおよびコードを通じてパラメータの識別に使用する名前を指定します。
Group	MaterialInstanceConstant 内でパラメータ名をグループまたはカテゴリに整理できます。同じグループプロパティ名を持つマテリアル内のすべてのパラメータは、インスタンスエディタのそのカテゴリの下にリストされます。
Texture	表現式によってサンプリングされたテクスチャを指定します。
Sampler Type	ノードからサンプリングおよび出力されるデータタイプです。
MipValueMode	サンプルのミップレベルもしくはデフォルトハードウェアで計算された導関数をカスタマイズする方法を選択します。外観とパフォーマンスの調整に影響します。

このノードは MaterialFunctions で使用します。

TextureSampleParameter2D

TextureSampleParameter2D 表現式はマテリアルのインスタンス、ブループリント、コードを介して変更できるパラメータであること以外は、TextureSample と同じです。

プロパティ	説明
Parameter Name	マテリアルのインスタンスおよびコードを通じてパラメータの識別に使用する名前を指定します。
Group	MaterialInstanceConstant 内でパラメータ名をグループまたはカテゴリに整理できます。同じグループプロパティ名を持つマテリアル内のすべてのパラメータは、インスタンスエディタのそのカテゴリの下にリストされます。
Texture	表現式によってサンプリングされたテクスチャを指定します。
Sampler Type	ノードからサンプリングおよび出力されるデータタイプです。
MipValueMode	サンプルのミップレベルもしくはデフォルトハードウェアで計算された導関数をカスタマイズする方法を選択します。外観とパフォーマンスの調整に影響します。
入力
UVs	テキスチャに使用する UV テクスチャ座標を受け取ります。UV に値が入力されなかった場合、マテリアルが適用されているメッシュのテクスチャ座標が使用されます。
出力
RGB	色の 3 つのチャンネルである RGB ベクターの値を出力します。
R	色の赤チャンネルを出力します。
G	色の緑チャンネルを出力します。
B	色の青チャンネルを出力します。
A	色のアルファチャンネルを出力します。テクスチャにアルファチャンネルが含まれていない場合でも、「アルファ」チャンネルへ何かを接続すると、表向きは不正行為ではないものの常に結果はゼロ (黒) となります。

TextureSampleParameterSubUV

TextureSampleParameterSubUV は、マテリアルのインスタンスやコードを通じて修正できるパラメータである点を除いて ParticleSubUV と同一です。

アイテム	説明
プロパティ
Parameter Name	マテリアルのインスタンスおよびコードを通じてパラメータの識別に使用する名前を指定します。
Group	MaterialInstanceConstant 内でパラメータ名をグループまたはカテゴリに整理できます。同じグループプロパティ名を持つマテリアル内のすべてのパラメータは、インスタンスエディタのそのカテゴリの下にリストされます。
Blend	次から次へとフレームを即時に「ポッピング」するのではなく、 SubUV スプライトレイアウトの各フレームを一緒にブレンドします。
Texture	表現式によってサンプル化されたテクスチャを指定します。
Sampler Type	ノードからサンプルおよび出力されるデータタイプです。
MipValueMode	サンプルのミップレベルもしくはデフォルトハードウェアで計算された微分係数をカスタマイズする方法を選択します。外観とパフォーマンスの調整に影響します。
入力
UVs	UV 入力値は無視され何も起こりません。
出力値
RGB	その色の 3 つのチャンネルである RGB ベクターの値を出力します。
R	その色の赤チャンネルを出力します。
G	その色の緑チャンネルを出力します。
B	その色の青チャンネルを出力します。
A	その色のアルファチャンネルを出力します。テクスチャにアルファチャンネルが含まれていない場合、「アルファ」チャンネルへ何かを接続すると、表向きは不正行為ではないものの常に結果はゼロ (黒) となります。

TextureSampleParameterCube

TextureSampleParameterCube 表現式は、キューブマップのみを受け取る点と、マテリアルのインスタンスおよびコードを介して変更できるパラメータである点を除いて、TextureSample と同じです。

プロパティ	説明
Parameter Name	マテリアルのインスタンスおよびコードを通じてパラメータの識別に使用する名前を指定します。
Group	MaterialInstanceConstant 内でパラメータ名をグループまたはカテゴリに整理できます。同じグループプロパティ名を持つマテリアル内のすべてのパラメータは、インスタンスエディタのそのカテゴリの下にリストされます。
Texture	表現式によってサンプリングされたテクスチャを指定します。
Sampler Type	ノードからサンプリングおよび出力されるデータタイプです。
MipValueMode	サンプルのミップレベルもしくはデフォルトハードウェアで計算された導関数をカスタマイズする方法を選択します。外観とパフォーマンスの調整に影響します。
入力
UVs	テキスチャに使用する UV テクスチャ座標を受け取ります。UV に値が入力されていない場合、マテリアルが適用されているメッシュのテクスチャ座標が使用されます。この入力は 2 チャンネルベクター値を受け取ります。
出力
RGB	色の 3 つのチャンネルである RGB ベクターの値を出力します。
R	色の赤チャンネルを出力します。
G	色の緑チャンネルを出力します。
B	色の青チャンネルを出力します。
A	色のアルファチャンネルを出力します。テクスチャにアルファチャンネルが含まれていない場合でも、「アルファ」チャンネルへ何かを接続すると、表向きは無効ではないものの常に結果はゼロ (黒) となります。

TextureSampleParameterMovie

TextureSampleParameterMovie 表現式は、ムービーテクスチャ (Bink ムービー) のみを受け取る点と、マテリアルのインスタンスおよびコードを介して変更できるパラメータがある点を除き、TextureSample と同じです。

プロパティ	説明
Parameter Name	マテリアルのインスタンスおよびコードを通じてパラメータの識別に使用する名前を指定します。
Group	MaterialInstanceConstant 内でパラメータ名をグループまたはカテゴリに整理できます。同じグループプロパティ名を持つマテリアル内のすべてのパラメータは、インスタンスエディタのそのカテゴリの下にリストされます。
Texture	表現式によってサンプリングされたテクスチャを指定します。
Sampler Type	ノードからサンプリングおよび出力されるデータタイプです。
MipValueMode	サンプルのミップレベルもしくはデフォルトハードウェアで計算された導関数をカスタマイズする方法を選択します。外観とパフォーマンスの調整に影響します。
入力
UVs	テキスチャに使用する UV テクスチャ座標を受け取ります。UV に値が入力されなかった場合、マテリアルが適用されているメッシュのテクスチャ座標が使用されます。
出力
RGB	色の 3 つのチャンネルである RGB ベクターの値を出力します。
R	色の赤チャンネルを出力します。
G	色の緑チャンネルを出力します。
B	色の青チャンネルを出力します。
A	色のアルファチャンネルを出力します。テクスチャにアルファチャンネルが含まれていない場合でも、「アルファ」チャンネルへ何かを接続すると、表向きは不正行為ではないものの常に結果はゼロ (黒) となります。

コレクション パラメータ