AnimationNodeBlendSpace1D

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

一组放置在一个虚拟轴上的 AnimationRootNode，在两个相邻节点之间交叉淡化。被 AnimationTree 使用。

描述

AnimationNodeBlendSpace1D 代表一个虚拟轴，可以使用 add_blend_point() 在上面添加任何类型的 AnimationRootNode。输出的是最接近当前值的两个 AnimationRootNode 之间的线性混合。

可以使用 min_space 和 max_space 来扩展轴的范围。

教程

使用 AnimationTree

属性

BlendMode	blend_mode	`0`
float	max_space	`1.0`
float	min_space	`-1.0`
float	snap	`0.1`
bool	sync	`false`
String	value_label	`"value"`

方法

void	add_blend_point(node: AnimationRootNode, pos: float, at_index: int = -1)
int	get_blend_point_count() const
AnimationRootNode	get_blend_point_node(point: int) const
float	get_blend_point_position(point: int) const
void	remove_blend_point(point: int)
void	set_blend_point_node(point: int, node: AnimationRootNode)
void	set_blend_point_position(point: int, pos: float)

枚举

enum BlendMode: 🔗

BlendMode BLEND_MODE_INTERPOLATED = 0

动画之间的插值是线性的。

BlendMode BLEND_MODE_DISCRETE = 1

混合空间播放混合位置最接近的动画节点的动画。可用于逐帧的 2D 动画。

BlendMode BLEND_MODE_DISCRETE_CARRY = 2

类似于 BLEND_MODE_DISCRETE，但在最后一个动画的播放位置开始新的动画。

属性说明

BlendMode blend_mode = 0 🔗

void set_blend_mode(value: BlendMode)
BlendMode get_blend_mode()

控制动画之间的插值。

float max_space = 1.0 🔗

void set_max_space(value: float)
float get_max_space()

用于点位置的混合空间轴的上限。见 add_blend_point()。

float min_space = -1.0 🔗

void set_min_space(value: float)
float get_min_space()

用于点位置的混合空间轴的下限。见 add_blend_point()。

float snap = 0.1 🔗

void set_snap(value: float)
float get_snap()

当在轴上移动一个点时，要捕捉到的位置增量。

bool sync = false 🔗

void set_use_sync(value: bool)
bool is_using_sync()

如果为 false，则当混合值为 0 时，停止混合动画的帧。

如果为 true，则强制混合动画以前进帧。

String value_label = "value" 🔗

void set_value_label(value: String)
String get_value_label()

混合空间虚拟轴的标签。

方法说明

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

在虚拟轴上 pos 设定的给定位置添加一个代表 node 的新点。你可以使用 at_index 参数将其插入到特定的索引处。如果使用 at_index 的默认值，这个点会被插入到混合点数组的末尾。

int get_blend_point_count() const 🔗

返回混合轴上的点的数量。

AnimationRootNode get_blend_point_node(point: int) const 🔗

返回索引 point 处的点所引用的 AnimationNode。

float get_blend_point_position(point: int) const 🔗

返回索引 point 处的点的位置。

void remove_blend_point(point: int) 🔗

从混合轴移除索引 point 处的点。

void set_blend_point_node(point: int, node: AnimationRootNode) 🔗

更改索引 point 处的点所引用的 AnimationNode。

void set_blend_point_position(point: int, pos: float) 🔗

更新混合轴上索引 point 处的点的位置。