gemini-engine 1.2.0

A 2D/3D monospaced ASCII rendering engine for the terminal
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

//! This module contains the [`Mesh3D`], which stores 3D objects as vertices and index faces

mod components;
mod mesh3d_presets;

pub use components::{Face, Transform3D, Vec3D};

/// A 3D mesh made up of vertices, faces made of indices into `vertices`, and a transformation.
#[derive(Debug, Clone)]
pub struct Mesh3D {
    /// The mesh's transform matrix in 3D space
    pub transform: Transform3D,
    /// A vector of the [`Mesh3D`]'s vertices
    pub vertices: Vec<Vec3D>,
    /// A vector of [`Face`]s of indexes into `vertices`
    pub faces: Vec<Face>,
}

impl Mesh3D {
    /// Create a `Mesh3D` with an identity `Transform3D`
    #[must_use]
    pub const fn new(vertices: Vec<Vec3D>, faces: Vec<Face>) -> Self {
        Self {
            transform: Transform3D::IDENTITY,
            vertices,
            faces,
        }
    }

    /// Return the `Mesh3D` with an updated `transform` property. Consumes the original `Mesh3D`
    #[must_use]
    pub const fn with_transform(mut self, transform: Transform3D) -> Self {
        self.transform = transform;
        self
    }
}