scena 1.0.2

A Rust-native scene-graph renderer with typed scene state, glTF assets, and explicit prepare/render lifecycles.
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
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121

//! Stage D2: Vec3, Quat, and Transform now delegate to the `glam` crate.
//! `glam` is the industry-standard Rust 3D math library — SIMD-optimized,
//! battle-tested across bevy/rend3/wgpu-rs ecosystems, and offers complete
//! operator overloads + a wide cross product / dot / normalize surface.
//! Replacing scena's hand-rolled Vec3/Quat means every math op is shared
//! with the broader Rust 3D world instead of being a private
//! reimplementation that might subtly disagree at edges.
//!
//! Public type names are preserved as `pub use` re-exports so downstream
//! code that constructs `Vec3 { x, y, z }` literals, calls `Vec3::new(...)`,
//! or accesses `.x`/`.y`/`.z`/`.w` continues to work — glam exposes the
//! same field layout and the same constructors.

pub use glam::{Quat, Vec3};

#[derive(Debug, Clone, Copy, PartialEq)]
pub struct Transform {
    pub translation: Vec3,
    pub rotation: Quat,
    pub scale: Vec3,
}

#[derive(Debug, Clone, Copy, PartialEq)]
pub struct Angle {
    radians: f32,
}

impl Transform {
    pub const IDENTITY: Self = Self {
        translation: Vec3::ZERO,
        rotation: Quat::IDENTITY,
        scale: Vec3::ONE,
    };

    pub const fn at(translation: Vec3) -> Self {
        Self {
            translation,
            rotation: Quat::IDENTITY,
            scale: Vec3::ONE,
        }
    }

    pub const fn with_translation(mut self, translation: Vec3) -> Self {
        self.translation = translation;
        self
    }

    pub const fn scale_by(mut self, scale: f32) -> Self {
        self.scale = Vec3::new(scale, scale, scale);
        self
    }

    /// Composes a degrees-around-X rotation onto the existing rotation, so
    /// that `Transform::default().rotate_y_deg(90.0).rotate_x_deg(45.0)`
    /// yields the chained rotation Y(90°) ∘ X(45°) instead of silently
    /// discarding the prior rotation. Closes scena-api-ergonomics-reviewer
    /// finding F2.
    pub fn rotate_x_deg(mut self, degrees: f32) -> Self {
        let added = Quat::from_axis_angle(
            Vec3::new(1.0, 0.0, 0.0),
            Angle::from_degrees(degrees).radians(),
        );
        self.rotation = compose_rotations(self.rotation, added);
        self
    }

    /// Composes a degrees-around-Y rotation onto the existing rotation. See
    /// [`Self::rotate_x_deg`] for the compose semantics.
    pub fn rotate_y_deg(mut self, degrees: f32) -> Self {
        let added = Quat::from_axis_angle(
            Vec3::new(0.0, 1.0, 0.0),
            Angle::from_degrees(degrees).radians(),
        );
        self.rotation = compose_rotations(self.rotation, added);
        self
    }

    /// Composes a degrees-around-Z rotation onto the existing rotation. See
    /// [`Self::rotate_x_deg`] for the compose semantics.
    pub fn rotate_z_deg(mut self, degrees: f32) -> Self {
        let added = Quat::from_axis_angle(
            Vec3::new(0.0, 0.0, 1.0),
            Angle::from_degrees(degrees).radians(),
        );
        self.rotation = compose_rotations(self.rotation, added);
        self
    }
}

/// Multiply two quaternions and re-normalize the result. glam's `*`
/// operator multiplies without normalizing; scena keeps quaternion
/// magnitudes bounded so floating-point drift across many composed
/// rotations doesn't accumulate.
fn compose_rotations(base: Quat, added: Quat) -> Quat {
    let product = base * added;
    let length_sq = product.length_squared();
    if length_sq <= f32::EPSILON || !length_sq.is_finite() {
        return Quat::IDENTITY;
    }
    product.normalize()
}

impl Default for Transform {
    fn default() -> Self {
        Self::IDENTITY
    }
}

impl Angle {
    pub fn from_degrees(degrees: f32) -> Self {
        Self::from_radians(degrees.to_radians())
    }

    pub const fn from_radians(radians: f32) -> Self {
        Self { radians }
    }

    pub const fn radians(self) -> f32 {
        self.radians
    }
}