Elaphos-Animation-Toolkit
An animation toolkit written in Rust using the Bevy game engine.
Features
- Event and Tag based animation of objects
- Translation animation
- Rotation animation
- Fading of sprites and text
- Changing of background colour
What can this be used for
I wrote this library to use for interactive video animations.
This uses the Bevy game engine to perform the animations.
I can also imagine this being used for in game animations, if you use the Bevy game engine.
Future goals
- More animations/animation options (e.g. acceleration and deceleration for objects)
- Data driven animations
- E.g. a toml/json file containing the objects in the scene with their initial parameters and the animation steps.
- Based on the data driven animation tooling maybe a visual editor
Example
```rust
use bevy::{
corepipeline::{bloom::BloomSettings, tonemapping::Tonemapping},
prelude::*,
text::Text,
};
use elaphos::animation::{ElaphosAnimationEvent, ElaphosDefaultPlugins, ObjectLabel};
use elaphos::changebackground::BackgroundEvent;
use elaphos::fade::FadeEvent;
use elaphos::movement::{RotateEvent, RotationType, TranslateEvent, TranslationType};
[derive(Resource)]
struct Counter(u32);
fn main() {
App::new()
.insertresource(ClearColor(Color::rgb(0.05, 0.05, 0.05)))
.addplugins(DefaultPlugins)
.addplugin(ElaphosDefaultPlugins)
.insertresource(Counter(0))
.addevent::()
.addstartupsystem(setup)
.addsystem(animation_sequence)
.run();
}
fn setup(mut commands: Commands, assetserver: Res) {
commands.spawn((
Camera2dBundle {
camera: Camera {
hdr: true,
..default()
},
tonemapping: Tonemapping::TonyMcMapface,
..default()
},
BloomSettings::default(),
));
let font = assetserver.load("./fonts/anodina/Anodina-Bold.otf");
let textstyle = TextStyle {
font,
fontsize: 60.0,
color: Color::rgb(0.0, 0.5, 0.0),
};
let textalignment = TextAlignment::Center;
// Spawn a text bundle with the ObjectLabel "Elaphos"
commands.spawn((
Text2dBundle {
text: Text::fromsection("Elaphos", textstyle.clone()).withalignment(textalignment),
transform: Transform::fromxyz(30.0, 0.0, 0.0),
..default()
},
ObjectLabel("Elaphos".tostring()),
));
// Spawn a Sprite with a texture and the ObjectLabel "Box"
commands.spawn((
SpriteBundle {
texture: assetserver.load("basics/uirect.png"),
transform: Transform::fromxyz(0.0, -900.0, 0.0).withscale(Vec3::splat(0.8)),
..default()
},
ObjectLabel("Box".tostring()),
));
}
fn animationsequence(
mut counter: ResMut,
mut animationevents: EventWriter,
keys: Res>,
) {
if keys.justpressed(KeyCode::Space) {
match counter.asref() {
Counter(0) => {
// Fade out the text
animationevents.send(ElaphosAnimationEvent::Fade(FadeEvent {
speed: 10.0,
label: ObjectLabel("Elaphos".tostring()),
}));
// Move up the box into the field
animationevents.send(ElaphosAnimationEvent::Translate(TranslateEvent {
waypoints: vec![Vec3 {
x: 0.0,
y: 450.0,
z: 0.0,
}],
speed: 600.0,
movementtype: TranslationType::LinearRelative,
label: ObjectLabel("Box".tostring()),
}));
// Change the background color to a dark blue
animationevents.send(ElaphosAnimationEvent::Background(BackgroundEvent {
speed: 1.0,
color: Color::NAVY,
}));
}
Counter(1) => {
// Fade the text basck in (denoted by the minus sign in front of the speed)
animationevents.send(ElaphosAnimationEvent::Fade(FadeEvent {
speed: -10.0,
label: ObjectLabel("Elaphos".tostring()),
}));
}
Counter(2) => {
// Fade out the box
animationevents.send(ElaphosAnimationEvent::Fade(FadeEvent {
speed: 10.0,
label: ObjectLabel("Box".tostring()),
}));
}
Counter(_) => {}
}
counter.0 += 1;
}
}
```