ranim-anims 0.2.1

The built-in animations of Ranim.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74

use ranim_core::{
    animation::{AnimationCell, Eval},
    glam::DVec3,
    traits::{Aabb, AabbPoint, Locate, RotateTransform, ShiftTransformExt},
    utils::rate_functions::smooth,
};

// MARK: Require Trait
/// The requirement of [`RotatingAnimation`]
pub trait RotatingRequirement: RotateTransform + ShiftTransformExt + Clone {}
impl<T: RotateTransform + ShiftTransformExt + Clone> RotatingRequirement for T {}

// MARK: Anim Trait
/// The methods to create rotation animations for `T` that satisfies [`RotatingRequirement`]
pub trait RotatingAnim: RotatingRequirement + Sized + 'static {
    /// Rotate by a given angle about a given axis at center.
    fn rotating(&mut self, angle: f64, axis: DVec3) -> AnimationCell<Self>
    where
        Self: Aabb,
    {
        self.rotating_at(angle, axis, AabbPoint::CENTER)
    }

    /// Rotate by a given angle about a given axis at the given anchor.
    fn rotating_at<A: Locate<Self>>(
        &mut self,
        angle: f64,
        axis: DVec3,
        anchor: A,
    ) -> AnimationCell<Self> {
        RotatingAnimation::new(self.clone(), angle, axis, anchor.locate(self))
            .into_animation_cell()
            .with_rate_func(smooth)
            .apply_to(self)
    }
}

impl<T: RotatingRequirement + 'static> RotatingAnim for T {}

// MARK: Impl

/// Rotation animation.
///
/// Unlike [`Morph`](crate::morph::Morph) which linearly interpolates between
/// start and end states, this animation applies incremental rotation at each frame,
/// producing a true circular arc motion.
pub struct RotatingAnimation<T: RotatingRequirement> {
    src: T,
    angle: f64,
    axis: DVec3,
    point: DVec3,
}

impl<T: RotatingRequirement> RotatingAnimation<T> {
    /// Constructor
    pub fn new(src: T, angle: f64, axis: DVec3, point: DVec3) -> Self {
        Self {
            src,
            angle,
            axis,
            point,
        }
    }
}

impl<T: RotatingRequirement> Eval<T> for RotatingAnimation<T> {
    fn eval_alpha(&self, alpha: f64) -> T {
        let mut result = self.src.clone();
        result.with_origin(self.point, |x| {
            x.rotate_on_axis(self.axis, self.angle * alpha);
        });
        result
    }
}