Python Scripting for MetaHuman Animator

Processing animation using MetaHuman Animator can be automated as part of a performance capture workflow with the Python API. The MetaHuman Animator plugin includes a number of example scripts that can be used as a reference and modified to suit your specific requirements. Python scripts should be executed using the UnrealEditor executable.

Audio Driven Animation

An example script for solving animation from audio is provided in the plugin.  This can be used as a reference, and modified to suit your specific requirements. It can be found in the following location:

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

Consult the ReadMe.txt file that accompanies this Python script for additional information about exporting Animation Sequences or Level Sequences using the export_performance.py script.

Generate Calibration

We provide an example script for generating camera calibration from a stereo calibration take which can be used as a reference, and be modified to suit your specific requirements. It is found in the following location:

\Engine\Plugins\MetaHuman\MetaHumanCalibrationProcessing\Content\Python\calibration_example.py

The script can be run from a Windows terminal (such as PowerShell) using the following command, with the parameters updated as needed for your project:

.\UnrealEditor.exe "MyProject.uproject" -ExecutePythonScript="<path-to_ue-installation>/Engine/Plugins/MetaHuman/MetaHumanCalibrationProcessing/Content/Python/calibration_example.py --capture-data-package-path /Game/CaptureManager/Imports/ExampleTake/CD_Example"

Generate Depth

An example script for generating depth data from a stereo camera pair is provided.  This can be used as a reference, and modified to suit your specific requirements. It can be found in the following location:

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

The script can be run from a Windows terminal (such as PowerShell) using the following command, with the parameters updated as needed for your project:

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

Animation from Depth Data

An example script for solving animation from depth data is provided in the plugin.  This can be used as a reference, and modified to suit your specific requirements. It can be found in the following location:

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

Consult the ReadMe.txt file that accompanies this Python script for additional information about creating an identity using create_identity_for_performance.py, exporting Animation Sequences or Level Sequences using the export_performance.py script, and rendering.

Next Up

Mesh to MetaHuman

Create a MetaHuman Identity from a mesh or video footage.