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

vertices: Vec<Vec3D>

faces: Vec<Face>

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 21)

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

    let mut viewport = Viewport::new(
        Transform3D::new_tr(Vec3D::new(0.0, 0.0, 5.0), Vec3D::new(-0.5, 0.3, 0.0)),
        FOV,
        Vec2D::new((view.width / 2) as isize, (view.height / 2) as isize),
    );

    let cube = Mesh3D::default_cube();

    loop {
        let now = gameloop::Instant::now();
        view.clear();

        viewport.transform.rotation.y -= 0.05;

        match frame_skip {
            true => frame_skip = false,
            false => {
                view.blit(
                    &viewport.render(vec![&cube], DisplayMode::Solid),
                    Wrapping::Ignore,
                );
                view.display_render().unwrap();
            }
        }

        let elapsed = now.elapsed();
        println!(
            "Elapsed: {:.2?}µs | Frame skip: {}",
            elapsed.as_micros(),
            frame_skip
        );

        frame_skip = gameloop::sleep_fps(FPS, Some(elapsed));
    }
}

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)

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

Trait Implementations

impl Clone for Mesh3D

fn clone(&self) -> Self

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.

impl ViewElement3D for Mesh3D

fn get_transform(&self) -> Transform3D

This should return the object’s transform

fn get_vertices(&self) -> &Vec<Vec3D>

This should return all of the object’s vertices

fn get_faces(&self) -> &Vec<Face>

This should return all of the object’s Faces