TTT Island Type Expand

画像とUVの2D表示から選択できる TTT UV Island Selector を追加するUnityパッケージです。 マスク画像ファイルやTexture2Dアセットは生成しません。Renderer参照、サブメッシュ番号、選択した島のUV形状の識別情報だけをScene / Prefabに保存します。

動作対象

• Unity 2022.3（検証環境: 2022.3.22f1）
• TexTransTool 1.1.0-beta.9
• TexTransCore 0.3.0-beta.2

このプロジェクトの Packages/com.gokoukotori.ttt-island-type-expand が拡張本体です。 TTT本体のソースは変更せず、RuntimeとEditorの.asmrefを使用してTTTの既存アセンブリへコードを組み込みます。 TTTの公開拡張APIではなく内部実装に依存します。対応版以外ではInspectorに警告を表示し、選択を適用しません。ただし、内部APIが変わった場合はコンパイル自体が失敗し得るため、更新時には対応確認が必要です。

使い方

1. アバター内のGameObjectに TexTransTool > IslandSelector > TTT UV Island Selector を追加します。
2. Inspectorの「画像・UVから島を選択」を押します。
3. 対象Rendererとサブメッシュを選びます。対象マテリアルのメインテクスチャを背景に表示します。
4. UV島をクリックして確定します。Ctrl / Shift + クリックで追加・解除、ホイールで拡大、中ボタンのドラッグで移動します。島一覧でも選択できます。
5. TTTの対象レイヤーのマスク種類を IslandSelectAsLayerMask にし、このSelectorを割り当てます。必要に応じて MaskPadding を調整します。

SimpleDecalなどのIslandSelector欄でも使用できます。複数Renderer / サブメッシュをまとめる場合はSelectorをそれぞれ作り、TTTの IslandSelectorOR で組み合わせてください。 選択結果のScene / Prefab保存は通常のUnityの保存操作で行います。

選択と制限

• 初期版は UV0 を使用します。対象処理も同じUVを使う前提です。
• Rendererやサブメッシュの候補切替、画像表示のON/OFFだけでは保存済みの選択を書き換えません。島のクリック、一覧の切替、全選択、選択解除で確定します。Undo / Redoに対応します。
• 島の分割はTexTransCoreの規則と同じです。同一UV座標の頂点でつながった面は一つの島です。重複UVの左右を別々に選ぶ機能ではありません。
• 別の島がクリック位置に重なる場合は候補メニューを表示します。画像マスクでは、同じ画像の同じUV位置を使う面を区別できません。
• UV形状のSHA-256を保存します。頂点番号、三角形の並び、面の向きの変更には依存しません。UV座標、三角形構成、サブメッシュ構成が変わる場合は再選択が必要です。見つからない島は別の島へ自動的に置換しません。
• 3Dポーズ / BlendShapeの変化だけでは選択は変わりません。ビルド中のRenderer参照対応にはTTTの OriginalObjectEquals を使用します。Mesh統合やUV変更を先行させる処理との一般的な互換性は保証しません。
• テクスチャのTiling / Offsetや独自シェーダーのUV変換は2D背景表示に反映しません。背景画像は選択を補助する表示です。
• マスクはTTTの既存機能がプレビュー / ビルド時に一時生成します。TTTが生成する最終的な合成テクスチャは通常どおり必要です。