Python スクリプティング | MetaHuman ドキュメンテーション

MetaHuman Animator を使用したアニメーションの処理は、Python API を使用して、パフォーマンスキャプチャワークフローの一部として自動化することができます。 MetaHuman Animator プラグインには多数のサンプルスクリプトが用意されており、参考として使用したり特定の要件に合わせて変更したりできます。 Python スクリプトは、UnrealEditor 実行可能ファイルを使用して実行する必要があります。

キャラクター解析で問題が起こらないよう、コマンドに表示されるパスには、「\」ではなく「/」を使用してください。

音声駆動アニメーション

音声を使ってアニメーションを解決するためのサンプルスクリプトが、プラグインで提供されます。これを参考として使用したり特定の要件に合わせて変更したりできます。次の場所にあります。

Command Line

\Engine\Plugins\MetaHuman\MetaHumanAnimator\Content\Python\process_audio_performance.py

\Engine\Plugins\MetaHuman\MetaHumanAnimator\Content\Python\process_audio_performance.py

export_performance.py スクリプトを使用したアニメーションシーケンスまたはレベルシーケンスのエクスポートに関する追加情報については、この Python スクリプトに付属する ReadMe.txt ファイルを参照してください。

深度データを使ったアニメーション

深度データを使ってアニメーションを解決するためのサンプルスクリプトが、プラグインで提供されます。これを参考として使用したり特定の要件に合わせて変更したりできます。次の場所にあります。

Command Line

\Engine\Plugins\MetaHuman\MetaHumanAnimator\Content\Python\process_performance.py

\Engine\Plugins\MetaHuman\MetaHumanAnimator\Content\Python\process_performance.py

create_identity_for_performance.py スクリプトを使用した ID の作成に関する追加情報については、この Python スクリプトに付属する ReadMe.txt ファイルを参照してください。また、export_performance.py スクリプトを使用したアニメーションシーケンスまたはレベルシーケンスのエクスポート、およびレンダリングについても同ファイルを参照してください。

キャリブレーションを生成する

キャリブレーションは、ステレオカメラペアを使ってキャプチャしたキャリブレーションテイクから生成できます。これには、キャプチャデータアセット (Capture Manager を使用して取り込まれたもの) と MetaHumanCalibrationGeneratorOptions のインスタンスが必要です。次に例を示します。

Python

import unreal

calibration_generator = unreal.MetaHumanCalibrationGenerator()
calibration_generator.process(capture_data_asset, calibration_generator_options)

import unreal

calibration_generator = unreal.MetaHumanCalibrationGenerator()
calibration_generator.process(capture_data_asset, calibration_generator_options)

MetaHumanCalibrationGeneratorOptions のインスタンスは次のとおり作成できますが、設定の多くはデフォルトで行われます。

Python

calibration_generator_options = unreal.MetaHumanCalibrationGeneratorOptions()
calibration_generator_options.package_path.path = '/Game/GenerateCalibration/'
calibration_generator_options.auto_save_assets = True   # Set by default
calibration_generator_options.sample_rate = 30          # Set by default
calibration_generator_options.board_pattern_width = 15  # Set by default
calibration_generator_options.board_pattern_height = 10 # Set by default
calibration_generator_options.board_square_size = 0.75  # Set by default
calibration_generator_options.sharpness_threshold = 5.0 # Set by default

calibration_generator_options = unreal.MetaHumanCalibrationGeneratorOptions()
calibration_generator_options.package_path.path = '/Game/GenerateCalibration/'
calibration_generator_options.auto_save_assets = True   # Set by default
calibration_generator_options.sample_rate = 30          # Set by default
calibration_generator_options.board_pattern_width = 15  # Set by default
calibration_generator_options.board_pattern_height = 10 # Set by default
calibration_generator_options.board_square_size = 0.75  # Set by default
calibration_generator_options.sharpness_threshold = 5.0 # Set by default

深度を生成

ステレオカメラペアから深度データを生成するためのサンプルスクリプトが提供されます。これを参考として使用したり特定の要件に合わせて変更したりできます。次の場所にあります。

Command Line

\Engine\Plugins\MetaHuman\MetaHumanAnimator\Content\DepthGenerator\depth_generator_example.py

\Engine\Plugins\MetaHuman\MetaHumanAnimator\Content\DepthGenerator\depth_generator_example.py

このスクリプトは、次のコマンドを使用して Windows ターミナル (PowerShell など) から実行できます。パラメータはプロジェクトに合わせて更新してください。

Command Line

.\UnrealEditor.exe "MyProject.uproject" -ExecutePythonScript="<path-to_ue-installation>/Engine/Plugins/MetaHuman/MetaHumanAnimator/Content/DepthGenerator/depth_generator_example.py --cd-package-path /Game/CaptureManager/Imports/ExampleTake/CD_Example"

.\UnrealEditor.exe "MyProject.uproject" -ExecutePythonScript="<path-to_ue-installation>/Engine/Plugins/MetaHuman/MetaHumanAnimator/Content/DepthGenerator/depth_generator_example.py --cd-package-path /Game/CaptureManager/Imports/ExampleTake/CD_Example"

次の内容

メッシュをMetaHumanに変換

メッシュまたは動画フッテージから MetaHuman Identity を作成します。