ReferenceGraph v1.0 Guide Jp
1 ReferenceGraph
ReferenceGraphはAssetの参照をグラフに視覚化します。 AssetのReference、AssetのDependencyを簡単かつ迅速に確認することができます。
2 ReferenceGraph 使い方
2.1 Asset Popup Menu
Project WindowでAssetを選択した後、マウス右クリックでメニューポップアップを開いて、「Reference Graph」を選択します。
2.2 Unity Menu
Project WindowでAssetを選択し、UnityのメニューからAssets> Reference Graphを選択します。
2.3 ショートカット
Project WindowでAssetを選択し、ショートカットCtrl + Shift + Rを入力します。
2.4 Graph状態での実行
ReferenceGraph Windowが浮かべた状態でNodeを選択すると、Nodeが指すAssetが自動的に選択されます。その状態で、ショートカットCtrl + Shift + Rを入力すると、すぐにAssetのReferenceを参照することができます。
3 Reference Graphが浮かべられている状態
Reference Graph Windowが実行されるたびに、すべてのAssetを確認します。すべてのAssetを確認する理由は以下の通りです。 UnityはAssetのDependencyを見つけてくれるAPIはサポートしますがAssetのReferenceを見つけてくれるAPIはサポートしていません。 ReferenceGraphは、すべてのAssetのDependencyを利用してAssetのReferenceを検索します。 したがって、Reference GraphはReferenceGraph Windowを実行するたびに、すべてのAssetのDependencyを確認します。
ReferenceGraphがすでに実行されている状態で、Assetを選択した後ReferenceGraphを実行すると、すでにScanされたDependencyを基準にReferenceGraphを更新します。
AssetのReferenceの変更がない場合は、ReferenceGraph Windowを浮かせた状態で使用されることをお勧めします。
4 Aync Load / Sync Load
ReferenceGraph Windowが浮かべるとき、Scanボタンを押したとき、ReferenceGraphはすべてAssetのDependencyをキャッシュします。Scan作業の方法を同期と非同期で選択することができます。 Importされたpackageの"ReferenceGraphSetting" Assetを検索して選択するとInspector windowで確認することができます。またはReferenceGraph Windowの右上のSettingボタンをクリックします。
初期設定はTrue、非同期方式を使用します。
非同期方式の特性上、同期方式よりも時間がかかります。
非同期方式の利点は、進行状況を確認することができ、途中で中断することができます。
最初に実行された場合には、かかる時間を確認するために、非同期方式をお勧めします。
5 ReferenceGraph Window UI
5.1 Reference Limit / Dependency Limit
選択されたAssetのReferenceとDependencyをGraphに示すときDepthのLimitを設定します。
値を変更する場合Nodeが制限されて表示されます。AssetのReferenceを検索するときに、最大Depth値だけSliderが設定されます。
5.2 Re Scan
すべてのAssetのDependencyをキャッシュしてGraphを再構成します。最初のReferenceGraphを浮かせるときに実行するロジックと同じです。AssetのReferenceが変更されるときに実行することをお勧めします。
5.3 Alignment
Nodeの位置をソートし、Root Nodeを中央に合わせます。次のような状況で機能を使用することをお勧めします。
- Nodeの位置を初期化したいとき
- RootNodeをWindowの中央に設定したいとき
- NodeのStyle設定を適用したいとき
5.4 Setting
ReferenceGraphの様々なオプションを設定することができる「ReferenceGraphSetting」Assetを選択します。 Project Windowで見つけるよりも便利です。
5.5 Scroll
ReferenceGraphSettingで「IsUseScrollbar」がTrueのときだけ表示されます。
GraphでVerticalの最上段のNodeと最下段のNodeを基準にScrollが生成されます。
ReferenceGraphは、主にNodeがVertical基準に多く生成されるためGraphのクイックナビゲーションのために提供される機能です。
5.6 Root Node / Node
選択されたAssetのGraphを構成するときに、選択したAssetを指すNodeをRootNodeと言います。
それぞれAssetを指すBoxをNodeと呼びます。
Nodeは線でつながっていて、これはAssetのReference/ Dependencyを表します。
RootNodeは動くことができないが、その他のNodeは、位置を移動させることができます。
NodeはAssetの名前、AssetのIconまたはThumbnailを表示します。
5.7 同じAssetを指すNodeの数
同じAssetをReference/ DependencyするAssetがあります。Graphから1つのAssetを指すNodeは、複数の可能性があります。 一つのAssetを指すNodeがGraph上に複数の場合はNode右下に数を表示します。
5.8 Root Asset / Select Asset
RootNodeが指すAssetのパスと、選択したNodeが指すAssetのパスを表示します。
5.9 Zoom
現在Graphの拡大比率を表示します。拡大縮小は100％〜5％まで可能です。
マウスホイールを使用して、拡大縮小をすることができます。拡大縮小は、マウスポインタの位置を中心に拡大縮小されます。
6 Nodeの位置を移動
Nodeの位置を移動することができます。
Nodeの位置を移動するためには、ReferenceGraphSettingでIsDragAble NodeがTrueに設定されている必要があります。
GraphでNodeを選択した後、マウスでDragをするとNodeが移動します。
RootNode基準に左Nodeは、そのNodeのすべてのReference Nodeの位置が一緒に移動します。
RootNode基準に右Nodeは、そのNodeのすべてのDependency Nodeの位置が一緒に移動します。 RootNodeは移動できません。
一つのNodeだけ別に位置を移動したい場合は、Ctrlキーを押しながらDragを実行すると、選択されたNodeの位置だけ移動します。
7 ReferenceGraphSetting
7.1 Is Use Aync Load
<参考>4 Aync Load/ Sync Load
7.2 Is Drag Able Node
<参考> 6 Nodeの位置を移動
7.3 Is Use Scrollbar
<参考> 5.5 Scroll
7.4 Thumbnail Load Option
GraphでNodeはAssetのThumbnailを表示します。Thumbnailを表示するためには、AssetをLoadする必要があります。すべてのNodeのThumbnailを表示するためには時間がかかります。
また、 また、Texture以外のAssetの場合ThumnailはAssetのIconを表示するので、不必要なLoad時間を使っています。
NodeのThumbnailのLoad方式を設定することができます。
-All : Graphに表示されているすべてのNodeのThumbnailをLoadします。Node数が多い場合は、多くの時間がかかる場合があります。お勧めしません。
-Texture : Graphに表示されているNodeがTextureに該当するAssetだけThumbnailをLoadします。Textureの場合、プレビューがサポートされてIconではなく、そのTextureを見られます。
デフォルトの設定値であり、お勧めします。
-Nothing : Graphに表示されているすべてのNodeのThumbnailは拡張子によるiconに表示します。
最も少ない時間がかかるオプションです。
7.4.1 拡張子によるThumbnail Icon
Thumbnail Load OptionをTexture、Nothingに設定した場合、拡張子によるThumbnailをIconイメージで表示します このIconイメージはSTUDIO SSUN\ReferenceGraph\Editor\UI\Thumbnail のパスにあります。 拡張子と同じ名前のImageを表示され、同じ拡張子のImageがない場合は「default」の名前のImageを表示するようになります。
Imageを追加または変更して使用することができます。
7.5 Node Graph Style
Graphに表示されるNodeの大きさと間隔を設定することができます。設定後、適用するには、Algnment機能を実行します。
7.5.1 Node Width
NodeのWidthを設定します。
7.5.2 Node Height
NodeのHeightを設定します。それに応じてThumbnailのサイズも変更されます。一定以下の場合Thumbnailを描かない。
7.5.3 Node Horizontal Spacing
左右のNodeとNode間の間隔を設定します。
7.5.4 Node Vertical Spacing
上下のNodeとNode間の間隔を設定します。
7.6 Folder Colors
Nodeの背景色を変更します。Nodeが指すAssetのPathを基準に設定します。
7.6.1 Folder Name
条件がされるStringです。Pathにstringが含まれていたら該当します。
例は下記の通りです。
Prefab
/Prefab/
.mat
7.6.2 Background Color
条件に該当する場合、適用されるNodeの色です。Alphaが0に適用されると、Nodeが見えないから注意してください。
7.6.3 Text Color
条件に該当する場合、適用されるNodeが指すAssetの名前の色です。Alphaが0に適用されると、Textが見えないから注意してください。