unreal.IKRig_FBIKEffector

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

Bases: Object

IKRig FBIKEffector

C++ Source:

  • Plugin: IKRig

  • Module: IKRig

  • File: IKRig_FBIKSolver.h

Editor Properties: (see get_editor_property/set_editor_property)

  • bone_name (Name): [Read-Only] The bone that this effector will pull on.

  • goal_name (Name): [Read-Only] The Goal that is driving this effector’s transform.

  • pin_rotation (float): [Read-Write] Range 0-1 (default is 1.0). Blends the effector bone rotation between the rotation of the effector transform (1.0) and the rotation of the input bone (0.0).

  • pull_chain_alpha (float): [Read-Write] Range 0-1 (default is 1.0). When enabled (greater than 0.0), the solver internally partitions the skeleton into ‘chains’ which extend from the effector to the nearest fork in the skeleton. These chains are pre-rotated and translated, as a whole, towards the effector targets. This can improve the results for sparse bone chains, and significantly improve convergence on dense bone chains. But it may cause undesirable results in highly constrained bone chains (like robot arms).

  • strength_alpha (float): [Read-Write] Range 0-1 (default is 1.0). The strength of the effector when pulling the bone towards it’s target location. At 0.0, the effector does not pull at all, but the bones between the effector and the root will still slightly resist motion from other effectors. This can thus act as a “stabilizer” for parts of the body that you do not want to behave in a pure FK fashion.

property bone_name: Name

[Read-Only] The bone that this effector will pull on.

Type:

(Name)

property goal_name: Name

[Read-Only] The Goal that is driving this effector’s transform.

Type:

(Name)

property pin_rotation: float

[Read-Write] Range 0-1 (default is 1.0). Blends the effector bone rotation between the rotation of the effector transform (1.0) and the rotation of the input bone (0.0).

Type:

(float)

property pull_chain_alpha: float

[Read-Write] Range 0-1 (default is 1.0). When enabled (greater than 0.0), the solver internally partitions the skeleton into ‘chains’ which extend from the effector to the nearest fork in the skeleton. These chains are pre-rotated and translated, as a whole, towards the effector targets. This can improve the results for sparse bone chains, and significantly improve convergence on dense bone chains. But it may cause undesirable results in highly constrained bone chains (like robot arms).

Type:

(float)

property strength_alpha: float

[Read-Write] Range 0-1 (default is 1.0). The strength of the effector when pulling the bone towards it’s target location. At 0.0, the effector does not pull at all, but the bones between the effector and the root will still slightly resist motion from other effectors. This can thus act as a “stabilizer” for parts of the body that you do not want to behave in a pure FK fashion.

Type:

(float)