Blender モーション状態検査

Blender モーション状態検査 は何をしますか？

使用時

• Blender のキャラクターがアニメーション中にねじれたり、反転したり、扁平化したり、オフセットしたり、足が滑っているように見える場合。
• インポートしたアバター、アーマチュア、またはリターゲットしたモーションが期待通りのポーズと一致するかどうかをユーザーが尋ねた場合。
• レンダリング結果と、ボーン、バウンディングボックス、コンタクト、向きベクトルなどの構造化された事実を比較する必要がある場合。
• ワークフローが、モデルがキャラクター、プロップ、プロキシメッシュ、コントロールリグ、または壊れたインポートのいずれであるかを判断することに依存している場合。

核となる原則

アニメーション付きの3Dアセットをスクリーンショットだけで判断しないでください。スクリーンショットは確認のための証拠にはなりますが、軸の規則、ボーン名、オブジェクトスケール、ローカルトランスフォーム、ペアレント化されたメッシュ、マテリアルスロット、フレームごとの接触状態を隠してしまいます。

最初に Blender から構造化された状態を抽出し、次にビューポートのスクリーンショットやレンダリングを使用して、事実が示唆する内容を確認します。

仕組み

1. アセットを判断する前に、クリーンなシーンとアセットのベースラインを確立します。
2. エクスポーターまたは Blender 自身のインタプリタ内で実行する Blender Python を使用して、Blender から構造化された事実を抽出します。
3. コンタクト、向き、スケール、リターゲットエラーが最も発生しやすいと思われるフレームをサンプリングします。
4. 測定された事実を、ユーザーの期待するポーズ、方向、地面、レンダリング目標と比較します。
5. 確認された事実、推定される原因、必要な修正を分けた簡潔なレポートを返します。

検査ワークフロー

1. シーンを棚卸しする。

   • メッシュ、アーマチュア、エンプティ、カメラ、ライト、モディファイア、ペアレント関係、非表示オブジェクトをリストアップする。
   • アバターを判断する前に、キャラクターメッシュをヘルパー/プロキシジオメトリから分離する。
   • オブジェクト空間とワールド空間のバウンディングボックスを記録する。

2. スケルトンを特定する。

   • アーマチュア名、ポーズボーン、ボーンのヘッド/テール、ロール、ペアレントチェーン、コンストレイント、レストポーズの軸を取得する。
   • 腰、背骨、首、頭、肩、肘、手、太もも、膝、足首、足などの意味的なボーンをマッピングする。
   • 左右のペアの欠落や異常な命名規則にフラグを立てる。

3. 前方、上、側面の軸を決定する。

   • 骨盤、背骨、肩、腰、頭、足を一緒に使用し、単一のメッシュ法線に依存しない。
   • ローカルのアーマチュア軸をワールド軸および glTF の Y-up と Blender の Z-up のようなインポートファイルの規則と比較する。
   • 顔/頭/足の方向がルートモーションと矛盾する場合、反転または逆方向のインポートの可能性をマークする。

4. アニメーションフレームをサンプリングする。

   • 最初のフレーム、中間フレーム、接地フレーム、空中フレーム、極端なフレームを検査する。
   • ルートの位置、ルートの方位、骨盤の高さ、体幹の傾き、手足の方向、足のクリアランス、メッシュの範囲を記録する。
   • 長いまたは速いモーションの場合は、反転、着地、方向転換、衝突、床との接触付近でより密にサンプリングする。

5. リターゲットの問題を疑う前に、モデルの整合性を確認する。

   • アニメーションを適用する前に、クリーンなベースライン形状を確認する。
   • ユーザーが明示的に修復を要求しない限り、元のメッシュ、マテリアル、アーマチュア、スキニングを保持する。
   • 説明のつかない球状の塊、巨大なプロキシメッシュ、または押しつぶされたボディは、反証がない限りインポート/選択の問題として扱う。

6. 接触とモーションの問題を診断する。

   • 地面への貫通：各フレームの最も低い足または靴の頂点と床の高さを比較する。
   • 足の滑り：接地したフレーム間での足のワールド位置を比較する。
   • 脚の交差：左右の太もも、膝、足首、足のサイドの順序を比較する。
   • ツイストダメージ：ボーンのスイング方向と、肢軸回りのロール/ツイストを別々に比較する。
   • スケールドリフト：アニメーション付きメッシュの範囲をクリーンなベースラインの範囲と比較する。

7. 意見の前に事実を報告する。

   • フレーム番号、オブジェクト名、ボーン名、ワールド座標、しきい値を含める。
   • 確認された障害と視覚的な疑いを分離する。
   • 構造化された状態が何を探すべきかを説明した後にのみ、スクリーンショットを添付する。

推奨レポート形式

## Blender モーション検査

### シーン棚卸し
- キャラクター候補：
- アーマチュア：
- ヘルパー/プロキシオブジェクト：
- カメラ/ライト：

### 向き
- ワールド上方向：
- キャラクター前方：
- ルート方位：
- 反転/逆方向のリスク：

### ベースラインの整合性
- クリーンメッシュ範囲：
- アニメーション付きメッシュ範囲：
- マテリアル/スキン保持：
- 疑わしい非キャラクターメッシュ：

### フレーム調査結果
| フレーム | 調査結果 | 証拠 |
| --- | --- | --- |
| 1 | クリーンベースラインポーズ | 腰/背骨/足が整列 |
| 96 | 足が床に貫通 | left_foot min_z = -0.04 |

### 判定
- 合格/不合格：
- 必要な修正：
- レンダリング準備完了：

例

足が滑る歩行サイクル

シナリオ：リターゲットされたキャラクターが歩行サイクル中に滑っているように見えるが、正面のカメラアングルでは足の接地が判断しにくい。

ワークフローを適用：

• シーンを棚卸し：キャラクターメッシュ HeroBody、アーマチュア HeroRig、地面 Floor、非表示のプロキシメッシュなし。
• スケルトンを特定：意味的な足は foot.L と foot.R、腰は pelvis、ルートボーンは root。
• アニメーションフレームをサンプリング：フレーム 1、18、24、30、42、48 を接地している瞬間を中心に検査。
• 接触とモーションの問題を診断：接地しているフレーム間での足のワールド位置を比較。

抽出された事実：

フレーム	事実	証拠
18	左足接地	foot.L min_z = 0.004、つま先とかかとが両方とも床付近
24	接地中に左足が滑る	foot.L x = 0.21 -> 0.28（6フレーム間）
30	骨盤が前方へ移動し続ける	pelvis y = 1.14 -> 1.31

判定：レンダリング準備不合格。モーションにはフットロックのクリーンアップまたはリターゲットコンストレイントの見直しが必要。ボディメッシュのプロポーション変更は不要。

逆方向にインポートされたキャラクター

シナリオ：キャラクターは静止フレームでは正しく見えるが、アニメーションが予想される移動方向と逆方向に動く。

ワークフローを適用：

• 前方、上、側面の軸を決定：頭、胸、足、ルートモーションを比較。
• アニメーションフレームをサンプリング：フレーム 1 と移動経路の中間点を検査。
• 意見の前に事実を報告：ルートの方位とモデルの向きを別々に含める。

抽出された事実：

フレーム	事実	証拠
1	キャラクターの顔がワールド -Y を向いている	neck から head へのベクトルが -Y 方向
72	ルートモーションがワールド +Y へ移動	root y = 0.0 -> 2.8
72	足は視覚的に移動方向と反対の前方を向いたまま	つま先のボーンは -Y を指しているが、変位は +Y

判定：インポートが逆方向であるか、リターゲットの前方軸が不一致である可能性が高い。アニメーションカーブを編集する前に、インポート/リターゲットの軸マッピングを修正する。

実用的なしきい値

• シーンの単位スケールが別途指定されていない限り、Blender のデフォルトのメートル単位を想定する。
• 床が柔らかい場合や意図的にスタイリングされている場合を除き、1～2 cm を超える地面への貫通は可視とみなす。
• 5% を超える急激なスケール変更は、リグ、コンストレイント、またはトランスフォーム継承の問題である可能性が高いとみなす。
• 空中で反転したモーション中に足首の左右の順序が入れ替わる場合は、後で回復しても脚交差のリスクとして扱う。
• ソースモーションにスナップターンが含まれていない限り、フレームあたり 30 度を超えるルート方位のジャンプは疑わしいとみなす。

アンチパターン

• 明示的にメッシュ修復のタスクでない限り、ポーズを合わせるためにボディプロポーションを変更しない。
• クリーンベースラインを記録する前にベイクしない。
• 1つのレンダリングカメラアングルをポーズが正しいことの証明として使用しない。
• ヘルパーオブジェクトがキャラクターの一部でない理由を記録するまでは削除しない。
• 頭、足、胴体、ルートモーションを一緒に確認せずに、アバターが +Y、-Y、+X、-X を向いていると想定しない。

ツールに関する注意

Blender の状態エクスポーターが利用可能な場合は、メッシュ、アーマチュア、ポーズボーン、マテリアル、コンタクト、バウンディングボックス、サンプリングされたアニメーションフレームを含む JSON を優先すること。エクスポーターがない場合は、bpy は通常のシステム Python インタプリタでは利用できないため、Blender 自体を通じて小さな Blender Python スクリプトを実行すること（例：blender --background scene.blend --python collect_motion_state.py）。