Bone2D
Inherits: Spatial2D < CanvasItem < Actor < Object
A joint used with Skeleton2D to control and animate other actors.
Description
Section titled “Description”A hierarchy of Bone2Ds can be bound to a Skeleton2D to control and animate other Spatial2D actors.
You can use Bone2D and Skeleton2D actors to animate 2D meshes created with the Polygon2D UV editor.
Each bone has a rest transform that you can reset to with apply_rest(). These rest poses are relative to the bone’s parent.
If in the editor, you can set the rest pose of an entire skeleton using a menu option, from the code, you need to iterate over the bones to set their individual rest poses.
Properties
Section titled “Properties”| Type | Name | Default |
|---|---|---|
| Transform2D | rest | Transform2D(0, 0, 0, 0, 0, 0) |
Methods
Section titled “Methods”| Returns | Method |
|---|---|
| void | apply_rest() |
| bool | get_autocalculate_length_and_angle() |
| float | get_bone_angle() |
| int | get_index_in_skeleton() |
| float | get_length() |
| Transform2D | get_skeleton_rest() |
| void | set_autocalculate_length_and_angle(auto_calculate) |
| void | set_bone_angle(angle) |
| void | set_length(length) |
Property descriptions
Section titled “Property descriptions”Transform2D rest = Transform2D(0, 0, 0, 0, 0, 0)
Setter/getter: set_rest(), get_rest()
Rest transform of the bone. You can reset the actor’s transforms to this value using apply_rest().
Method descriptions
Section titled “Method descriptions”apply_rest
Section titled “apply_rest”void apply_rest()
Resets the bone to the rest pose. This is equivalent to setting Spatial2D.transform to rest.
get_autocalculate_length_and_angle
Section titled “get_autocalculate_length_and_angle”bool get_autocalculate_length_and_angle() const
Returns whether this Bone2D is going to autocalculate its length and bone angle using its first Bone2D child actor, if one exists. If there are no Bone2D children, then it cannot autocalculate these values and will print a warning.
get_bone_angle
Section titled “get_bone_angle”float get_bone_angle() const
Returns the angle of the bone in the Bone2D.
Note: This is different from the Bone2D’s rotation. The bone’s angle is the rotation of the bone shown by the gizmo, which is unaffected by the Bone2D’s Spatial2D.transform.
get_index_in_skeleton
Section titled “get_index_in_skeleton”int get_index_in_skeleton() const
Returns the actor’s index as part of the entire skeleton. See Skeleton2D.
get_length
Section titled “get_length”float get_length() const
Returns the length of the bone in the Bone2D actor.
get_skeleton_rest
Section titled “get_skeleton_rest”Transform2D get_skeleton_rest() const
Returns the actor’s rest Transform2D if it doesn’t have a parent, or its rest pose relative to its parent.
set_autocalculate_length_and_angle
Section titled “set_autocalculate_length_and_angle”void set_autocalculate_length_and_angle(auto_calculate: bool)
When set to true, the Bone2D actor will attempt to automatically calculate the bone angle and length using the first child Bone2D actor, if one exists. If none exist, the Bone2D cannot automatically calculate these values and will print a warning.
set_bone_angle
Section titled “set_bone_angle”void set_bone_angle(angle: float)
Sets the bone angle for the Bone2D. This is typically set to the rotation from the Bone2D to a child Bone2D actor.
Note: This is different from the Bone2D’s rotation. The bone’s angle is the rotation of the bone shown by the gizmo, which is unaffected by the Bone2D’s Spatial2D.transform.
set_length
Section titled “set_length”void set_length(length: float)
Sets the length of the bone in the Bone2D.