• Tween - 两个值之间的简单缓动（缓和）动画。
• Sequence - 一系列依次执行的缓动。
• Tracks - 一系列并行执行的缓动。
• Delay - 时间延迟。

大多数缓动都可以通过 then() 操作符进行链式调用

// Produce a sequence executing 'tween1' then 'tween2'
let tween1 = Tween { [...] }
let tween2 = Tween { [...] }
let seq = tween1.then(tween2);

预定义的镜头

对于最常用的用例，提供了一些预定义的镜头，这些镜头也作为示例。强烈建议用户编写自己的镜头，以便根据他们的用例调整动画。

预定义镜头的命名方案为 "<TargetName><FieldName>Lens"，其中 <TargetName> 是要修改的内部动画系统查询的目标 Bevy 组件或资产类型的名称，而 <FieldName> 是由镜头就地修改的字段。所有预定义的镜头都修改单个字段。可以编写修改多个字段的自定义镜头。

Bevy 组件

¹ 通过 Quat::slerp() 使用最短路径插值在两个旋转之间。

² 基于角度的插值，适用于超过半圈的旋转。

有关旋转镜头的比较，请参阅 详情。

Bevy 资产

资产动画始终需要 bevy_asset 功能。

自定义透镜

自定义透镜允许动画化 Bevy 组件或资产的任何字段或字段组。自定义透镜是实现 Lens 特质的类型，它是组件或资产类型的泛型。

struct MyXAxisLens {
    start: f32,
    end: f32,
}

impl Lens<Transform> for MyXAxisLens {
    fn lerp(&mut self, target: &mut Transform, ratio: f32) {
        let start = Vec3::new(self.start, 0., 0.);
        let end = Vec3::new(self.end, 0., 0.);
        target.translation = start + (end - start) * ratio;
    }
}

请注意，透镜始终以 线性 的方式插值组件或资产的字段。应用的缓动类型会改变 ratio 参数演变的速率，并在调用 lerp() 函数之前应用。

lerp（线性插值）的基本公式可以是以下两种之一

• 开始+ (结束-开始) *标量
• 开始* (1.0 -标量) +结束*标量

这两种公式在数学上是等价的，但根据要插值的类型、可用的操作以及潜在的浮点精度误差，其中一种可能比另一种更适合。

自定义组件支持

自定义组件通过类似于 Bevy 组件 中描述的自定义透镜进行动画化。

#[derive(Component)]
struct MyCustomComponent(f32);

struct MyCustomLens {
    start: f32,
    end: f32,
}

impl Lens<MyCustomComponent> for MyCustomLens {
    fn lerp(&mut self, target: &mut MyCustomComponent, ratio: f32) {
        target.0 = self.start + (self.end - self.start) * ratio;
    }
}

然后，还需要添加 component_animator_system::<CustomComponent> 系统到应用程序中，如 系统设置 中所述。此系统将提取每个帧上具有相同实体的所有 CustomComponent 实例，并通过其动画器对其组件进行动画化。

自定义资产支持

过程与自定义组件类似，为自定义资产创建自定义透镜。需要添加的系统是 asset_animator_system::<CustomAsset>，如 系统设置 中所述。这需要 bevy_asset 功能（默认启用）。

示例

请参阅 examples/ 文件夹。

菜单

cargo run --example menu --features="bevy/bevy_winit"

精灵颜色

cargo run --example sprite_color --features="bevy/bevy_winit"

变换旋转

cargo run --example transform_rotation --features="bevy/bevy_winit"

变换平移

cargo run --example transform_translation --features="bevy/bevy_winit"

颜色材质颜色

cargo run --example colormaterial_color --features="bevy/bevy_winit"

UI 位置

cargo run --example ui_position --features="bevy/bevy_winit"

序列

cargo run --example sequence --features="bevy/bevy_winit"

缓动函数

提供了许多 缓动函数

• 二次内
• 二次外
• 二次内外
• 三次内
• 三次外
• 三次内外
• 四次内
• 四次外
• 四次内外
• 五次内
• 五次外
• 五次内外
• 正弦内
• 正弦外
• 正弦内外
• 圆形内
• 圆形外
• 圆形内外
• 指数内
• 指数外
• 指数内外
• 弹性内
• 弹性外
• 弹性内外
• 回弹内
• 回弹外
• 回弹内外
• 弹跳内
• 弹跳外
• 弹跳内外

兼容的 Bevy 版本

main 分支与最新的 Bevy 版本兼容。

bevy_tweening 版本的兼容性

由于 Bevy 发展迅速且经常进行破坏性更改，以及维护 🍃 Bevy Tweening 的资源有限，因此不支持（未发布）的 main Bevy 分支。然而，每次新的 bevy 发布后，都会升级 bevy_tweening crate 以支持新发布的版本。

与 bevy_easings 的比较

bevy_tweening 库最初是 François Mocker 的 bevy_easings 库的分支，目的是

• 探索基于透镜而不是通用类型的替代设计，以用于每个easer/animator。这减少了所需的通用类型数量，并有望减少代码大小，以及执行插值所需系统的数量。
• 改进资产插值以避免像bevy_easings那样创建许多副本，而是原地修改资产（以及，通过相似性，组件）而不进行复制。原地修改还允许更优化的插值，仅修改感兴趣的领域，而不是在每帧创建整个组件的新副本。