Unreal Engine 5 ドキュメントは Epic Developer Community に移動しました

このページでは、Visual Dataprep システムでアセットとシーン要素を変更するために使用することができる各 オペレーション ブロックについて説明します。

オペレーション ブロックの各タイプは、Unreal Editor が 3D データに対して行うことができる特定の種類の変更をカプセル化します。Visual Dataprep システムは、Dataprep グラフで各アクションを実行するときに、その上の フィルター (Select By) ブロックで設定された条件に一致するすべてのアセットまたはアクタに対して、そのアクションで定義した各オペレーションを実行します。背景情報の詳細については、「 Visual Dataprep の概要 」を参照してください。

On Actor

On Actor は、手順に設定した Select By の条件に一致するアクタにのみ適用されます。つまり、Dataprep プレビュー UI の右側にある [アウトライナ プレビュー] パネルにリストされているアイテムのみが表示されます。 フィルター (Select By) 条件が、Dataprep プレビュー UI の左側にある [コンテンツ ブラウザ プレビュー] パネルにリストされているテクスチャ、マテリアル、スタティック メッシュ アセットなど、他のシーン要素と一致する場合、 On Actor オペレーションはそれらの要素に影響しません。

Add Tags

このオペレーションは、この手順で設定した フィルター 条件に一致する各アクタに指定したタグの配列を追加します。

Add To Layer

このオペレーションは、この手順で設定した フィルター 条件に一致する各スタティックメッシュ アクタを指定したタグの配列を追加します。

Compact Scene Graph

このオペレーションは、手順に設定した フィルタ 条件に一致する各スタティック メッシュ アクタについて、このアクタがシーンで視覚的なエフェクトを持たず、シーン階層内のどの子孫もシーンで視覚的なエフェクトを持っていない場合にアクタを削除します。これにより、シーン内の視覚オブジェクトを失うことなく、シーン階層から不要な要素を整理できます。

Create Proxy Mesh

このオペレーションは、この手順で設定した フィルタ 条件に一致するすべての Static Mesh アクタからジオメトリを収集し、[ Proxy Geometry Tool (プロキシ ジオメトリ ツール)] を使用してジオメトリを単一の新しいメッシュにマージします。

Merge

このオペレーションは、設定した フィルタ 条件に一致するすべてのスタティック メッシュ アクタからジオメトリを収集し、ジオメトリを単一の新しいメッシュにマージします。

Random Offset Transform

このオペレーションは、この手順で設定した フィルタ 条件に一致する各アクタに対して、アクタの 3D 位置、回転、スケールにランダムなオフセットを適用します。シーンにプレースホルダー要素がある場合、このオペレーションを使用してそれらの要素を分散したり、様々なサイズや回転を与えることができます。

たとえば、建物の外のシーンには樹木や茂みのようなシーン環境のプレースホルダー オブジェクトが含まれているとします。Dataprep グラフでは、それらすべてのプレースホルダーをすでにプロジェクトにインポート済みの他のカスタム 3D アセットと置き換える必要が生じます。その場合、同じ木が並ぶ不自然な結果となる可能性があります。しかし、木の位置や回転、スケーリングにランダム オフセットを適用することにより、オブジェクトを手動で調整することなく、よりバリエーション豊富でリアルな結果を素早く作成することができます。

Set Mesh

このオペレーションは、この手順で設定した フィルタ 条件に一致する各 スタティックメッシュ アセットについて、アクタが参照するすべてのスタティックメッシュ アセットを、設定で指定した異なるスタティックメッシュ アクタに変更します。

Set Metadata

このオペレーションは、手順に設定した フィルタ 条件に一致する各アクタが維持する Datasmith のメタデータにキーと値の配列を追加します。

Set Mobility

このオペレーションは、この手順で設定した フィルタ 条件に一致する各アクタに対して、アクタの [Mobility (可動性)] の値を設定します。

Spawn Actors at Location

このオペレーションは、手順に設定した フィルタ 条件に一致する各アクタについて、同じ 3D 座標に新しいアクタをスポーンします。新しくスポーンしたアクタは、 [Selected Asset] 設定に指定したアセットのインスタンスです。

On Asset

On Asset は、手順に設定した フィルタ 条件に一致するアセットにのみ適用されます。す。つまり、Dataprep プレビュー画面の左側にある コンテンツブラウザ プレビュー パネルにリストされているアイテムのみが対象です。Dataprep プレビュー画面の右側にある アウトライナ プレビュー パネルにリストされているアクタなど、他のシーン要素と フィルタ 条件が一致しても、 On Asset オペレーションはそれらの要素に影響しません。

Output to Folder

このオペレーションは、手順に設定した フィルタ 条件に一致する各アセットを、指定した名前を持つサブフォルダに移動します。Dataprep グラフの結果をコミットした後、このブロックを使用してインポートしたアセットをプロジェクトのコンテンツ ブラウザで整理する方法をカスタマイズできます。

Dataprep グラフでは Output to Folder ブロックをいくつでも使用することができます。異なるブロックに同じ Folder Name 設定を使用する場合、それらの異なるブロックが処理するアセットは単一のフォルダにまとめられます。これにより、異なるアクションにおけるいくつかの異なるフィルタから生じるアセットがコンテンツ ブラウザ内の同一フォルダにリダイレクトされます。異なるフィルタを持つ複数の Output to Folder ブロックをペアにすることにより、アセットを コンテンツ ブラウザ で最終的に目的とする形に分配することができます。

この例の場合、Dataprep エディタの右上の [Settings (設定)] パネルにあるメイン フォルダは「 /Content/Motorbike 」です。このグラフの最初のアクションは、保持しているトライアングルの数が 1000 より少ないスタティック メッシュ アセットをすべて「 LowPoly 」という名前のサブフォルダに移動します。次のアクションでは、トライアングルを 1000 以上持っている他のスタティック メッシュをすべて「 HighPoly 」という名前のサブフォルダに移動します。最後に、残りの 2 つのアクションですべてのマテリアルとすべてのマテリアル インスタンスを「 Surfaces 」という名前のサブフォルダに移動します。

Dataprep グラフをコミットした後、コンテンツ ブラウザには次のようなフォルダ構造が表示されます。

通常、デフォルトの Datasmith インポート プロセスによって作成される「 Geometries 」および「 Materials 」サブフォルダも作成されますが、この場合、それらのフォルダは空です。すべてのアセットは、新しい「 HighPoly 」、「 LowPoly 」、および「 Surfaces 」サブフォルダに再分配されます。

Replace Asset References

このブロックは、渡されたオブジェクトのリストにある 最初の アセットを識別します。次に、入力リストにある 他の アセットへの参照をすべて最初のアセットへの参照に置き換えようと試みます。

たとえば、入力リストの最初のオブジェクトが「 Chair 」と名付けられたスタティック メッシュ アセットだとします。すると、このブロックは入力リスト内の他のオブジェクトをすべて確認し、 Table 、 Bench 、および Dresser など、他のスタティック メッシュ アセットを検索します。次に、インポートしたシーンのどこかで Table 、 Bench 、および Dresser への参照があれば Chair への参照に置き換え、 さらに Table 、 Bench 、および Dresser アセットを完全に削除します。

On Mesh

On Mesh は、スタティックメッシュ アセットにのみ適用されます。

• Select By の条件が [コンテンツ ブラウザ プレビュー] パネルの「 Geometries 」フォルダの下に表示される スタティックメッシュ アセットと一致する場合、このオペレーションがそれらのアセットに適用されます。

• フィルタ 条件が、スタティックメッシュ アセットを参照する アウトライナ プレビュー のいずれかのアクタと一致する場合、このオペレーションがそれらの スタティックメッシュ アセットにも適用されます。

• フィルタ 条件がアクタ、テクスチャ、マテリアルなどの他の種類のシーン要素と一致する場合、 On Mesh オペレーションがそれらの要素に影響を与えることはありません。

Bake Transform

この手順で設定した フィルタ 条件に一致する各スタティック メッシュについて、このオペレーションは、スタティック メッシュのトランスフォームを参照するメッシュに直接ベイクすることで新しいメッシュを作成し、スタティックメッシュ アクタのメッシュをこの新しいメッシュに置き換えます。このオペレーションにはいくつかのオプションがあります。

Flip Faces

このオペレーションは、手順に設定した フィルタ 条件に一致する各スタティック メッシュについて、メッシュのすべてのトライアングルの向きを反転します。

Generate Unwrapped UVs

この手順で設定した フィルタ 条件に一致する各スタティック メッシュについて、このオペレーションはメッシュ ジオメトリを 2D UV マップにアンラップし、スタティックメッシュ アセットの指定された UV チャンネルにマッピングを保存します。

Remesh

手順に設定した フィルタ 条件に一致する各スタティック メッシュに対して、このオペレーションは等方性の再メッシュを使って指定したターゲット値に一致するトライアングル数を満たします。このオペレーションにはいくつかのオプションがあります。

Set Convex Collision

この手順で設定した フィルタ の条件に一致する各スタティック メッシュについて、このオペレーションはスタティック メッシュのコリジョンを、複数のボリュームまたは ハル で構成される新しい凸型分解に置き換えます。

Set LOD Group

このオペレーションは、この手順で設定した Select By の条件に一致する各スタティック メッシュについて、スタティック メッシュの既存の LOD を、指定したグループの設定に基づいた新しい LOD に置き換えます。

Set LODs

この手順で設定した フィルタ の条件に一致する各スタティック メッシュについて、このオペレーションは、スタティック メッシュの既存の LOD を、指定した削減設定に基づく新しい LOD に置き換えます。

Set Simple Collision

この手順で設定した フィルタ の条件に一致する各スタティック メッシュについて、このオペレーションは、スタティック メッシュの既存のコリジョンを、指定した形状の単純なコリジョン ボリュームに置き換えます。

Setup Static Lighting

この手順で設定した フィルタ の条件に一致する各スタティック メッシュに対して、このオペレーションはスタティック メッシュとベイクしたライティングとのやり取りを制御するオプションを設定します。

Simplify Mesh

この手順で設定した フィルタ の条件に一致する各スタティック メッシュに対して、このオペレーションによりスタティックメッシュが元のトライアングル数の設定されたパーセンテージが単純化されます。このオペレーションにはいくつかのオプションがあります。

Weld Edges

この手順で設定した フィルタ 条件に一致する各スタティック メッシュに対して、このオペレーションは指定許容値内の頂点ペアを 1 つにまとめます。 If Only Unique を有効にすると、このオペレーションは同等のエッジのペアのみがマージされます。

On Object

On Object オペレーションは、潜在的に フィルタ 条件に一致するあらゆる種類のシーン要素に適用されます。

Delete Objects

このオペレーションは、この手順で設定した フィルタ 条件に一致するすべてのオブジェクトを削除します。

Delete Unused Assets

このオペレーションは、この手順で設定した フィルタ 条件に一致し、他のアセットまたはアクタによって参照されていない、すべてのアセットを削除します。

Set Material

この手順で設定した フィルタ 条件に一致する各スタティック メッシュまたは スタティックメッシュ アクタについて、このオペレーションは既存のすべてのマテリアルを指定したマテリアルに置き換えます。

Substitute Material

この手順で設定した フィルタ 条件に一致する各スタティック メッシュまたは スタティックメッシュ アクタについて、このオペレーションは、条件に一致するすべてのマテリアルを指定した代替マテリアルに置き換えます。

Substitute Material By Table

このオペレーションは、この手順で設定した フィルタ 条件に一致する各スタティック メッシュまたは スタティックメッシュ アクタについて、データ テーブル アセットで指定した置換テーブルに従ってマテリアルを置き換えます。

Material Data Table 設定では MaterialSubstitutionDataTable 行構造体を使用しなければなりません。通常は、データ テーブル アセットの作成時に [Pick Row Structure] ダイアログ ボックスで行フォーマットを設定します。例：

この行構造体を使って、データ テーブルの各行で 1 つマテリアルを置換するオペレーションが定義されます。

• 行の最初の値の Row Name は、置換の名前として解釈されます。この値は自由に設定できます。

• 2 番目の値の Search String は、で、このオペレーションで置き換えるマテリアルの名前または名前の一部です。

• 3 番目の値の String Match は、スタティックメッシュ アセットとアクタのマテリアルと、この行の 2 番目の値に設定した検索文字列との間で行う文字列比較のタイプです。 Substitute Material オペレーションで受け取とった任意の値、つまり、 Exact Match (完全一致) 、 Contains (一部一致) 、 Matches Wildcard (ワイルドカードに一致) を使用できます。これらのオプションは、 フィルタ ブロックで文字列フィルタを使用する場合と同じ方法で解釈されます。詳細については、「 Visual Dataprep Selection リファレンス 」を参照してください。

• 4 番目の値の Material Replacement は、検索文字列に一致するマテリアルを置き換えるために使用する Material アセットの完全な名前です。

  この値を取得するには、 [コンテンツブラウザ] でマテリアルを右クリックし、コンテキスト メニューから [Copy Reference (リファレンスをコピー)] を選択します。

次に例を示します。