AnimationNodeBlendSpace1D

继承： AnimationRootNode < AnimationNode < Resource < RefCounted < Object

A set of AnimationRootNode s placed on a virtual axis, crossfading between the two adjacent ones. Used by AnimationTree.

描述

A resource used by AnimationNodeBlendTree.

AnimationNodeBlendSpace1D represents a virtual axis on which any type of AnimationRootNode s can be added using add_blend_point. Outputs the linear blend of the two AnimationRootNode s adjacent to the current value.

You can set the extents of the axis with min_space and max_space.

属性
BlendModeblend_mode
floatmax_space
floatmin_space
floatsnap
boolsync
Stringvalue_label

方法
voidadd_blend_point ( node: AnimationRootNode, pos: float, at_index: int = -1 )
intget_blend_point_count ( ) const1
AnimationRootNodeget_blend_point_node ( point: int ) const1
floatget_blend_point_position ( point: int ) const1
voidremove_blend_point ( point: int )
voidset_blend_point_node ( point: int, node: AnimationRootNode )
voidset_blend_point_position ( point: int, pos: float )

枚举

enum BlendMode:

BlendMode BLEND_MODE_INTERPOLATED = 0

The interpolation between animations is linear.

BlendMode BLEND_MODE_DISCRETE = 1

The blend space plays the animation of the animation node which blending position is closest to. Useful for frame-by-frame 2D animations.

BlendMode BLEND_MODE_DISCRETE_CARRY = 2

Similar to BLEND_MODE_DISCRETE, but starts the new animation at the last animation's playback position.

属性说明

BlendMode blend_mode = 0

Controls the interpolation between animations. See BlendMode constants.

float max_space = 1.0

  • void set_max_space ( value: float )
  • float get_max_space ( )

The blend space's axis's upper limit for the points' position. See add_blend_point.

float min_space = -1.0

  • void set_min_space ( value: float )
  • float get_min_space ( )

The blend space's axis's lower limit for the points' position. See add_blend_point.

float snap = 0.1

  • void set_snap ( value: float )
  • float get_snap ( )

Position increment to snap to when moving a point on the axis.

bool sync = false

  • void set_use_sync ( value: bool )
  • bool is_using_sync ( )

If false, the blended animations' frame are stopped when the blend value is 0.

If true, forcing the blended animations to advance frame.

String value_label = "value"

  • void set_value_label ( value: String )
  • String get_value_label ( )

Label of the virtual axis of the blend space.

方法说明

void add_blend_point ( node: AnimationRootNode, pos: float, at_index: int = -1 )

Adds a new point that represents a node on the virtual axis at a given 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.

int get_blend_point_count ( ) const1

Returns the number of points on the blend axis.

AnimationRootNode get_blend_point_node ( point: int ) const1

Returns the AnimationNode referenced by the point at index point.

float get_blend_point_position ( point: int ) const1

Returns the position of the point at index point.

void remove_blend_point ( point: int )

Removes the point at index point from the blend axis.

void set_blend_point_node ( point: int, node: AnimationRootNode )

Changes the AnimationNode referenced by the point at index point.

void set_blend_point_position ( point: int, pos: float )

Updates the position of the point at index point on the blend axis.

2

本方法通常需要用户覆盖才能生效。

1

本方法无副作用，不会修改该实例的任何成员变量。

3

本方法除了能接受在此处描述的参数外，还能够继续接受任意数量的参数。

4

本方法用于构造某个类型。

5

调用本方法无需实例，可直接使用类名进行调用。

6

本方法描述的是使用本类型作为左操作数的有效运算符。

7

这个值是由下列位标志构成位掩码的整数。

8

无返回值。