unreal.RefinementSettings

class unreal.RefinementSettings(iterations: int = 0, vertex_weight: float = 0.0, keypoint_weight: float = 0.0, landmark2d_weight: float = 0.0, laplacian: float = 0.0, bending: float = 0.0, strain: float = 0.0, vertex_offset_reg: float = 0.0, vertex_regularization: float = 0.0, distance_tolerance: float = 0.0)

Bases: StructBase

Refinement Settings

C++ Source:

  • Plugin: MetaHumanCoreTech

  • Module: MetaHumanCoreTechLib

  • File: MetaHumanConformSolverSettings.h

Editor Properties: (see get_editor_property/set_editor_property)

  • bending (float): [Read-Write] Bending resistance for triangle mesh deformation.

  • distance_tolerance (float): [Read-Write] Maximum distance (mm) to consider a scan point as a match. Ramps down each iteration for progressively tighter matching.

  • iterations (int32): [Read-Write] Number of fitting passes. More = finer result but slower.

  • keypoint_weight (float): [Read-Write] How strongly detected body keypoints (shoulders, hips, etc.) pull the rig into pose.

  • landmark2d_weight (float): [Read-Write] How strongly 2D face landmark positions guide the face fit.

  • laplacian (float): [Read-Write] Laplacian smoothness regularization on vertex offsets.

  • strain (float): [Read-Write] Strain regularization resisting stretching and compression.

  • vertex_offset_reg (float): [Read-Write] Regularization penalizing the magnitude of per-vertex offsets.

  • vertex_regularization (float): [Read-Write] Small regularization term on vertex variables for numerical stability.

  • vertex_weight (float): [Read-Write] Weight of the vertex position constraint relative to other constraints.

property bending: float

[Read-Write] Bending resistance for triangle mesh deformation.

Type:

(float)

property distance_tolerance: float

[Read-Write] Maximum distance (mm) to consider a scan point as a match. Ramps down each iteration for progressively tighter matching.

Type:

(float)

property iterations: int

[Read-Write] Number of fitting passes. More = finer result but slower.

Type:

(int32)

property keypoint_weight: float

[Read-Write] How strongly detected body keypoints (shoulders, hips, etc.) pull the rig into pose.

Type:

(float)

property landmark2d_weight: float

[Read-Write] How strongly 2D face landmark positions guide the face fit.

Type:

(float)

property laplacian: float

[Read-Write] Laplacian smoothness regularization on vertex offsets.

Type:

(float)

property strain: float

[Read-Write] Strain regularization resisting stretching and compression.

Type:

(float)

property vertex_offset_reg: float

[Read-Write] Regularization penalizing the magnitude of per-vertex offsets.

Type:

(float)

property vertex_regularization: float

[Read-Write] Small regularization term on vertex variables for numerical stability.

Type:

(float)

property vertex_weight: float

[Read-Write] Weight of the vertex position constraint relative to other constraints.

Type:

(float)