Struct gemini_engine::elements3d::Mesh3D

pub struct Mesh3D {
    pub transform: Transform3D,
    pub vertices: Vec<Vec3D>,
    pub faces: Vec<Face>,
}

The struct for a Mesh3D object, containing a position, rotation, collection of vertices and collection of Faces with indices to the vertex collection.

Fields

transform: Transform3D

The mesh’s transform (position, rotation, scale) in 3D space

vertices: Vec<Vec3D>

A vector of the Mesh3D’s

faces: Vec<Face>

A vector of Faces of indexes into Mesh3D::vertices

Implementations

impl Mesh3D

pub fn default_cube() -> Self

The gemini_engine equivalent of Blender’s default cube. Has side lengths of 2

Examples found in repository

examples/spinning-cube.rs (line 19)

fn main() {
    let mut view = View::new(200, 90, ColChar::BACKGROUND);

    let viewport = Viewport::new(
        Transform3D::new_tr(Vec3D::new(0.0, 1.5, 4.0), Vec3D::new(-0.4, 0.0, 0.0)),
        FOV,
        view.center(),
    );

    let mut cube = Mesh3D::default_cube();

    fps_gameloop!(
        {
            view.clear();
            cube.transform.rotation.y -= 0.05;
        },
        {
            view.blit(
                &viewport.render(vec![&cube], DisplayMode::Solid),
                Wrapping::Ignore,
            );
            let _ = view.display_render();
        },
        FPS,
        |elapsed: gameloop::Duration, frame_skip| {
            println!(
                "Elapsed: {:.2?}µs | Frame skip: {}",
                elapsed.as_micros(),
                frame_skip
            );
        }
    );
}

pub fn torus( outer_radius: f64, inner_radius: f64, outer_segments: usize, inner_segments: usize ) -> Self

Create a torus (donut shape)

Examples found in repository

examples/donut.rs (line 27)

fn main() {
    let mut view = View::new(82, 32, ColChar::EMPTY);
    let viewport = Viewport::new(
        Transform3D::new_tr(Vec3D::new(0.0, 0.0, 20.0), Vec3D::ZERO),
        FOV,
        view.center(),
    );

    let lights = vec![
        Light::new_ambient(0.3),
        Light::new_directional(0.7, Vec3D::new(1.0, -1.0, -1.0)),
    ];

    let mut donut = Mesh3D::torus(1.8, 1.0, 32, 16);

    fps_gameloop!(
        {
            donut.transform.rotation.x += 0.05;
            donut.transform.rotation.z += 0.05;
        },
        {
            view.clear();
            view.blit(
                &viewport.render(
                    vec![&donut],
                    DisplayMode::Illuminated {
                        lights: lights.clone(),
                    },
                ),
                Wrapping::Ignore,
            );
            let _ = view.display_render();
        },
        FPS
    );
}

pub fn gimbal() -> Self

A gimbal to help you orient in gemini_engine’s 3D space. The orientation is as follows (from the default Viewport)

• X (red) increases as you move to the right
• Y (green) increases as you move up
• Z (blue) increases as you move away from the viewport

Think of it like Blender’s axes but with Y and Z swapped. This Mesh does not render in DisplayMode::SOLID (see DisplayMode documentation)

impl Mesh3D

pub const fn new( transform: Transform3D, vertices: Vec<Vec3D>, faces: Vec<Face> ) -> Self

Create a Mesh3D with a default Transform3D

pub const fn new_at_origin(vertices: Vec<Vec3D>, faces: Vec<Face>) -> Self

Create a Mesh3D with a default Transform3D

Trait Implementations

impl Clone for Mesh3D

fn clone(&self) -> Mesh3D

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Mesh3D

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.