Class Bone2D

A joint used with Skeleton2D to control and animate other nodes.

Inheritance

Node2D

CanvasItem

Node

Object

Bone2D

Remarks

A hierarchy of Bone2Ds can be bound to a Skeleton2D to control and animate other Node2D nodes.

You can use Bone2D and Skeleton2D nodes 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

rest

Rest transform of the bone. You can reset the node's transforms to this value using apply_rest.

var rest : Transform2D = Transform2D(0, 0, 0, 0, 0, 0)

Property Value

Transform2D

Remarks

• void set_rest(Transform2D value)
• Transform2D get_rest

Methods

apply_rest

Resets the bone to the rest pose. This is equivalent to setting transform to rest.

void apply_rest

get_autocalculate_length_and_angle

Qualifiers: const

Returns whether this Bone2D is going to autocalculate its length and bone angle using its first Bone2D child node, if one exists. If there are no Bone2D children, then it cannot autocalculate these values and will print a warning.

bool get_autocalculate_length_and_angle

get_bone_angle

Qualifiers: 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 transform.

float get_bone_angle

get_index_in_skeleton

Qualifiers: const

Returns the node's index as part of the entire skeleton. See Skeleton2D.

int get_index_in_skeleton

get_length

Qualifiers: const

Returns the length of the bone in the Bone2D node.

float get_length

get_skeleton_rest

Qualifiers: const

Returns the node's rest Transform2D if it doesn't have a parent, or its rest pose relative to its parent.

Transform2D get_skeleton_rest

set_autocalculate_length_and_angle(bool)

When set to true, the Bone2D node will attempt to automatically calculate the bone angle and length using the first child Bone2D node, if one exists. If none exist, the Bone2D cannot automatically calculate these values and will print a warning.

void set_autocalculate_length_and_angle(bool auto_calculate)

Parameters

auto_calculate bool

set_bone_angle(float)

Sets the bone angle for the Bone2D. This is typically set to the rotation from the Bone2D to a child Bone2D node.

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 transform.

void set_bone_angle(float angle)

Parameters

angle float

set_length(float)

Sets the length of the bone in the Bone2D.

void set_length(float length)

Parameters

length float