# Ep.4 — Unpack（パッケージ構造の解除と他ツール互換性）

https://youtu.be/Jaii390A0Nw?si=2n7U_mVournDJH9X

> **要約**：Fast-Ref はシーンの安定性のためにリファレンスデータを仮想の安全パッケージでラップして管理します。社内レガシースクリプトや外部プラグインがこれを認識できない場合は、**Unpack** を有効にして純粋な元のシーン構造に一時展開するだけで解決します。

---

## 1. Fast-Ref の内部パッケージングメカニズムを理解する

シーン内のリファレンスデータが劣化したり、3ds Max 自体のガベージコレクション中に失われたりするのを防ぐため、Fast-Ref はデータを特殊にパッケージング（仮想のフェンス内に保管）して管理します。
一般的なアニメーション作業、ビューポート操作、キーフレーミングの大半は **Unpack に一切触れずデフォルト状態で完璧に動作**します。

---

## 2. Unpack がいつ、なぜ必要なのか

プロダクション環境には、多数の社内開発プラグイン・特定のフレームワークスクリプト・特殊なレガシーエクスポーターなどが混在しています。これらのツールは「通常の 3ds Max シーングラフノード」しか直接読み取れないようにハードコードされている場合が多いです。

このとき、Fast-Ref の特殊パッケージングフェンスを読み取れず外部ツールでエラーが発生したり、キャラクターが選択できなかったりする互換性問題が生じる可能性があります。このタイミングで **Unpack On** スイッチを使います。

- **Unpack を有効にすると**：Fast-Ref の安全フェンス内に隠れてラップされていたノードが **オリジナルファイルの純粋な 3ds Max ノード状態に完全展開され、シーンレベルに開かれます。**
- **管理は引き続き維持**：驚くことに、ノードが通常オブジェクトのようにシーン上に露出しても、**Fast-Ref テーブルは内部で「どのファイルと接続していて、誰の Namespace か」という所有リンクを完璧にトラッキングし続けます。**

---

## 3. Namespace と Unpack オプションの相関関係

スタジオのパイプライン制約に応じて、アーティストは以下の 3 つの核心設定軸を適切に行き来する必要があります。

1. **Namespace On**：マルチキャラクター配置時は絶対にオンにして作業するのが安全です。
2. **Namespace Off**：社内の他の専用ツールがコロン接頭辞（`:`）をまったく解釈できない場合にオフにします。（この場合ノード名が統一されるため、マルチキャラクター交換時は注意が必要です。）
3. **Unpack On**：仮想パッケージ構造を剥がして、外部レガシーツールが骨格とコントローラーを自由に解析できるよう扉を全開にする状態です。

---

## 💡 実務ガイドライン まとめ
- 通常の作業や純粋な Fast-Ref ベースのパイプラインなら **Unpack Off が最も安定**なのでそのままにします。
- 会社専用の「検査ツール」や「エクスポートエンジンプラグイン」がノードを見つけられず悲鳴を上げたときだけ、**Unpack On** をオンにして互換性の橋をかけてあげると解決します。

<!-- [REVIEW: legacy image - verify placement context] -->
![Unpack 기능 스크린샷](image.png)