.uasset のプレビューと差分

Unreal Engine のアセットファイル（.uasset）はバイナリ形式で保存されます。通常のテキストエディタやバージョン管理ツールでは中身を確認できませんが、Textil はアセットの内部構造を解析し、プレビューと差分表示を提供します。

Textil はアセットファイルから以下の情報を抽出します：

• Export 構造: アセット内のオブジェクト（ルート、コンポーネント、CDO など）
• プロパティ値: 各オブジェクトが持つプロパティの値
• Import 参照: 他のアセットへの依存関係

.uasset プレビュー

プレビュー機能では、単一の .uasset ファイルの内容を確認できます。Unreal Editor を起動せずに、アセットの構造やプロパティ値を素早く確認したい場合に便利です。

プロパティツリービュー

アセットのプロパティ構造を階層的に表示します。

• Export オブジェクトごとにプロパティをツリー表示
• 配列やネストした構造体も展開して確認可能
• 検索機能でプロパティ名や値をフィルタリング

グラフビュー

Blueprint や Material などのノードベースアセットでは、グラフビューでノード構造を確認できます。

• ノードと接続を視覚的に表示
• Blueprint では EventGraph、ConstructionScript など複数のグラフをタブで切り替え
• ズーム・パンで詳細を確認

対応アセットタイプ

アセットタイプ	表示内容
Blueprint	EventGraph、ConstructionScript などのノードグラフ
Material	シェーダーグラフのノード構造
Material Instance	パラメータオーバーライド値
Texture	テクスチャ設定、MIP レベルなどのメタデータ
DataTable	行・列形式でのデータ表示
Level	アクター一覧とプロパティ

上記以外のアセットタイプでも、プロパティツリービューで汎用的に内容を確認できます。

.uasset 差分

差分機能では、2つのバージョン間の変更内容を比較できます。従来のバージョン管理では「バイナリファイルが変更された」としか分からなかった .uasset の変更が、どのプロパティがどう変わったのか一目で確認できます。

プロパティツリービュー

プロパティ構造を階層的に表示し、変更箇所をハイライトします。

• 追加されたプロパティ: 緑色でハイライト
• 削除されたプロパティ: 赤色でハイライト
• 変更されたプロパティ: 黄色でハイライト、変更前後の値を並べて表示

変更のあるノードは自動的に展開され、未変更のノードは折りたたまれた状態で表示されます。「変更のみ表示」フィルターを有効にすると、変更のないプロパティを非表示にできます。

グラフビュー

Blueprint や Material などのノードベースアセットでは、グラフビューで変更を確認できます。

• 左右分割 または 上下分割 で変更前後を並べて表示
• 変更されたノード・エッジをハイライト

差分レベルフィルター

グラフビューでは、変更の重要度に応じてフィルタリングできます：

レベル	表示される変更
Logic	ロジックに影響する変更のみ（ノードの追加・削除、接続の変更、ピン構成の変更）
Layout	Logic + 位置・サイズの変更
Visual	すべての変更（色などの視覚的変更を含む）

デフォルトは Logic レベルで、ロジックに影響しない見た目だけの変更は非表示になります。

変更箇所のナビゲーション

差分ビューでは、変更箇所を効率的に確認するためのナビゲーション機能があります：

• 前の変更 / 次の変更 ボタンで変更箇所を順番に移動
• 現在位置の変更箇所がハイライト表示
• 変更箇所に自動スクロール

差分コンテキスト

差分表示は以下のコンテキストで利用できます：

コンテキスト	比較対象
Staged	HEAD と ステージング済みの変更
Unstaged	ステージング済み（または HEAD）と 作業ツリー
Worktree	HEAD と 作業ツリー全体
Commit	指定したコミットとの比較

ファイル一覧で表示されるステータスに応じて、適切なコンテキストが自動的に選択されます。