unreal.IKRetargetPelvicMotionOpSettings

class unreal.IKRetargetPelvicMotionOpSettings(enabled: bool = False, lod_threshold: int = 0, target_physics_asset_override: PhysicsAsset = Ellipsis, body_mapping: None = {}, target_pelvic_bone: Name = 'None', check_prop_bones: None = [], distance_threshold: float = 0.0, dist_half_point_lambda: float = 0.0, distance_weight_mode: DistanceWeightMode = Ellipsis, contribution_sum_weight: float = 0.0, temporal_smoothing_radius: int = 0, ignore_source_scale: bool = False, retarget_contact_alpha: float = 0.0, retarget_spring_alpha: float = 0.0, debug_draw_body_pairs: bool = False, debug_full_retarget_pair_bones: None = [], debug_draw_goal_contributions: bool = False, debug_draw_retarget_vert_averages: bool = False, debug_draw_physics_bodies: bool = False, debug_draw_body_transforms: bool = False, dry_run: bool = False)

Bases: IKRetargetOpSettingsBase

Relative Pelvic Motion Settings

C++ Source:

  • Plugin: RelativeIKOp

  • Module: RelativeIKOp

  • File: RelativePelvicMotionOp.h

Editor Properties: (see get_editor_property/set_editor_property)

  • body_mapping (Map[Name, Name]): [Read-Write] Physics body source -> target name mapping

  • check_prop_bones (Array[PinBoneSettings]): [Read-Write] List of attach (prop) bones that can contribute to pelvic motion relationships NOTE: unlike relative ik, these bones are not pinned by the op

  • contribution_sum_weight (double): [Read-Write] IK Goal normalization (internally multiplied by total of contribution weights)

  • debug_draw_body_pairs (bool): [Read-Write] Draw source and target body pair relationships for current animation

  • debug_draw_body_transforms (bool): [Read-Write] Show body-local transform setup (like baked verts)

  • debug_draw_goal_contributions (bool): [Read-Write] Draw each pair’s goal contribution (white) and show weighted final goal location (yellow)

  • debug_draw_physics_bodies (bool): [Read-Write] Display source and target physics bodies for baked data

  • debug_draw_retarget_vert_averages (bool): [Read-Write] Draw retarget pair-line for each pair contribution

  • debug_full_retarget_pair_bones (Array[Name]): [Read-Write] Draw full retarget space (quad) pair relationships

  • dist_half_point_lambda (double): [Read-Write] DistHalfPointLambda*DistanceThreshold is the place where distance weight value be 0.5

  • distance_threshold (double): [Read-Write] Maximum distance for which body pair info is baked

  • distance_weight_mode (DistanceWeightMode): [Read-Write] DistHalfPointLambda*DistanceThreshold is the place where distance weight value be 0.5

  • dry_run (bool): [Read-Write] Run op and display debug info but DON’T update IK Goals

  • enabled (bool): [Read-Write] Enable/disable the entire operation. Disabled ops are skipped entirely and do not run at all.

  • ignore_source_scale (bool): [Read-Write] Ignore source scaling when computing relative distance relationships

  • lod_threshold (int32): [Read-Write] The maximum LOD that this Op is allowed to run at. For example if you have LODThreshold of 2, the Op will run until LOD 2 (based on 0 index). When the component LOD becomes 3, it will stop running. A value of -1 forces the Op to execute at all LOD levels. Default is -1.

  • retarget_contact_alpha (double): [Read-Write] Alpha from contact-body to secondary body representation in contribution pairs

  • retarget_spring_alpha (double): [Read-Write] Alpha between primary and secondary pair distance relationship

  • target_pelvic_bone (Name): [Read-Write] Physics body source -> target name mapping

  • target_physics_asset_override (PhysicsAsset): [Read-Write] Target mesh physics asset for retargeting relative body pair vertices

  • temporal_smoothing_radius (int32): [Read-Write] Frames of temporal smoothing of body pair verts (0 is no smoothing)

property body_mapping: None

[Read-Write] Physics body source -> target name mapping

Type:

(Map[Name, Name])

property check_prop_bones: None

[Read-Write] List of attach (prop) bones that can contribute to pelvic motion relationships NOTE: unlike relative ik, these bones are not pinned by the op

Type:

(Array[PinBoneSettings])

property contribution_sum_weight: float

[Read-Write] IK Goal normalization (internally multiplied by total of contribution weights)

Type:

(double)

property debug_draw_body_pairs: bool

[Read-Write] Draw source and target body pair relationships for current animation

Type:

(bool)

property debug_draw_body_transforms: bool

[Read-Write] Show body-local transform setup (like baked verts)

Type:

(bool)

property debug_draw_goal_contributions: bool

[Read-Write] Draw each pair’s goal contribution (white) and show weighted final goal location (yellow)

Type:

(bool)

property debug_draw_physics_bodies: bool

[Read-Write] Display source and target physics bodies for baked data

Type:

(bool)

property debug_draw_retarget_vert_averages: bool

[Read-Write] Draw retarget pair-line for each pair contribution

Type:

(bool)

property debug_full_retarget_pair_bones: None

[Read-Write] Draw full retarget space (quad) pair relationships

Type:

(Array[Name])

property dist_half_point_lambda: float

[Read-Write] DistHalfPointLambda*DistanceThreshold is the place where distance weight value be 0.5

Type:

(double)

property distance_threshold: float

[Read-Write] Maximum distance for which body pair info is baked

Type:

(double)

property distance_weight_mode: DistanceWeightMode

[Read-Write] DistHalfPointLambda*DistanceThreshold is the place where distance weight value be 0.5

Type:

(DistanceWeightMode)

property dry_run: bool

[Read-Write] Run op and display debug info but DON’T update IK Goals

Type:

(bool)

property ignore_source_scale: bool

[Read-Write] Ignore source scaling when computing relative distance relationships

Type:

(bool)

property retarget_contact_alpha: float

[Read-Write] Alpha from contact-body to secondary body representation in contribution pairs

Type:

(double)

property retarget_spring_alpha: float

[Read-Write] Alpha between primary and secondary pair distance relationship

Type:

(double)

property target_pelvic_bone: Name

[Read-Write] Physics body source -> target name mapping

Type:

(Name)

property target_physics_asset_override: PhysicsAsset

[Read-Write] Target mesh physics asset for retargeting relative body pair vertices

Type:

(PhysicsAsset)

property temporal_smoothing_radius: int

[Read-Write] Frames of temporal smoothing of body pair verts (0 is no smoothing)

Type:

(int32)