ranim-core 0.2.0

The core library 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
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91

use glam::DVec3;

use crate::anchor::{Aabb, AabbPoint, Locate};

/// Shifting operations.
///
/// This trait is automatically implemented for [`DVec3`] and `[T]` where `T: ShiftTransform`.
pub trait ShiftTransform {
    /// Shift the item by a given vector.
    fn shift(&mut self, offset: DVec3) -> &mut Self;
}

impl ShiftTransform for DVec3 {
    fn shift(&mut self, shift: DVec3) -> &mut Self {
        *self += shift;
        self
    }
}

impl<T: ShiftTransformExt> ShiftTransform for [T] {
    fn shift(&mut self, shift: DVec3) -> &mut Self {
        self.iter_mut().for_each(|x| {
            x.shift(shift);
        });
        self
    }
}

impl<T: ShiftTransformExt> ShiftTransform for Vec<T> {
    fn shift(&mut self, shift: DVec3) -> &mut Self {
        self.as_mut_slice().shift(shift);
        self
    }
}

/// Useful extensions for shifting operations.
///
/// This trait is implemented automatically for types that implement [`ShiftTransform`], you should not implement it yourself.
pub trait ShiftTransformExt: ShiftTransform {
    /// Do something with the origin of the item.
    ///
    /// See [`crate::anchor`]'s [`Locate`] for more details.
    fn with_origin(&mut self, p: impl Locate<Self>, f: impl FnOnce(&mut Self)) -> &mut Self {
        let p = p.locate(self);
        self.shift(-p);
        f(self);
        self.shift(p)
    }
    /// Put anchor at a given point.
    ///
    /// See [`crate::anchor`]'s [`Locate`] for more details.
    fn move_anchor_to<A>(&mut self, anchor: A, point: DVec3) -> &mut Self
    where
        A: Locate<Self>,
    {
        self.shift(point - anchor.locate(self));
        self
    }
    /// Put pivot at a given point.
    fn move_to(&mut self, point: DVec3) -> &mut Self
    where
        AabbPoint: Locate<Self>,
    {
        self.move_anchor_to(AabbPoint::CENTER, point)
    }
    /// Put negative anchor of self on anchor of target
    fn move_next_to<T: Aabb + ?Sized>(&mut self, target: &T, anchor: AabbPoint) -> &mut Self
    where
        AabbPoint: Locate<Self>,
    {
        self.move_next_to_padded(target, anchor, 0.0)
    }
    /// Put negative anchor of self on anchor of target, with a distance of `padding`
    fn move_next_to_padded<T: Aabb + ?Sized>(
        &mut self,
        target: &T,
        anchor: AabbPoint,
        padding: f64,
    ) -> &mut Self
    where
        AabbPoint: Locate<Self>,
    {
        let neg_anchor = AabbPoint(-anchor.0);
        self.move_anchor_to(
            neg_anchor,
            Locate::<T>::locate(&anchor, target) + anchor.0.normalize() * padding,
        )
    }
}

impl<T: ShiftTransform + ?Sized> ShiftTransformExt for T {}