Struct gemini_engine::elements3d::view3d::Transform3D

pub struct Transform3D {
    pub translation: Vec3D,
    pub rotation: Vec3D,
    pub scale: Vec3D,
}

The Transform3D struct is used to manipulate the position of objects in 3D space

Fields

translation: Vec3D

The position of the object in 3D space

rotation: Vec3D

The rotation of the object, applied in radians

scale: Vec3D

The object’s scale

Implementations

impl Transform3D

pub const DEFAULT: Self = _

The default transform - no translation, no rotation and 1x scaling

pub const fn new_trs(translation: Vec3D, rotation: Vec3D, scale: Vec3D) -> Self

Create a Transform3D with chosen translation, rotation and scale

pub const fn new_tr(translation: Vec3D, rotation: Vec3D) -> Self

Create a Transform3D with chosen translation and rotation

Examples found in repository

examples/spinning-cube.rs (line 14)

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
            );
        }
    );
}

examples/donut.rs (line 17)

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 const fn new_t(translation: Vec3D) -> Self

Create a Transform3D with chosen translation

pub const fn new_r(rotation: Vec3D) -> Self

Create a Transform3D with chosen rotation

pub fn apply_to(&self, vertices: &[Vec3D]) -> Vec<Vec3D>

Apply the transform to a slice of vertices

pub fn rotate(&self, value: Vec3D) -> Vec3D

Rotate the given Vec3D using the Transform3D’s rotation field

Trait Implementations

impl Clone for Transform3D

fn clone(&self) -> Transform3D

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Transform3D

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

Formats the value using the given formatter.

impl Default for Transform3D

fn default() -> Self

Returns the “default value” for a type.

impl Mul<Vec3D> for Transform3D

fn mul(self, rhs: Vec3D) -> Self::Output

Apply the transform to the Vec3D

type Output = Vec3D

The resulting type after applying the * operator.

impl Mul for Transform3D

type Output = Transform3D

The resulting type after applying the * operator.

fn mul(self, rhs: Self) -> Self::Output

Performs the * operation.

impl MulAssign for Transform3D

fn mul_assign(&mut self, rhs: Self)

Performs the *= operation.

impl Neg for Transform3D

type Output = Transform3D

The resulting type after applying the - operator.

fn neg(self) -> Self::Output

Performs the unary - operation.

impl Copy for Transform3D