ReferenceGraph v1.0 Guide Jp

Readme_jp.pdf

0.40MB

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が見えないから注意してください。