メインコンテンツまでスキップ

パフォーマンス最適化

KawaiiPhysicsのパフォーマンスを最適化する方法を説明します。

パフォーマンス特性​

KawaiiPhysicsはPhysXを使用しないため、一般的な物理シミュレーションより軽量です。

処理コストの要因​

要因影響度
ボーン数高
コリジョン数中〜高
ノード数中
カーブ使用低

最適化テクニック​

1. ボーン数の削減​

必要最小限のボーンだけを物理対象にします。

// 悪い例: 全てのボーンを物理対象に
hair_root → hair_01 → hair_02 → hair_03 → hair_04 → hair_05

// 良い例: 重要なボーンだけを物理対象に
hair_root → hair_02 → hair_04

Additional RootBonesの活用​

v1.17.0から、1つのAnimNodeで複数のRootBoneを制御できるようになりました。

Additional RootBones

1つのノードで複数のボーンチェーンを制御

複数のKawaiiPhysicsノードを使用する代わりに、AdditionalRootBonesを使うことでノード数を削減できます。

2. コリジョンの最適化​

  • シンプルな形状を使用
  • 重複するコリジョンを削除
  • LODに応じてコリジョン数を調整

3. LODによる無効化​

距離に応じてKawaiiPhysicsを無効化できます。

LODによる最適化

距離に応じたボーン数・コリジョン数の削減効果

// LOD 2以上で物理を無効化
if (GetCurrentLOD() >= 2)
{
    bEnabled = false;
}

4. Tick Rateの調整​

更新頻度を下げることで負荷を軽減できます。

5. Warm Up機能の活用​

Warm Up機能を使用すると、キャラクター生成時に物理演算を事前に安定させることができます。

Warm Up Parameters

設定方法:

  1. Need Warm Up を true に設定
  2. Warm Up Frame に空回しするフレーム数を指定（1以上）
ヒント

Warm Up Frameが大きいほど安定しますが、物理計算の回数が増えるため初期化時の負荷が上がります。通常は10〜30フレーム程度で十分です。

AnimNode Functions

AnimNode関数からWarm Upを動的に有効にすることも可能です。詳細は 更新履歴 v1.13.0 を参照してください。

プロファイリング​

Unreal Insightsでの確認​

  1. stat KawaiiPhysics コンソールコマンドを実行
  2. 処理時間を確認

コンソール変数によるデバッグ​

バージョン情報

v1.16.0で追加

レベル上でデバッグ可能なコンソール変数が用意されています。

Console Debug

コンソール変数によるデバッグ

  • a.AnimNode.KawaiiPhysics.Enable - 有効/無効の切り替え
  • a.AnimNode.KawaiiPhysics.Debug - デバッグ表示
  • a.AnimNode.KawaiiPhysics.Debug.LengthRate - デバッグ表示のスケール

ボトルネックの特定​

  • ボーン数が多い → ボーン削減
  • コリジョン計算が重い → コリジョン簡略化
  • 多数のキャラクター → LOD活用

ベンチマーク目安​

キャラクター数ボーン/キャラ目安処理時間
1200.1ms以下
10201ms程度
50205ms程度
注記

実際の処理時間は環境により異なります。必ず実機でプロファイリングしてください。