マテリアル エディタ ユーザー ガイド

ドキュメント概要：Unreal マテリアル エディタを使用するためのガイドです。

Dave Burke^? により作成。 Daniel Wright により更新。 Richard Nalezynski^? により管理。

はじめに

このドキュメントは UnrealEd のマテリアル エディタの使用法を説明するものです。さまざまなマテリアル式の説明に関しては、 マテリアル要約 を参照してください。新しいマテリアル式の説明に関しては、 マテリアル式の作成 を参照してください。

マテリアルエディタの概要

マテリアル エディタを開く

マテリアルエディタを開くには、Generic ブラウザでマテリアルをダブルクリックしてください。エディタは 4 つのセクションに分かれており、以下のようにラベルが付いています。

マテリアル エディタ概観

マテリアル エディタ レイアウト

メニュー バー

ウィンドウ

プロパティ: プロパティペインを表示します。

プレビュー: プレビューペインを表示します。

マテリアル式: マテリアル式グラフを表示します。

ツール バー

ツールバー ボタンのそれぞれの説明が、左から右へツールバーに現れるように続きます。

アイコン	名前	説明
	ホーム	ベース マテリアル ノードがメインペインの左上の隅に表示されるように、マテリアル式グラフを移動します。
	グリッドのトグル	マテリアル プレビューペイン内で、背景のグリッドをトグルします。
	形状のプレビュー	マテリアルをプレビューする形状を標準から選択します。
	プレビュー メッシュの選択	プレビュー メッシュを、現在ロードされているすべての静的メッシュがリストされた、このドロップダウン リストから選択します。
	選択された StaticMesh をGeneric ブラウザで使用	Generic ブラウザ内で静的メッシュを選択し、このボタンを押して選択したメッシュをプレビュー メッシュにします。
	未使用の式のクリーン	マテリアルに繋がっていないすべてのマテリアル式ノードを削除します。
	未使用コネクタの表示/非表示	何にも接続されていないマテリアル式コネクタを表示/非表示します。
	カーブ 接続のトグル	カーブと直線の接続をトグルします。 エディタ パフォーマンスではこのフラグを無効化してください。
	リアルタイム マテリアル ビューポートのトグル	有効化された場合は、プレビュー メッシュ上のマテリアルをリアルタイムでアップデートしてください。 エディタ パフォーマンスではこのフラグを無効化してください。
	リアルタイム式ビューポートのトグル	有効化された場合は、それぞれのマテリアル式ノードのマテリアルをリアルタイムでアップデートしてください。 エディタ パフォーマンスではこのフラグを無効化してください。
	式リアルタイム プレビューのトグル	このボタンはマテリアル式の bRealtimePreview フラグのグローバル トグルです。 有効化された場合は、ノードが追加、削除、接続、切断、される度に、またはプロパティ値が変わると、すべての副次式のシェーダがコンパイルされます。 エディタ パフォーマンスではこのフラグを無効化してください。 式のプレビュー? セクションを参照してください。

プレビュー ペイン

マテリアル プレビュー ペインは、メッシュに適用された編集されているマテリアルを表示します。左のマウス ボタンでドラッグすることにより、メッシュが回転します。真ん中のマウス ボタンでドラッグすることによりパンができます。右のマウス ボタンでのドラッグでズームできます。[L] の長押しと左マウスボタンでのドラッグでライトの方向が回転します。

プレビュー メッシュは、関連付けられたツールバー操作 (形状ボタン、[Select Preview Mesh] (プレビュー メッシュの選択) コンボ、[Use Selected StaticMesh] (選択された StaticMesh の使用) ボタン) を使用することで変更できます。マテリアル エディタで次回マテリアルが開かれたときに、同じメッシュでプレビューできるように、プレビュー メッシュはマテリアルとともに保存されます。

プロパティペイン

このペインは、選択されたマテリアル式のプロパティウィンドウを含みます。式が選択されていない場合、編集されているマテリアルのプロパティが表示されます。

Material(マテリアル)

Usage

Usage プロパティフラグは、異なるメッシュ型、またはレンダリングテクニックのマテリアルを使用できるようにします。 これにはいつかのカテゴリが存在します。

フラグはレンダリングビヘイビアを制御するため、互いに他のフラグと排他的です。

• bUsedAsLightFunction
• bUsedWithFogVolumes
• bUsedWithDecals

特殊：

• bUsedWithGammaCorrection - シェーダの最後にガンマ補正をします。これはLDRUIシーンに適用されたマテリアルのみに必要です。
• bUsedWithMaterialEffect - マテリアルが不透明でもscene depth (シーンデプス)およびscene color (シーンカラー)から読むことができるようにします。

残りすべてのフラグは、指定したメッシュ型のマテリアルにサポートを追加します。例えば、 bUsedWithStaticLighting をチェックすることで、ライトマップされた静的メッシュまたはBSPのマテリアルを使うことができます。これは一方では、必要なシェーダがそれぞれに相当したメッシュ型用にコンパイルされてしまう原因となります。それらのフラグは、特定のフラグの設定が必要なメッシュに割り当てた時、必要に応じてエディタにより設定され、マテリアルは保存されなければならないため、「dirty (ダーティ)」とマークされます。

注意: ゲーム内では、フラグは自動的に設定「されません」。また、適切なフラグが設定されないと、デフォルトマテリアルが使用されます。 これについては、どのマテリアルが問題だったのか、どのフラグが必要かを詳細にわたり長い警告文で表示されます

Material Instance(マテリアルインスタンス)

Object(オブジェクト)

マテリアル式ペイン

このペインは、ドラッグ & ドロップでマテリアル内に設置されたマテリアル式のリストを含みます。新しいマテリアル式ノードを設置するには、設置する式のタイプを左クリックして、カーソルをグラフペインにドラッグし、離してください。

マテリアル式グラフペイン

このペインは、このマテリアルに属するすべてのマテリアル式のグラフを含みます。マテリアルで使用されているシェーダ命令の数が、左上の隅に表示されます。命令の数が少ないほど、マテリアルのコストは低くなります。ベースマテリアル ノードに接続していないマテリアル式ノードは、マテリアルの命令カウント (コスト) に寄与しません。

操作

マテリアル エディタ内の操作は、概して UnrealEd 内のその他のツールの操作と同じです。例えば、マテリアル式グラフは、他のリンクしたオブジェクトエディタと同じように操作できますし、マテリアルプレビューメッシュは、他のメッシュ ツールのように方向を合わせることができます。

マウスの操作

キーボードの操作

ホットキー

よく使われるマテリアル式タイプを設置するホットキーが存在します。ノードにドロップするには、ホットキーを押しながら左クリックをします。ホットキーは以下の通りです。

マテリアルでの作業

式のコメント

コメントは、マテリアルが何をしているかをドキュメントするのに非常に良い方法です。これにより、何がマテリアルを複雑化したかを理解するのがより容易になります。コメントは関連付けられたノードの上に青のテキストで表示されます。コメントはズーミングに依存せずレンダリングされ、複雑なマテリアル グラフの操作を容易にします。

ノードの “Desc” プロパティにテキストを入力することで、マテリアル式ノードの個々にコメントを付けることができます。

いくつかのノードを選択し、[C] を押すことで、ノードのグループにグループ コメントを割り当てることができます。“New Comment (新しいコメント)” ダイアログにコメント テキストを入力し、[OK] を押してください。選択されたノードはコメント フレーム内でグループされます。グループ コメント内のノードは、グループ コメント テキストにドラッグすることで移動できます。コメント フレームの右下の隅にある黒い三角形をドラッグすることで、フレームのリサイズができます。グループ コメント内のいかなるノードはフレームと共に動くので、既存のフレームに新しいノードを含むようにリサイズすることができます。

コメントを選択し、プロパティ ウィンドウを使い、”Text (テキスト)” プロパティを変更することで、コメントの名前の変更ができます。

式のプレビュー

マテリアル エディタのノードは、左上の隅に小さなボックスを含みます。このボックスはノードの bRealtimePreview プロパティを示します。黄色は有効化、黒は無効化されていることを示します。

いかなる方法 (ノードが作成、削除、接続される、プロパティが変更されるなど) でもマテリアル変更があった場合、bRealtimePreview が有効化されたすべてのノードは、そのシェーダをリコンパイルします。このリコンパイルは、そのノードで描かれたマテリアル プレビューが最新であるために必要です。しかし、これらの中間シェーダのリコンパイルには (特にマテリアルがたくさんのノードを含んでいる場合は) 時間がかかります。ワークフローの障害を避けるためにも、TextureSample 以外のすべてのノード タイプで bRealtimePreview はデフォルトで無効化されています。

スペースバーを押すことで、すべてのプレビューを強制的にアップデートできます。従って、なるべく多くのノードで bRealtimePreview を無効化することで、速いイテレーションを得ることができ、スペースバーを押すことで、いつでも変更を見ることができます。

ノードの左上の隅のボックスをクリックする、または選択されたノードのプロパティ ウィンドウを使用することで、ノードの bRealtimePreview を有効化することができます。

[Toggle Expression Realtime Preview] (式リアルタイム プレビューのトグル)ボタンですべてのノードのグローバルトグルが可能です。

マテリアル参照

マテリアルプロパティ

PhysMaterial

物理マテリアルは、このマテリアルと関連付けられています。 物理マテリアル を参照してください。

OpacityMaskClipValue

これは、マスク付マテリアルの OpacityMask 入力がピクセルごとにクリップするリファレンス値です。OpacityMaskClipValue より高い値はパスし、ピクセルが描かれます。低い値の場合は、失敗となりピクセルは破棄されます。

BlendMode

BlendMode は、現在のマテリアル (ソース カラー) の出力がレンダリング時にどのようにして既に framebuffer (デスティネーション カラー) 内にあるマテリアルと組み合わさるかを記載します。

• BLEND_Opaque – ファイナル カラー = ソース カラーです。このブレンド モードはライティングと互換性があります。
• BLEND_Masked – OpacityMask < OpacityMaskClipValue の場合、ファイナル カラー = ソース カラーです。そうでない場合、ピクセルは破棄されます。このブレンド モードはライティングと互換性があります。
• BLEND_Translucent – ファイナル カラー = ソース カラー x 半透明 + デスティネーション カラー x (1 – 半透明) です。このブレンド モードは動的ライティングと互換性が ありません 。
• BLEND_Additive – ファイナル カラー = ソース カラー + デスティネーション カラーです。このブレンド モードは動的ライティングと互換性が ありません 。
• BLEND_Modulate – ファイナル カラー = ソース カラー x デスティネーション カラーです。このブレンド モードは、decal マテリアルでない限り、動的ライティング、またはフォグと互換性が ありません 。

LightingModel

ライティング モデルは、ファイナル カラーを作るマテリアルの入力方法 (例：Emissive, Diffuse, Specular, Normal) の組み合わせを決定します。

• MLM_Phong – デフォルトのライティング モデルであり、ディフューズとスペキュラーがピクセルごとに演算されます。
• MLM_NonDirectional – ピクセルごとのディフューズで、スペキュラーはありません。ライティング式でサーフェス法線はファクタではありません。現時点で、これは動的リット マテリアルのみで動作します。
• MLM_Unlit – 放射のみです。このライティング モデルは、いかなる透明なブレンド モードに必要となります。
• MLM_SHPRT – 非推奨です。
• MLM_Custom - 任意のライティング モデルの使用を可能にします。 カスタム ライティング をご覧ください。
• MLM_Anisotropic – 毛髪やブラシ済みマテリアルなどのアニソトロピックマテリアルに使用されます。 アニソトロピックライティング をご覧ください。

TwoSided

法線は裏面で反転しています。これは、ライティングは表面と裏面の両方が演算されるということです。これは、ポリゴンの数が 2 倍になるのを避けるために、フォリッジでよく使用されます。静的ライティングは 1 つの半球で入ってくるライトのみを格納するので、静的ライティングでは、両面は正常に動作しません。結果として、静的ライティングを持つ両面マテリアルは、両面とも同じようにシェードされます。

Wireframe

マテリアルはワイヤフレーム内でレンダリングします。

トランスルーセンシー

bDisableDepthTest

マテリアルのデプステストを無効にします。これは、トランスルーセントブレンドモードでのみ有益です。デプステストを無効にすることは、オクルードされたピクセルが　Zカル(Z軸でソートされ、可視でない場合削除されること)されないため、レンダリングを著しく遅くします。

bAllowFog

マテリアルがフォグを有効にするかどうか、またフォグによる影響を向こうにするかを設定します。これは、トランスルーセントブレンドモードでのみ有益です。

bUseOneLayerDistortion

マテリアルがone-layer distortionを使うかどうかを設定します。これはプリミティブ型(主に流体サーフェス)の通常のディストーションよりコストが安くなります。One layer distortion はone layer distortion プリミティブのオーバーラッピングを正確に処理しません。 これはone layer distortion を使用している最初のプリミティブの余分なシーンカラー情報の解決を引きおこします。そのため、非常に特定の環境でのみ使われるべきです。

FallbackMaterial

シェーダ モデル 2 のマテリアルをコンパイルする際に、各マテリアルは変更されずにコンパイルされます。もしこれが、シェーダ モデル制限 (命令過多など) のために失敗した場合、Specular、Normal、Emissive、Diffuseは、マテリアルがコンパイルするまで 1 つずつ落とされていきます。 ディフューズを落とさなければならない場合は緑で置換し、エミッシブを落とさなければならない場合は赤で置換します。これは、自動、または生成されたフォールバックと呼ばれます。フォールバック マテリアルを指定することで、アーティストはこのプロセスをオーバーライドできます。その場合、生成プロセスは完全にスキップされ、その代わりにフォールバック マテリアルがシェーダ モデル 2 カードで使用されます。 FallbackMaterialを作成するには、P 'Propagate to Fallback'(フォールバックにプロパゲート)ボタンをクリックします。次にフォールバックを編集するため F 'Open Fallback' (フォールバックを開く)ボタンをクリックします。今のところ、フォールバックマテリアルを一度作成してしまうと、それを削除する方法はありません。

使用法

これらのフラグは、各マテリアルのためにコンパイルされる必要のあるシェーダの数を最小限に抑えます。慎重に適切に設定してください。そうしないと、誤って使用された場合は以下のような警告が表示されます： "Material blah used with skeletal mesh, but missing bUsedWithSkeletalMesh=True (骨格メッシュとともに使用されているマテリアル XXX には bUsedWithSkeletalMesh=True がありません)"。例えば、マテリアルに bUsedWithSkeletalMesh=True が欠けているのに静的メッシュに割り当てされていると、エディタ内でフラグが設定され、マテリアルはリコンパイルされ、最終的にダーティとマークされます。しかしゲーム内では、デフォルトのマテリアルが使用されます。

bUsedAsLightFunction

このマテリアルがライト関数とともに使用されることを示します。

bUsedAsSpecialEngineMaterial

このマテリアルは、頂点ファクトリとマテリアル コンビネーションとともにコンパイルされなければいけないことを示しています。つまり、decal 以外のいかなるプリミティブ タイプに使用できるということです。これは、コンパイルされた大量のシェーダ (通常のマテリアルが約 30 使用するところを 600) に結果としてなるので、慎重に使用してください。

bUsedWithSkeletalMesh

このマテリアルが骨格メッシュとともに使用されることを示します。

bUsedWithParticleSystem

このマテリアルがパーティクル システムとともに使用されることを示します。

bIsFallbackMaterial

このマテリアルが他のマテリアルの代わりにフォールバック マテリアルとして使用されることを示します。いかなるコンパイル エラーは、シェーダ モデル 2 にこのマテリアルをコンパイルしたことが原因で起こります。bIsFallbackMaterial を持つマテリアルを決して何ものにも直接適用しないように注意してください。