unreal.RigUnit_FitChainToCurvePerItem

class unreal.RigUnit_FitChainToCurvePerItem(execute_context: ControlRigExecuteContext = [], items: RigElementKeyCollection = Ellipsis, bezier: CRFourPointBezier = [], alignment: ControlRigCurveAlignment = Ellipsis, minimum: float = 0.0, maximum: float = 0.0, sampling_precision: int = 0, primary_axis: Vector = Ellipsis, secondary_axis: Vector = Ellipsis, pole_vector_position: Vector = Ellipsis, rotations: Array[RigUnit_FitChainToCurve_Rotation] = [], rotation_ease_type: ControlRigAnimEasingType = Ellipsis, weight: float = 0.0, propagate_to_children: bool = False, debug_settings: RigUnit_FitChainToCurve_DebugSettings = Ellipsis)

Bases: RigUnit_HighlevelBaseMutable

Fits a given chain to a four point bezier curve. Additionally provides rotational control matching the features of the Distribute Rotation node.

C++ Source:

  • Plugin: ControlRig

  • Module: ControlRig

  • File: RigUnit_FitChainToCurve.h

Editor Properties: (see get_editor_property/set_editor_property)

  • alignment (ControlRigCurveAlignment): [Read-Only] Alignment: Specifies how to align the chain on the curve

  • bezier (CRFourPointBezier): [Read-Write] Bezier: The curve to align to

  • debug_settings (RigUnit_FitChainToCurve_DebugSettings): [Read-Write] Debug Settings

  • execute_context (ControlRigExecuteContext): [Read-Write] Execute Context: * This property is used to chain multiple mutable units together

  • items (RigElementKeyCollection): [Read-Write] Items: The items to align

  • maximum (float): [Read-Only] Maximum: The maximum U value to use on the curve

  • minimum (float): [Read-Only] Minimum: The minimum U value to use on the curve

  • pole_vector_position (Vector): [Read-Write] Pole Vector Position: The the position of the pole vector used for aligning the secondary axis. Only has an effect if the secondary axis is set.

  • primary_axis (Vector): [Read-Write] Primary Axis: The major axis being aligned - along the bone

  • propagate_to_children (bool): [Read-Only] Propagate to Children: If set to true all of the global transforms of the children of this bone will be recalculated based on their local transforms. Note: This is computationally more expensive than turning it off.

  • rotation_ease_type (ControlRigAnimEasingType): [Read-Only] Rotation Ease Type: The easing to use between to rotations.

  • rotations (Array[RigUnit_FitChainToCurve_Rotation]): [Read-Write] Rotations: The list of rotations to be applied along the curve

  • sampling_precision (int32): [Read-Only] Sampling Precision: The number of samples to use on the curve. Clamped at 64.

  • secondary_axis (Vector): [Read-Write] Secondary Axis: The minor axis being aligned - towards the pole vector. You can use (0.0, 0.0, 0.0) to disable it.

  • weight (float): [Read-Write] Weight: The weight of the solver - how much the rotation should be applied

property alignment: ControlRigCurveAlignment

[Read-Only] Alignment: Specifies how to align the chain on the curve

Type:

(ControlRigCurveAlignment)

property bezier: CRFourPointBezier

[Read-Write] Bezier: The curve to align to

Type:

(CRFourPointBezier)

property debug_settings: RigUnit_FitChainToCurve_DebugSettings

[Read-Write] Debug Settings

Type:

(RigUnit_FitChainToCurve_DebugSettings)

property items: RigElementKeyCollection

[Read-Write] Items: The items to align

Type:

(RigElementKeyCollection)

property maximum: float

[Read-Only] Maximum: The maximum U value to use on the curve

Type:

(float)

property minimum: float

[Read-Only] Minimum: The minimum U value to use on the curve

Type:

(float)

property pole_vector_position: Vector

[Read-Write] Pole Vector Position: The the position of the pole vector used for aligning the secondary axis. Only has an effect if the secondary axis is set.

Type:

(Vector)

property primary_axis: Vector

[Read-Write] Primary Axis: The major axis being aligned - along the bone

Type:

(Vector)

property propagate_to_children: bool

[Read-Only] Propagate to Children: If set to true all of the global transforms of the children of this bone will be recalculated based on their local transforms. Note: This is computationally more expensive than turning it off.

Type:

(bool)

property rotation_ease_type: ControlRigAnimEasingType

[Read-Only] Rotation Ease Type: The easing to use between to rotations.

Type:

(ControlRigAnimEasingType)

property rotations: Array[RigUnit_FitChainToCurve_Rotation]

[Read-Write] Rotations: The list of rotations to be applied along the curve

Type:

(Array[RigUnit_FitChainToCurve_Rotation])

property sampling_precision: int

[Read-Only] Sampling Precision: The number of samples to use on the curve. Clamped at 64.

Type:

(int32)

property secondary_axis: Vector

[Read-Write] Secondary Axis: The minor axis being aligned - towards the pole vector. You can use (0.0, 0.0, 0.0) to disable it.

Type:

(Vector)

property weight: float

[Read-Write] Weight: The weight of the solver - how much the rotation should be applied

Type:

(float)