Skip to content

カスタム補正: トラッキングキーに割り当てられないシェイプをCustom式で動かす - #54

Merged
limit7412 merged 1 commit into
masterfrom
custom-correction-rules
Nov 13, 2026
Merged

limit7412 merged 1 commit into
masterfrom
custom-correction-rules

Conversation

@limit7412

Copy link
Copy Markdown
Owner

背景

顔メッシュには、トラッキングキーに1対1で割り当てられないシェイプが入っていることがある。2つのキーが同時に立ったときだけ使う組み合わせ補正用のシェイプや、1つのキーの値に応じて順に立てる段階用のシェイプである。
Blendshapes Setはキー1つにシェイプ1つを結ぶだけなので、こうしたシェイプはネイティブFTでは動かない。

実例として、OSC版のFTアドオンを入れたアバターをネイティブFTへ移したところ、口を開けたまま舌を出すと舌が下唇を突き抜けた。
このメッシュは JawOpen が舌を顎と一緒に下げて奥へ引き、それを打ち消すシェイプ TongueJawCorrection を旧FXが JawOpen に比例させて立てる作りだった。ネイティブFTではこのシェイプがどのキーにも当たらず、常に0になっていた。
形状データ上で舌と下唇の三角形の交差を数えると、TongueOut=1 のとき補正なしでは JawOpen 0.25〜1 で46〜64組、補正を JawOpen と同じ値にすると0組だった。

変更内容

コンポーネントにカスタム補正の一覧(シェイプ名、反映方法、Custom式)を足し、組み込みの規則と同じParameter Behaviorとして生成する。特定のアドオンやアバターの知識は本体に持たせていない。

  • Runtime/Settings/CustomCorrectionSettings.cs: 設定の型。一覧の初期化子は空で、保存済みのコンポーネントの挙動は変わらない
  • Editor/Domain/CustomCorrection.cs: 一覧を規則へ変換する。無効な項目は外し、シェイプ名が空・式に誤りのある項目は規則にせず問題として返す
  • Editor/Domain/CorrectionPlanner.cs: 規則の対象をシェイプ名でも指せるようにした
    • ゲートは FT ∧ 式が読むキーの側のトグル(KxNFTM/Gate/Custom/...)。エミュレーション・制限・Eye Syncのトグルには従わない
    • 規則表より前に並べるので、命令数が上限を超えるときは組み込みの規則から先に落ちる
    • 対象のシェイプがFace Tracking Meshに無い項目は生成しない
  • 警告を2つ足した。W-22(対象のシェイプが無い)、W-23(シェイプ名が空か式に誤りがある)
  • インスペクタの「表情補正」の下に一覧を足した。項目ごとに式の命令数か、生成されない理由を出す
  • Documentation~/settings(.en).md と build(.en).md に説明を足した

ビルド・テスト結果

  • Unityを起動せず、既存のUnityプロジェクトの参照DLLを使って Runtime Editor Tests の3アセンブリをdotnetでコンパイルした。エラーなし
  • 同じ方法で、Unity APIに依存しないDomainのテスト124件を実行した。すべて通過(新規の CustomCorrectionTests 12件を含む)
  • Unity APIに依存するテスト(LocalizationTests など)は手元では未実行。poのキーが日英で一致することだけスクリプトで確かめた。このPRのCIで確認する

未確認の点

  • どのSetにも入っていないシェイプへの ApplyToBlendshape がVRChat上で働くか。既存のEye SyncはSetに入っているシェイプへ書いており、Set外のシェイプへ書く例はこれが初めてになる。働かない場合はこの機能全体が成立しないので、マージ前に実機で確かめたい
  • インスペクタの一覧のレイアウトは、Unity上で一度も表示していない
  • FXのアニメーションが同じシェイプへ書いているときの優先関係

このPRに含めないもの

式を書かずに済むテンプレート(組み合わせ補正・段階・応答カーブ)、どのキーにも割り当てられていないFT用シェイプの警告、エディタ内でのプレビュー、規則一式を共有する資産。シェイプ名は手入力で、候補から選ぶUIも無い。

🤖 Generated with Claude Code

顔メッシュには、2つのキーが同時に立ったときだけ使う組み合わせ補正用のシェイプや、
1つのキーの値に応じて順に立てる段階用のシェイプが入っていることがある。
Blendshapes Setはキー1つにシェイプ1つを結ぶだけなので、こうしたシェイプはネイティブFTでは動かず、
口を開けたまま舌を出すと舌が下唇を突き抜ける、といった崩れになっていた。

コンポーネントにカスタム補正の一覧(シェイプ名、反映方法、Custom式)を足し、
組み込みの規則と同じParameter Behaviorとして生成する。

- ゲートは FT ∧ 式が読むキーの側のトグル。エミュレーション・制限・Eye Syncのトグルには従わない
- 命令数の予算では組み込みの規則より前に並べ、上限を超えるときは組み込みから先に落とす
- シェイプ名が空・式に誤りのある項目はW-23、対象のシェイプがFace Tracking Meshに無い項目はW-22で知らせる
- インスペクタの一覧には、項目ごとに式の命令数か作られない理由を出す

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Nov 13, 2026 •

Copy link
Copy Markdown
Codex Review Summary: ✅ Completed

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-11-13T12:33:35.309280Z 6e3085a PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@limit7412
limit7412 merged commit 102659f into master Nov 13, 2026
8 checks passed
@limit7412
limit7412 deleted the custom-correction-rules branch November 13, 2026 12:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant