| On this page |
概要 ¶
このノードは、APEXリグを編集して、ポーズをとったキャラクタにML Deformerの効果を適用します。
このノードは、トレーニング済みMLモデルを使用して、キャラクタのスキンを変形させることができます。 内部的には、MLモデルがウェイトを予測して、残差ブレンドシェイプを組み合わせて、静止スキンに補正を適用します。
Note
APEX Add ML Deformerは、ML Pose Serializeのデフォルト設定を使用して作成されたデータセットに対してモデルがトレーニングされたことを前提としています。 これらの設定は、 Mode が Subskeleton に設定されていて、 Include World Rotation が有効になっています。 また、トレーニングデータセットを作成するには、 Joint Group は、ML Pose Serializeで使用されたジョイントグループと同じである必要があります。 これらの要件は、ML Train Deformerレシピを使用してトレーニングを行なった場合に満たされます。
入力 ¶
CharacterStream
ML駆動の変形が挿入されるAPEX Packed Character。
Blend Shapes
静止メッシュを適応させるために、MLモデルが出力したウェイトと組み合わせて使用されるブレンドシェイプ。
最初のブレンドシェイプには固定の1のウェイトが常に適用され、残りのブレンドシェイプにはMLモデルから出力されたウェイトが同じ順序で割り当てられます。
パラメータ ¶
Model File
シリアライズされたポーズを入力とし、残差ブレンドポーズのウェイトのタプルを出力するONNX形式のトレーニング済みモデル。
Execution Provider
推論に使用するONNX実行プロバイダを決定します。 デフォルトでは、このノードは、利用可能な最適なプロバイダを選択し、GPUアクセラレーションの使用を優先します。
Automatic
現在のシステムに最適なプロバイダを選択します。 このオプションは、CUDAがインストールされている場合はCUDAを優先し、プラットフォームに応じてDirectML/CoreMLをフォールバックとして使用し、GPUプロバイダが利用できない場合はCPU推論を実行します。
CPU
CPUを使用して推論を実行します。
CUDA
CUDA/cuDNNを使用して推論を実行します。 CUDAおよびcuDNNは、NVIDIAで用意されているパッケージを使用してインストールしなければなりません。
DirectML
Windowsでのみ利用可能です。 Windows Direct Machine Learningライブラリを使用して推論を実行します。
CoreML
MacOSでのみ利用可能です。 AppleのCore MLライブラリを使用して推論を実行します。
Joint Group
トレーニング済みの Model File のデータセットに含めるために、ポーズをシリアライズするジョイントグループ。
Enforce Joint Limits
有効にすると、ポーズがモデルに入力される前に、指定したジョイント制限がそのポーズに適用されます。
Joint Limits
ジョイント制限を含んだ辞書アトリビュートの名前を指定します。
Blend Shapes Source
Packed Residual
Blend Shapes入力は、パックプリミティブで構成されている必要があります。 各パックプリミティブには、キャプチャシェイプが差し引かれたブレンドシェイプである 残差ブレンドシェイプ が含まれている必要があります。
Direct
Blend Shapes入力で指定されたブレンドシェイプを直接使用します。
| See also |
