Reference Viewer

このページでは、アセットの参照を定義し、Unreal Engine でのその表示方法を説明します。また、アセットの参照を特定する Unreal Engine のツールの概要、およびその設定やその他の機能についても示しています。

アセットの参照とは

あるアセットが何らかの方法で他のアセットを使用している場合、最初のアセットが 2 番目のアセットを 参照している と表現します。

たとえば、Cube アクタ が Color マテリアル を使用している場合、このアクタはそのマテリアルを参照しています。また、アクタにはそのマテリアルに対する 依存関係がある と表現することもできます。次のように考えてみてください。アクタは、そのマテリアルを参照しなければならず、そのマテリアルが必要なのです。

上の例では、DistanceToNearest_Mat_Gradient マテリアルが OceanNoise Texture2D アセットを参照しています。

参照は、一方向にのみ行われます。参照先のアセットが参照元のアセットを参照することはありません。

Reference Viewer ツール

Reference Viewer には、1 つ以上のアセットの参照元または参照先になっているアセットのグラフが表示されます。

Reference Viewer を開く方法

1. コンテンツ ブラウザ で、1 つ以上のアセットを選択します。

2. 選択したアセットを右クリックします。次に、コンテキスト メニュー から [Reference Viewer] を選択します。

選択内容に応じて、以下のようになります。

• 1 つのアセット：Reference Viewer にアセットの参照が表示されます。

• 複数のアセット：選択したアセットに共通する参照のみが表示されます。

• フォルダ：フォルダ内のすべてのアセットに対する参照のグラフが表示されます。

画像をクリックするとフルサイズで表示されます。

上のスクリーンショットでは、以下の Reference Viewer の主要要素を示しています。

1. 選択したアセットを参照する他のアセット。

2. 選択したアセット。

3. 選択したアセットに参照されている他のアセット。

4. Reference Viewer ツールバー。

5. 複数のアクティブな [Asset Filters (アセット フィルタ)] を備えた検索パネル。

これらの要素の詳細については、以下で説明します。

アセットの参照

Reference Viewer ツールには、選択したアセットの参照元または参照先になっているアセットのグラフが表示されます。参照関係は、参照されているアセットの方向を指す矢印で示されます。

この例では、M_Tree_FallTreeMerged_01 マテリアルと他の 3 つのアセットとの関係が、それらを接続する 3 つの矢印によって明確に示されています。

グラフ内のいずれかのアセットを右クリックすると、以下のオプションを含むコンテキスト メニューが表示されます。

Reference Viewer ツールバー

[Reference Viewer] ウィンドウの上部にある Reference Viewer ツールバー は、次のオプションを提供します。

検索パネル

Reference Viewer の右上隅の 検索 パネルを使用すると、以下のことができます。

• 名前で参照または依存関係を見つける。
• アセットタイプで参照をフィルタリングする。
• Unreal Engine で参照および依存関係を検索する深さを設定する。
• 検索を特定のアセット コレクションに制限する。

上のスクリーンショットは、検索パネルの主要領域を示しています。

Reference Viewer のアセット ノード

Reference Viewer の各アセットは、ビジュアル グラフ内の ノード によって表されます。ノードは、アセット タイプごとに色分けされ、名前、タイプ、サムネイルなど、アセットに関するより多くの情報を含んでいます。

ノードは、通常 (完全表示) とコンパクトのどちらかにすることができます。Reference Viewer ツールバーの [View] メニュー (上の Reference Viewer ツールバーのセクションを参照) から、またはキーボード ショートカットの V を使用して、これら 2 つのモードを切り替えます。

非アクティブ ノード

フィルタを使用すると、非アクティブなノードがいくつか表示される場合があります (それらのノードは半透明で常にコンパクト モードです)。これらのノードは現在のフィルタでは除外されていますが、2 つのアセットのいずれかとして存在し、除外されていません。参照のチェーンが明確になるように、非アクティブなノードも表示されます。

この例では、Material アセットがフィルタで除外されています。2 つの Material ノード (M_Tree_FallBark_01 と M_Tree_FallTreeMerged_01) は、参照チェーンが元のまま維持されるように、非アクティブなノードとして表示されています。

Overflow ノード

検索パネルの [Search Breadth Limit] の値が大きい場合、Reference Viewer にすべてのアセットの参照が一度に表示されないことがあります。代わりに、Overflow ノードが表示されます。残りの参照を表示するには、このノードをダブルクリックします。

以下の GIF は、Overflow ノードが使用されている状況を示しています。

Reference Viewer のキーボード ショートカット