Skip to content

TexMotion v1.4.1: Dance Groove Dynamics & Turnaround Fix

Latest
Latest

Choose a tag to compare

View all tags
@k0ta0uchi k0ta0uchi released this 20 Sep 10:11
v1.4.1
a301fb3

TexMotion v1.4.1 Release Notes

日本語 (Japanese)

1. 骨盤ヨー角の維持と180度ターンの正常化

腰振りの強調処理（ApplyHipSwayBoost）において、骨盤の回転角を一律に $\pm 45^\circ$ で制限していたため、背後を向く180度ターン動作が斜め前向き（$45^\circ$）に切り詰められる不具合が生じていた。本バージョンでは、骨盤全体の向き（ヨー角）を変更せず保持し、腰の左右移動から生じる微小な傾き（ロール軸、最大 $\pm 8^\circ$）のみを加算合成する構成に改めた。これにより、180度ターンの回転を維持したまま、左右の腰振りを誇張できる。

2. ダンスグルーヴダイナミクスと低重心スタンス（Stance Dip）

直立した棒立ち姿勢を解消するため、足の配置とリズムに連動する姿勢補正（ApplyDanceGrooveDynamics）を導入した。

  • 開脚時の沈み込みと膝屈曲: 左右の足の距離（開脚幅）に比例して骨盤の高さを最大 7.5cm 下降させ、同時に膝関節を前方へ $4^\circ \sim 13^\circ$ 屈曲させることで、安定したダンサースタンスを形成する。
  • ビートバウンスの増幅: 腰の上下動の振幅を 1.4倍 にスケールし、リズムに合わせた沈み込みと跳ね返りを際立たせる。
  • 体幹の前傾姿勢: 脊椎（Spine/Chest）に $7.5^\circ$ の前傾バイアスを付与し、ストリートダンス特有の構え姿勢を再現する。
  • 四肢の張り出し: 肩の外転を $6.5^\circ$、肘の外開きを $7.0^\circ$ 拡大し、体幹への腕の密着を防いでシルエットを強調する。
  • Dance プリセットの追加: タイムラインのポリッシュパネルに、これらの設定を一括適用するプリセットボタンを追加した。

3. 接地・接触制約ソルバーとフットコンタクトトラック

足裏の滑り（フットスライディング）を抑止するため、接地判定と位置固定を担うソルバー（ContactConstraintSolver）を実装した。

  • 接地判定と2-Bone IK固定: 各足の移動速度と床面からの高さを評価して接地状態を自動検出し、接地中は足首の位置を 2-Bone IK で床面に固定する。
  • 跳躍期の維持: 跳躍や空中ステップの区間では床面吸着を解除し、元のモーションが持つ滞空高さを維持する。

4. 幾何モデルによる自己貫通およびPhysBone衝突の回避

手足の体幹へのめり込みと、ループ再生境界での急激な関節変化を防ぐ保護処理を追加した。

  • 自己貫通回避ソルバー（PenetrationConstraintSolver）: 体幹と腕部を幾何モデル（カプセル・球体）として定義し、接触境界を越えた手足を外側へ押し戻す。
  • PhysBone衝突検知（PhysBoneConflictDetector）: ループ再生の先頭と末尾における位置・角速度の急変を検出し、髪や衣装の PhysBone が反転・暴走するのを抑止する。

5. 欠損修復と表情プロファイル

遮蔽によって関節検出が途切れた区間の修復と、表情アニメーションの対応づけを拡充した。

  • 運動学エルミート補間（Temporal Inpainting）: 検出が途切れたフレーム間を、欠損前後の速度ベクトルを維持した 3次エルミートスプラインおよび四元数球面線形補間（Slerp）で滑らかに接続する。
  • 表情マッピングプロファイル（FaceMappingProfile）: 映像から抽出した表情データとアバターの BlendShape の対応関係を定義・保存する ScriptableObject とエディタを追加した。

English

1. Pelvis Yaw Preservation and 180-Degree Turnaround Fix

In previous versions, ApplyHipSwayBoost clamped the pelvis Euler rotation within $\pm 45^\circ$, which incorrectly restricted 180-degree turnaround maneuvers to a $45^\circ$ diagonal pose. This release preserves the global yaw orientation of the pelvis, applying only subtle roll tilts (up to $\pm 8^\circ$) derived from lateral hip displacement. Full 180-degree turnarounds now execute correctly while preserving amplified lateral hip dynamics.

2. Dance Groove Dynamics & Low-Center Stance Dip

To prevent stiff, upright postures during dance motions, ApplyDanceGrooveDynamics introduces rhythm- and footstep-responsive adjustments:

  • Stance Dip & Knee Flexion: Lowers the pelvis by up to 7.5 cm in proportion to foot separation width while flexing the knees forward by $4^\circ \sim 13^\circ$, creating a grounded athletic dancer stance.
  • Beat Bounce Boost: Scales vertical pelvis oscillation amplitude by 1.4x to accentuate rhythmic bobbing and rebound.
  • Torso Street-Dance Lean: Applies a $7.5^\circ$ forward lean bias across the spine to reproduce urban dance posture.
  • Arm & Elbow Flare: Expands shoulder abduction by $6.5^\circ$ and elbow outward flare by $7.0^\circ$, preventing limbs from collapsing against the torso.
  • Dance Preset: Adds a one-click Dance preset button to the Timeline Polish Panel.

3. Contact Constraint Solver & Foot Contact Tracks

To eliminate foot sliding during grounded phases, ContactConstraintSolver introduces automated foot locking:

  • Grounding Detection & 2-Bone IK Locking: Evaluates foot velocity and floor clearance to detect contact intervals, fixing the ankle position to the floor via 2-Bone IK throughout the contact window.
  • Airborne Phase Preservation: Releases ground pinning during jumps and aerial steps to preserve original flight trajectories.

4. Geometric Self-Penetration & PhysBone Conflict Protection

Introduces collision mitigation and boundary safeguards:

  • Penetration Constraint Solver: Represents the torso and upper limbs using bounding capsules and spheres, actively resolving limb penetration into the body.
  • PhysBone Conflict Detector: Detects velocity and positional discontinuities at loop seams, preventing avatar hair and clothing PhysBones from whipping or inverting.

5. Temporal Inpainting & Facial Mapping Profile

Extends repair capabilities for tracking dropouts and facial tracking:

  • Kinematic Hermite Inpainting: Reconstructs occluded tracking gaps using cubic Hermite splines and quaternion spherical linear interpolation (Slerp) aligned with boundary velocities.
  • Face Mapping Profile: Adds a ScriptableObject profile system and custom inspector to map video-extracted facial landmarks to avatar BlendShapes.

📦 Installation

Download TexMotion.unitypackage below and import it into your Unity project (Unity 2022.3.x recommended, VRChat Avatar project supported).
Or install directly via Unity Package Manager using Git URL:

https://github.com/k0ta0uchi/TexMotion.git
Assets 3
Loading