プロシージャル3Dメックアニメーター は何をしますか?
Three.jsを使用して、プロダクショングレードのシングルファイルまたはモジュール式の3Dハードサーフェスロボットやメックを構築します。コンフォーマルUVマッピング、プロシージャルなインメモリPBRテクスチャ、解析的2ボーン逆運動学(ゼロドリフトフットIK)、および多相の全身アニメーションを備えています。
使用するタイミング
- 外部の
.glbアセットを使用せずに、Three.jsでプロシージャルな3Dメック、ロボット、ウォーカー、またはハードサーフェス車両を作成する場合。 - 解析的2ボーン逆運動学(IK)を実装し、スクワット、ランジ、歩行、ダンス、または戦闘攻撃中に足を地面に固定したままにする場合。
- アンチシペーション、キネティックチェーンラグ、衝撃衝撃波、および回復を伴う多相のキネティック戦闘または移動アニメーションを設計する場合。
- トポロジーに適合するUV座標と、外部画像依存関係なしにインメモリ
THREE.CanvasTexturePBRマテリアル(溶接跡、リベット、エッジ摩耗、バンプマップ、ステンシル)を生成する場合。
ステップ1:プロシージャルロフトジオメトリとコンフォーマルUVマッピング
3Dキャラクターやメックにワールド空間の平面UV投影を使用しないでください。ワールド空間投影では、パターンが平らな壁紙や関節に張られたジャージのように見えるからです。ロフトおよびチューブビルダー内で トポロジーに沿ったコンフォーマルUV座標 を直接計算します。
- 断面の周囲リング(
i / nPts)に沿ってu(0.0から1.0)を連続的にパラメータ化します。 - 下部面取りから上部面取りまでの縦方向のロフトスライスに沿って
v(0.0から1.0)をパラメータ化します(r / (numRings - 1))。 - エンドキャップの三角形を
(0.5, 0.5)を中心に放射状にマッピングします。
function buildLoftGeometry(slices, capBot = true, capTop = true) {
const numRings = slices.length;
const nPts = slices[0].length;
const positions = [];
const uvs = [];
for (let r = 0; r < numRings - 1; r++) {
const v0 = r / (numRings - 1);
const v1 = (r + 1) / (numRings - 1);
for (let i = 0; i < nPts; i++) {
const u0 = i / nPts;
const u1 = (i + 1) / nPts;
const p00 = slices[r][i];
const p10 = slices[r][(i + 1) % nPts];
const p01 = slices[r + 1][i];
const p11 = slices[r + 1][(i + 1) % nPts];
positions.push(...p00, ...p10, ...p11);
uvs.push(u0, v0, u1, v0, u1, v1);
positions.push(...p00, ...p11, ...p01);
uvs.push(u0, v0, u1, v1, u0, v1);
}
}
// capBot / capTop が true の場合、放射状キャップを追加し、computeVertexNormals() を呼び出す
const geo = new THREE.BufferGeometry();
geo.setAttribute('position', new THREE.Float32BufferAttribute(positions, 3));
geo.setAttribute('uv', new THREE.Float32BufferAttribute(uvs, 2));
geo.computeVertexNormals();
return geo;
}
ステップ2:HTML5 Canvasを使用したインメモリプロシージャルPBRテクスチャ
HTMLファイルを肥大化させたり、変数参照を見逃したりするマルチメガバイトのBase64文字列を埋め込まないでください。HTML5 2D Canvasと THREE.CanvasTexture を使用して、起動時にメモリ内にアルベド、バンプ、ハザード、デカール、シールドテクスチャを生成します。
- コンフォーマルシームアライメント:8面の面取りブロック(
nPts = 8)の場合、垂直のシームトレンチとエッジ摩耗ハイライトをu = 0.0, 0.25, 0.50, 0.75に配置します。水平の面取りシーム、スカロップ状の溶接ビード、ボルト列をv = 0.02..0.08(下部境界)とv = 0.92..0.98(上部境界)の近くに配置します。 - 3Dバンプレリーフ:バンプキャンバスをニュートラルな
#808080(128)で塗りつぶし、深いシームトレンチを#181818、盛り上がった溶接ビードを#dcdcdc、ボルトヘッドを#f5f5f5と影のリング#1c1c1cで描画します。THREE.MeshStandardMaterialでbumpScale: 0.055から0.065に設定します。
ステップ3:関節ピボット補償階層
メッシュをグローバルモデル座標で構築する場合、各ボディパーツをローカルピボットグループに変換して、回転が解剖学的関節中心 (px, py, pz) を中心にクリーンに行われるようにします。
function createLocalPartGroup(name, pivotX, pivotY, pivotZ, parentGroup) {
const joint = new THREE.Group();
joint.name = name;
joint.position.set(pivotX, pivotY, pivotZ);
parentGroup.add(joint);
const offsetGroup = new THREE.Group();
offsetGroup.position.set(-pivotX, -pivotY, -pivotZ);
joint.add(offsetGroup);
return { joint, space: offsetGroup };
}
標準メックキネマティックツリー
root->pelvis[0, 0.00, 0]torso[0, 0.10, 0](骨盤に対して回転)sensorPod[0, 1.08, 0.42](逆回転して光学系をターゲットにロック)hatchL/hatchR[±0.42, 1.44, -0.05]->missilePodL/missilePodRshoulderL[+0.98, 0.92, 0]->armL->elbowL[+1.26, 0.36, 0](レールガンアセンブリ)shoulderR[-0.98, 0.92, 0]->armR->elbowR[-1.26, 0.36, 0]->wristChuck->claw1..3
legL[+0.54, -0.12, 0]->kneeL[+0.62, -0.86, 0.12]->ankleL[+0.66, -1.72, 0.02]legR[-0.54, -0.12, 0]->kneeR[-0.62, -0.86, 0.12]->ankleR[-0.66, -1.72, 0.02]
ステップ4:解析的2ボーン脚IKソルバー(ゼロドリフトフットロック)
骨盤の高さや回転を前方運動学(FK)だけでアニメーション化すると、足が床に沈み込んだり、不自然に滑ったりします。常に解析的2ボーン逆運動学ソルバー(solveLegIK)を使用して脚を駆動し、骨盤のトランスフォームを設定した後、毎フレーム評価します。
- リジッドボーンロック:
ankleJoint.positionを脛骨の正確な先端に固定し、足が脚から決して離れないようにします。 - ワールドから骨盤へのターゲット変換:目的のワールド空間足首位置
targetWorldVecをworldToLocal()を使用してpelvis.children[0]のローカル空間に変換します。 - リーチクランプ:股関節ピボット
[sx * 0.54, -0.12, 0]からローカルターゲットまでの距離Dを測定します。骨盤が遠くに伸びたときにNaNエラーが発生しないように、DをmaxReach = L1 + L2 - 0.003にクランプします。 - 膝の曲げに対する余弦定理:
- 内部膝角度を計算:
cosB = clamp((L1*L1 + L2*L2 - D*D) / (2 * L1 * L2), -1, 1) - 膝のX回転を設定:
kx = (Math.PI - Math.acos(cosB)) - REST_KNEE_OFFSET
- 内部膝角度を計算:
- クォータニオンによる股関節エイミング:
- 回転していないすねベクトルをX軸周りに
kxだけ回転させ、太ももベクトルを加算して_vHipToAnkleUnrotを取得し、_qAim.setFromUnitVectors(_vHipToAnkleUnrot.normalize(), _vTargetLocal.normalize())を使用してローカルターゲット方向[dx, dy, dz]に合わせます。
- 回転していないすねベクトルをX軸周りに
- ワールド空間の足の向き:
- 親の膝ワールドクォータニオン
_qParentWorldを計算し、(footPitch, footYaw, footRoll)から目的のワールドフットクォータニオン_qDesiredFootを構築し、ankleJoint.quaternion.copy(_qParentWorld).invert().multiply(_qDesiredFoot)を設定して、股関節や膝の角度に関係なく足裏が床に対して平らになるようにします。
- 親の膝ワールドクォータニオン
ステップ5:全身プロシージャルアニメーションの原則
単一の手足を単独でアニメーション化しないでください(ロボットのように見え、重量感がありません)。すべてのアニメーションは完全なキネティックチェーンを関与させる必要があります。
1. 4相戦闘打撃パターン(例:クロースマッシュ&コンボアタック)
サイクル u in [0, 1] にわたって、ヘビーメレーまたは武器アニメーションを4つの正規化された明確なフェーズに分割します。
- フェーズ1:アンチシペーション&コイル(
0.00 - 0.42):- リードフットを弧を描いて前進させ(
stepLift = Math.sin(stepU * Math.PI) * 0.28)、広く接地します。 - 骨盤の重量を後方のアンカー脚に移動し、腰と胴体を後方にコイルさせます(複合ヨー
-70 deg)。 - 頭/センサーポッドを逆回転(
+85 deg)させて、目がターゲットにロックされたままになるようにします。 - 打撃側の肩と肘を背中の後ろ高く引き、反対側の腕をカウンターウェイトとして胸の前で振り、手首チャックを回転させ、クローを100%開きます。
- リードフットを弧を描いて前進させ(
- フェーズ2:爆発的ランジ&ウィップ(
0.42 - 0.58):solveLegIKを介して両足を床にロックしたまま、骨盤を前方(+0.62mZ)かつ下方(-0.27mY)に駆動します。- ホイップラグでキネティックチェーンを順序付けます:股関節が最初にスナップし(
smoothstep(0.0, 0.85, u))、胴体がそれに続き、打撃腕は広い外側の円弧(Math.sin(armWhip * Math.PI))に沿って非線形に加速します(Math.pow(smoothstep(0.08, 1.0, u), 1.35))。
- フェーズ3:衝撃、クランプ&ヒットストップ(
0.58 - 0.72):- 衝撃の瞬間にクローを閉じます(
clawVal = 0.05)。 - プロシージャルなカメラシェイク、放射状の衝撃波リング、高周波の構造的震え(
Math.sin(u * Math.PI * 10) * Math.exp(-u * 5))、および合成された衝撃オーディオをトリガーします。
- 衝撃の瞬間にクローを閉じます(
- フェーズ4:油圧回復(
0.72 - 1.00):1.0 - smoothstep(0.0, 1.0, u)を使用して、リードフットと骨盤をニュートラルスタンスにスムーズに戻します。
2. マルチアクションコンボシーケンス(all_out_attack)
より長いタイムライン(例:10.0s 周期)にわたって複数の戦闘ステージをチェーンします。
- ステージA(
0.00 - 0.24):前方ランジとスパークバーストを伴うヘビークロースマッシュ。 - ステージB(
0.24 - 0.50):胴体スナップエイム、ツインレールガン反動(armLがバレル軸に沿って後方にキックバックし、胴体が反動インパルスでねじれる)、および高速発射体ボルトのスポーン。 - ステージC(
0.50 - 0.78):ブレーススタンス、ルーフミサイルハッチを開け(setHatchState(1))、ランチャーポッドを上昇させ、煙跡を伴うアーチ状の弾道ミサイルを千鳥配置で発射します。 - ステージD(
0.78 - 1.00):システムを冷却しながら、パルス状の衝撃波を伴う六角形のプラズマドームシールド(rig.shieldDome.visible = true)をアクティブにします。
3. 移動とダンスのダイナミクス
- ヘビーウォーク/ラン:逆位相オフセット(
phaseL = cycle * 2 * Math.PI、phaseR = phaseL + Math.PI)を使用します。Math.sin(phase) > 0の場合にのみスイングフットを持ち上げ、骨盤の横方向の揺れ(cos(phase))をスタンス脚の上に移動させ、腕をカウンタースイングします(armLはlegRと一緒に動きます)。 - ダンスグルーヴ:
solveLegIKを介して両足を床にロックしたまま、リズミカルな8の字の腰の揺れ、2倍速の膝バウンス(Math.abs(Math.sin(beat * 2)))、交互の肩ポップ、および回転するクローフラリッシュを駆動します。
検証チェックリスト
- 生成されたスクリプトに対して構文検証を実行し(
node -e "new Function(code)")、構文エラーや未宣言変数エラーがゼロであることを確認します。 evaluateAnimation(t, dt)の最後で、すべての骨盤位置/回転の更新後にsolveLegIK('L', ...)とsolveLegIK('R', ...)が呼び出されていることを確認します。- 実行時エラーが発生した場合にすぐに画面上に表示されるように、HTML にトップレベルの
window.onerror診断バナーを含めます。