A set of AnimationRootNodes placed on 2D coordinates, crossfading between the three adjacent ones. Used by AnimationTree.
A resource used by AnimationNodeBlendTree.
AnimationNodeBlendSpace2D represents a virtual 2D space on which AnimationRootNodes are placed. Outputs the linear blend of the three adjacent animations using a Vector2 weight. Adjacent in this context means the three AnimationRootNodes making up the triangle that contains the current value.
You can add vertices to the blend space with add_blend_point() and automatically triangulate it by setting auto_triangles to true. Otherwise, use add_triangle() and remove_triangle() to triangulate the blend space by hand.
If true, the blend space is triangulated automatically. The mesh updates every time you add or remove points with add_blend_point() and remove_blend_point().
The cycle length in seconds used by SYNC_MODE_CYCLIC_CONSTANT. All animations are time-scaled so they complete one full cycle in this duration. Must be greater than 0 for cyclic sync to take effect.
The blend space's X and Y axes' upper limit for the points' position. See add_blend_point().
The blend space's X and Y axes' lower limit for the points' position. See add_blend_point().
If true, sync mode is enabled (equivalent to SYNC_MODE_INDEPENDENT). This property is kept for backward compatibility.
Controls how animations are synced when blended. See SyncMode for available options.
Adds a new point with name that represents a node at the position set by pos. You can insert it at a specific index using the at_index argument. If you use the default value for at_index, the point is inserted at the end of the blend points array.
Note: If no name is provided, safe index is used as reference. In the future, empty names will be deprecated, so explicitly passing a name is recommended.
Creates a new triangle using three points x, y, and z. Triangles can overlap. You can insert the triangle at a specific index using the at_index argument. If you use the default value for at_index, the point is inserted at the end of the blend points array.
Returns the index of the blend point with the given name. Returns -1 if no blend point with that name is found.
Returns the AnimationRootNode referenced by the point at index point.
Swaps the blend points at indices from_index and to_index, exchanging their positions and properties.
Sets the name of the blend point at index point. If the name conflicts with an existing point, a unique name will be generated automatically.
Changes the AnimationNode referenced by the point at index point.
Emitted every time the blend space's triangles are created, removed, or when one of their vertices changes position.
BLEND_MODE_INTERPOLATED = 0The interpolation between animations is linear.
BLEND_MODE_DISCRETE = 1The blend space plays the animation of the animation node which blending position is closest to. Useful for frame-by-frame 2D animations.
BLEND_MODE_DISCRETE_CARRY = 2Similar to BLEND_MODE_DISCRETE, but starts the new animation at the last animation's playback position.
SYNC_MODE_NONE = 0Inactive animations are frozen and do not advance.
SYNC_MODE_INDEPENDENT = 1Inactive animations advance with a weight of 0. This is equivalent to the previous sync = true behavior.
SYNC_MODE_CYCLIC_MUTABLE = 2All animations are time-scaled so they stay in sync, with the cycle length dynamically computed from active blend weights. This is self-normalizing: a solo animation plays at normal speed.
Note: If you apply AnimationNodeTimeSeek to the result when handling animations of different lengths, synchronization will be broken. In such cases, it is recommended to use AnimationNodeAnimation.use_custom_timeline to align the animation lengths.
SYNC_MODE_CYCLIC_CONSTANT = 3All animations are time-scaled so they complete one cycle in cyclic_length seconds, keeping them in sync regardless of their individual lengths.
Note: If you apply AnimationNodeTimeSeek to the result when handling animations of different lengths, synchronization will be broken. In such cases, it is recommended to use AnimationNodeAnimation.use_custom_timeline to align the animation lengths.