TexTransTool Poiyomi Support

TexTransTool (TTT) の AtlasTexture に、Poiyomi Toon / Pro シェーダーのテクスチャ UV 使用情報を提供する拡張パッケージです。

何が解決されるか

TTT の AtlasTexture は「どのテクスチャプロパティがどの UV チャンネルでサンプルされるか」というシェーダーごとの情報を使い、アトラス化するテクスチャを決定します。標準対応は lilToon / Standard / VRChat SDK シェーダーのみで、Poiyomi マテリアルはフォールバック (_MainTex のみ UV0 扱い) になります。その結果、アルファマップ・マットキャップマスク・ノーマルマップなどがアトラス化されず、UV 再配置後に元テクスチャの想定外の場所を参照する症状が発生します。

本パッケージは Poiyomi の命名規約 (_X / _XUV / _X_ST) に基づき、シェーダーの全テクスチャスロット (約 150) を動的に分類して TTT に登録します:

分類例扱い
_XUV セレクタ持ち_MainTex, _AlphaMask, _MatcapMask, _EmissionMap など大半セレクタ値 UV0〜UV3 に応じて登録。Panosphere / World Pos / Polar / Distorted / Local Pos / Matcap モードは対象外
UV0 固定サンプル_MetallicGlossMap, _SmoothnessTex, _ReflectionColorTex, _ParallaxInternalMap常に UV0 として登録
命名例外_FlipbookMask1 (→ _FlipbookMaskUV1), _PoiSkinDetailMap (→ _PoiSkinFreckleMapUV)例外テーブルで対応
メッシュ UV でないスロット_Matcap〜_Matcap4, _ToonRamp, _ClothDFG, _SkinLUT, _GlitterTexture などアトラス化対象外 (元テクスチャ維持)
Cube / 3D / 2DArray_CubeMap, _FlipbookTexArray など次元判定で自動的に対象外
判定不能な未知スロット(将来の Poiyomi の新機能など)安全側に倒して対象外 + 警告ログ

テクスチャスロットはシェーダーのプロパティから動的に列挙するため、Poiyomi のバージョン (9.x / 10.x, Toon / Pro) に依存しません。Thry Optimizer でロックされたシェーダー (Hidden/Locked/.poiyomi/*) も Properties ブロックが保持されるためそのまま動作し、マテリアルのロックでセッション中に新しく生成されたシェーダーもインポート時に自動登録されます。

対応状況

  • Poiyomi Toon / Pro 9.3 / 10.0 系のシェーダーソース解析に基づく (例外テーブルは両系列で同一)
  • ロック済みシェーダー対応
  • TexTransTool 1.0 系 (TTShaderTextureUsageInformationRegistry API)

既知の制限

  • Tiling / Offset (_ST): TTT の AtlasTexture 自体がテクスチャの Tiling / Offset を考慮しないため、1 以外のタイリングを持つスロットはアトラス化後にずれます (本パッケージでは解決できません)
  • UV 空間内の座標指定を持つ機能: デカールの Position / Rotation / Scale、フリップブックの配置指定などは、アトラス化で UV レイアウトが変わると座標がずれます。デフォルト配置 (UV 全面) のみ正しく動作します
  • パンニング (_XPan): アトラス化後のアイランド再配置と干渉する場合があります
  • Thry Optimizer の「アニメートされたプロパティのリネーム」で _XUV がリネームされた場合、そのスロットは既定 (UV0) と見なされます

インストール

  1. VCC (VRChat Creator Companion) または ALCOM に以下の VPM リポジトリを追加します:

    https://rroki-0u0.github.io/vpm-repos/index.json

    Add to VCC

  2. 依存パッケージの TexTransTool のリポジトリ (https://vpm.rs64.net/vpm.json) も追加されていることを確認します。

  3. プロジェクトに TexTransTool Poiyomi Support を追加します。

ライセンス

MIT

パッケージ名

jp.rroki.ttt-poiyomi-support

ドキュメント

https://github.com/rroki-0u0/vpm-repos

リポジトリ

バージョン

0.1.0

Unityバージョン

2022.3 以降

依存関係

なし

VPM依存関係

旧パッケージ

なし

ライセンス

MIT

作者

rroki-0u0

リポジトリ内のパッケージJSON

{
  "name": "jp.rroki.ttt-poiyomi-support",
  "displayName": "TexTransTool Poiyomi Support",
  "version": "0.1.0",
  "unity": "2022.3",
  "description": "Provides Poiyomi Toon/Pro texture UV usage information to TexTransTool's AtlasTexture so that all texture slots (alpha maps, matcap masks, etc.) are atlased correctly. Locked shaders are supported.",
  "license": "MIT",
  "author": {
    "name": "rroki-0u0",
    "url": "https://github.com/rroki-0u0"
  },
  "repo": "https://rroki-0u0.github.io/vpm-repos/index.json",
  "documentationUrl": "https://github.com/rroki-0u0/vpm-repos",
  "vpmDependencies": {
    "net.rs64.tex-trans-tool": "^1.0.0"
  },
  "url": "https://github.com/rroki-0u0/vpm-repos/releases/download/jp.rroki.ttt-poiyomi-support-v0.1.0/jp.rroki.ttt-poiyomi-support-0.1.0.zip",
  "zipSHA256": "8761635d4f0dd20532258c651df07609b812622435928595a694b1b3177b28b8"
}