unreal.MetaHumanCalibrationBatchLibrary

class unreal.MetaHumanCalibrationBatchLibrary(outer: Object | None = None, name: Name | str = 'None')

Bases: BlueprintFunctionLibrary

Blueprint function library for batch camera calibration generation.

Provides three levels of API: - BatchGenerateCalibration: Simple interface — just assets and board config. - BatchGenerateCalibrationWithOptions: Advanced interface with per-asset Options. - ConstructDefaultOptionsForCaptureData: Utility to build default Options for a CaptureData asset.

Cancellation is supported via the FScopedSlowTask progress dialog.

C++ Source:

• Plugin: MetaHumanCalibrationProcessing

• Module: MetaHumanCalibrationGenerator

• File: MetaHumanCalibrationBatchLibrary.h

classmethod batch_generate_calibration(capture_data_assets, board_config) → Array[MetaHumanCalibrationBatchResult]

Run calibration generation across multiple UFootageCaptureData assets with automatic defaults.

For each asset, constructs default Options via ConstructDefaultOptionsForCaptureData and runs calibration with automatic frame selection. Output is placed next to each CaptureData asset. This is the simplest entry point for batch processing.

Parameters:

• capture_data_assets (Array[FootageCaptureData]) – Footage capture data assets to process.

• board_config (MetaHumanCalibrationGeneratorConfig) – Calibration board pattern configuration (dimensions and square size).

Returns:

Per-asset results in input order.

Return type:

Array[MetaHumanCalibrationBatchResult]

classmethod batch_generate_calibration_with_options(capture_data_assets, board_config, options_per_asset) → Array[MetaHumanCalibrationBatchResult]

Run calibration generation with per-asset Options for full control.

Each CaptureData asset is paired with a corresponding Options object. If an Options object has empty SelectedFrames, automatic frame selection is used and the SelectedFrames array on the Options object will be populated.

Parameters:

• capture_data_assets (Array[FootageCaptureData]) – Footage capture data assets to process.

• board_config (MetaHumanCalibrationGeneratorConfig) – Calibration board pattern configuration (dimensions and square size).

• options_per_asset (Array[MetaHumanCalibrationGeneratorOptions]) – Per-asset options (must be same length as InCaptureDataAssets).

Returns:

Per-asset results in input order.

Return type:

Array[MetaHumanCalibrationBatchResult]

classmethod construct_default_options_for_capture_data(capture_data) → MetaHumanCalibrationGeneratorOptions

Construct a default UMetaHumanCalibrationGeneratorOptions for a CaptureData asset.

Sets AssetName to CC_<CaptureDataName>, PackagePath to the same directory as the CaptureData asset, AreaOfInterest to full frame bounds per camera, SharpnessThreshold to 5.0, and bAutoSaveAssets to true. SelectedFrames is left empty so that automatic frame selection will be used.

The returned Options can be customised before passing to BatchGenerateCalibrationWithOptions.

Parameters:

capture_data (FootageCaptureData) – The capture data asset to configure options for.

Returns:

A new Options object with sensible defaults, or nullptr if CaptureData is null.

Return type:

MetaHumanCalibrationGeneratorOptions