crystal-engine 0.2.1

A simple 3D engine
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

use super::Model;
use cgmath::{Euler, Matrix4, Rad, SquareMatrix, Vector3, Zero};
use parking_lot::RwLock;
use std::sync::{
    atomic::{AtomicU64, Ordering},
    Arc,
};

/// Data of a model. This is behind an `Arc<RwLock<>>` so that the engine can keep a copy and check the latest values.
///
/// For an example on how to use this, see the example in the root of this module. This is the value passed in `ModelHandle::modify`.
pub struct ModelData {
    pub(crate) id: u64,
    pub(crate) model: Arc<Model>,

    /// The current position in the world that this model exists at.
    pub position: Vector3<f32>,

    /// The rotation of this model, in euler angles.
    pub rotation: Euler<Rad<f32>>,

    /// The scale of this model.
    pub scale: f32,

    /// Contains the data of the groups in the model.
    /// If your 3d model has multiple parts, you can move them individually with this property.
    pub groups: Vec<ModelDataGroup>,
}

impl std::fmt::Debug for ModelData {
    fn fmt(&self, fmt: &mut std::fmt::Formatter) -> std::fmt::Result {
        fmt.debug_struct("ModelData")
            .field("position", &self.position)
            .field("rotation", &self.rotation)
            .field("scale", &self.scale)
            .finish()
    }
}

impl ModelData {
    pub(crate) fn new(model: Arc<Model>) -> (u64, Arc<RwLock<Self>>) {
        static ID: AtomicU64 = AtomicU64::new(0);
        let id = ID.fetch_add(1, Ordering::Relaxed);
        let groups = (0..model.groups.len())
            .map(|_| ModelDataGroup::default())
            .collect();

        (
            id,
            Arc::new(RwLock::new(Self {
                id,
                model,
                position: Vector3::zero(),
                rotation: Euler::new(Rad(0.0), Rad(0.0), Rad(0.0)),
                scale: 1.0,
                groups,
            })),
        )
    }
    pub(crate) fn matrix(&self) -> Matrix4<f32> {
        Matrix4::from_translation(self.position)
            * Matrix4::from(self.rotation)
            * Matrix4::from_scale(self.scale)
    }
}

pub struct ModelDataGroup {
    pub matrix: Matrix4<f32>,
}

impl Default for ModelDataGroup {
    fn default() -> Self {
        Self {
            matrix: Matrix4::identity(),
        }
    }
}