Struct Model 

pub struct Model {
    pub meshes: Vec<Mesh>,
    pub materials: Vec<Material>,
    pub transform: Mat4,
    pub highlight: Color,
    pub bounding_center: Vec3,
    pub bounding_radius: f32,
    /* private fields */
}

Fields

meshes: Vec<Mesh>

materials: Vec<Material>

transform: Mat4

Model matrix applied to every vertex in world space. Defaults to glam::Mat4::IDENTITY. Prefer building it up through the Transformable methods.

highlight: Color

RGBA overlay blended over the model’s shaded color (mix(shaded, highlight.rgb, highlight.a) in the fragment shader). Alpha 0 (the default) means no highlight at all. Intended for editor-style hover/selection feedback rather than gameplay use.

bounding_center: Vec3

Center of the model’s bounding sphere, in local (pre-transform) space.

bounding_radius: f32

Radius of the model’s bounding sphere, in local (pre-transform) space. Computed once at load time since the raw vertex positions aren’t retained after upload to the GPU.

Implementations

impl Model

pub fn load(renderer: &Renderer<'_>, path: impl AsRef<Path>) -> Result<Self>

Loads a Wavefront OBJ model (and its referenced .mtl materials and textures) from path. Texture paths in the .mtl file are resolved relative to the OBJ’s directory.

Trait Implementations

impl Clone for Model

fn clone(&self) -> Model

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Transformable for Model

fn transform(&self) -> Mat4

The current model matrix.

fn transform_mut(&mut self) -> &mut Mat4

Mutable access to the model matrix.

fn pivot(&self) -> Vec3

Local-space point that rotations and scales turn around. Defaults to the local origin.

fn set_transform(&mut self, transform: Mat4) -> &mut Self

where Self: Sized,

Replaces the model matrix outright, discarding any accumulated transforms.

fn reset_transform(&mut self) -> &mut Self

where Self: Sized,

Clears the model matrix back to the identity.

fn apply(&mut self, transform: Mat4) -> &mut Self

where Self: Sized,

Composes transform onto the current matrix, about the local origin.

fn apply_about_pivot(&mut self, transform: Mat4) -> &mut Self

where Self: Sized,

Composes transform onto the current matrix, about Transformable::pivot.

fn translate(&mut self, x: f32, y: f32) -> &mut Self

where Self: Sized,

Moves along the local X and Y axes.

fn translate3(&mut self, offset: Vec3) -> &mut Self

where Self: Sized,

Moves by offset in local space.

fn rotate(&mut self, radians: f32) -> &mut Self

where Self: Sized,

Rotates around the Z axis — the in-plane spin for 2D content.

fn rotate_degrees(&mut self, degrees: f32) -> &mut Self

where Self: Sized,

Transformable::rotate, taking degrees.

fn rotate_x(&mut self, radians: f32) -> &mut Self

where Self: Sized,

Rotates around the X axis.

fn rotate_y(&mut self, radians: f32) -> &mut Self

where Self: Sized,

Rotates around the Y axis.

fn rotate_z(&mut self, radians: f32) -> &mut Self

where Self: Sized,

Rotates around the Z axis.

fn rotate_quat(&mut self, rotation: Quat) -> &mut Self

where Self: Sized,

Applies an arbitrary rotation.

fn scale(&mut self, x: f32, y: f32) -> &mut Self

where Self: Sized,

Scales the X and Y axes independently.

fn scale_uniform(&mut self, factor: f32) -> &mut Self

where Self: Sized,

Scales every axis by the same factor.

fn scale3(&mut self, scale: Vec3) -> &mut Self

where Self: Sized,

Scales by scale in local space.

fn flip_x(&mut self) -> &mut Self

where Self: Sized,

Mirrors across the pivot’s vertical axis.

fn flip_y(&mut self) -> &mut Self

where Self: Sized,

Mirrors across the pivot’s horizontal axis.