# Ep.2 — リファレンスの追加・削除（Add / Remove と信号機ファイル状態チェック）

https://youtu.be/-j6lYvfwz8U?si=3xzlrhYGPfVZPImV

> **要約**：リグファイルをコピーしてシーンに貼り付けるのはやめましょう。Fast-Ref の **Add** でクリーンにリンクするだけにして、シーンデータに影響なく **Remove** で外すことができます。リグファイルの状態は **緑・黄・X** の信号機カラーで 5 分ごとにリアルタイム更新されます。

---

## 1. Maya のリファレンスのように管理する

Fast-Ref の基本コンセプトは、複雑なセットアップなしに Maya の直感的な参照メカニズムを 3ds Max へ完璧に移植することです。
外部ファイルとの**「リンク関係」**だけを作成し、シーンファイルを極めて軽量に保ちながら、シーン内のあらゆる状態変更を専用のテーブルビューで簡単に制御します。

---

## 2. Add — リファレンスの登録

Fast-Ref UI を開き、元のリグフォルダ内の `.max` マスターファイル（例：`master_mable.max`）を選択して **Add** ボタンを押すと、テーブルに登録されます。

### 📊 スロット登録時に即座に有効になる操作ボタン
- 🟢 **緑マーク**：ディスク上のファイルパスが有効で、開いているシーンが**最新の完璧なリグ状態**を参照していることを示します。
- 👁️ **Visibility（表示 on/off）**：該当リファレンスを画面で非表示または表示します。1 つのシーンにキャラクターが 3〜4 人以上登場してビューポートが重くなるときに便利です。
- ❄️ **Freeze（凍結）**：誤ってキャラクターをドラッグしてビューポートで動かしてしまうミスを防ぐ、ワンクリック固定モードです。
- 🎯 **Selection helper（選択補助）**：そのリファレンスに属する複雑なリグボーン構造をワンクリックですべて一括選択します。

---

## 3. リガーがリグを修正したとき（黄色の警告ライト）

ネットワークドライブ上で作業中にリガーがリグのスキンやメッシュを修正してマスターファイルに配布したら、どうなるでしょうか？
アニメーターがリガーに「修正しましたか？」と手動で聞く必要はまったくありません。Fast-Ref テーブルのマークがすぐに **🟡 黄色**に変わります。
> **「ディスク上のファイルのタイムスタンプが最近更新されました。アニメーターさん、このシーンは古いバージョン基準です！」** という親切な警告です。

このとき選択肢は 2 つです。
1. **Reload**：ファイルパスはそのままに、ディスクに新しく上書きされた最新リグファイルの内容でシーン内のリグ構造だけを安全にリフレッシュします。
2. **Replace**：リガーが完全に別のパスに新しいファイルを作成した場合、新しいファイルパスを指定して骨格を交換します。

---

## 4. Remove — リファレンスの削除

シーンからキャラクターを除外したり不要になったりしたとき、**Remove** ボタンを押します。
従来の 3ds Max では XRef などを削除する際、ノードが絡まっていたり空のダミーノードが残骸として残り、シーンが徐々に汚染されるという慢性的な問題がありました。
しかし Fast-Ref は、**残骸ノードやスキニングデータ汚染を一切残さず、最初からなかったかのようにシーンを純粋な状態に復元**して削除します。

---

## 5. リアルタイム信号機状態検査システム（5 分検査周期）

Fast-Ref の最も賢い特徴のひとつが、バックグラウンド検知周期です。
- **ツール起動の瞬間**、すべてのスロットのディスクファイルタイムスタンプとパス状態を確認して状態を更新します。
- 作業中も**約 5 分間隔**でバックグラウンドが静かにマスターリグファイルの変更有無を自動確認します。

これにより、複数のチームメンバーが同時に協業する緊迫した実務環境でも、現在作業中のシーンが正しいパスを参照しており最新データ状態かどうかを、いつでも確実にモニタリングできます。

---

## 🚫 重要な注意事項とまとめ
- **すでに Fast-Ref としてシーンに読み込まれているファイル**を再度強制 Add しようとしたり、絡まった接続状態を放置したりすると衝突のリスクがあります。エラーを事前にフィルタリングしてくれるプラグインの親切なポップアップを必ず確認してください。
- すべてのアニメーション作業の始まりは、テーブル上部の **🟢 緑ライト**を確認することです。