3D依存関係インスペクター

このアセットは完全か、そして無駄がないか

これは2つの別々の問いであり、どちらもバリデーターでは答えが出ません。glTFファイルは、同じテクスチャの複製を12個抱え、どこからも参照されないマテリアルを40個持ち、納品物に含まれていない .bin ファイルを指していても、仕様上は完全に有効でありえます。

この依存関係インスペクターは、その両方に答えます。

3つの失敗パターン

リソースの欠落

.gltf は自己完結したファイルではありません。.bin バッファや画像ファイルを指しており、それらは一緒に運ばれる必要があります。誰かが違うフォルダをZIPにまとめてしまうと、エラーもなく読み込まれるのに何も描画されない、あるいはテクスチャのないグレーのモデルができあがります。

インスペクターは、参照されているのに存在しないリソースをすべて名前付きで一覧表示します。関連ファイルを渡せばそれらと突き合わせて再チェックするので、クライアントに転送する前に納品物が揃っているか確認できます。

未使用データ

エクスポーターは多くのものを残していきます。削除済みオブジェクトのマテリアル、誰も読まないアクセサ、子もメッシュも持たないノード、あとで解除されたスロットに割り当てられたテクスチャ。どれも描画されません。それでも全部ダウンロードされます。

このツールは推測するのではなく、ドキュメントを複製して正式な到達可能性の解析を行い、その差分を報告します。つまり「削除可能」とは、疑わしいという意味ではなく、本当に未参照であるという意味です。

テクスチャの重複

これは見落としやすく、抱え続けるとコストになります。複数のソースからモデルを組み上げると、同じ画像が別名で何度も埋め込まれることがよくあります。インスペクターはファイル名ではなく実際の画像バイト列を比較します。そのため、内容が同一の wood.png と wood_1.png は「二重に格納された1つのテクスチャ」として正しく判定され、たまたま名前が同じだけの別々のテクスチャが誤検出されることもありません。

重複グループごとに、何バイトが無駄になっているかを表示します。

本当に重要な数字

以上のすべては、1つの数値に集約されます。削減可能サイズです。これは現状のファイルと、重複排除と不要データの削除を行ったあとのファイルとの差分です。整理を実行すべきかどうかの、誠実な判断材料になります。もしゼロと表示されたなら、そのアセットはすでに十分整っており、気にする必要はありません。

「未使用」についての注意点

未参照であることは、必ずしも削除してよいという意味ではありません。アプリケーションが実行時にノードを名前で検索し、そこに何かをアタッチすることもあります。その場合、そのノードはシーングラフからは到達できませんが、まったく無用ではありません。削除する前に一覧を読み、思い込みで進めないでください。

プライバシー

監査はすべてブラウザ内で行われます。アップロードが発生しないため、クライアントへの納品物や未発表アセットにも安心して使えます。