Struct MeshData 

pub struct MeshData {
    pub vertices: Vec<Vertex>,
    pub indices: Vec<u32>,
    pub albedo: Option<Arc<Albedo>>,
    pub base_color: [f32; 4],
    pub parts: Vec<MeshPart>,
    pub dependencies: Vec<String>,
}

Indexed CPU triangle mesh with optional imported material information. Indices refer into vertices; call validate before uploading externally generated data.

Fields

vertices: Vec<Vertex>

Interleaved triangle vertices.

indices: Vec<u32>

Triangle-list indices; length must be divisible by three.

albedo: Option<Arc<Albedo>>

Base-colour texture of the model’s first textured material, if it had one.

base_color: [f32; 4]

Base-colour factor of the model’s first material (white if none).

parts: Vec<MeshPart>

Material runs for models with several materials (empty = the whole mesh uses albedo).

dependencies: Vec<String>

Asset-relative source files referenced by an imported mesh (buffers/textures). Render caches watch these dependencies as well as the model file itself.

Implementations

impl MeshData

pub fn triangle_count(&self) -> usize

Number of complete indexed triangles. Use Self::validate to reject a trailing index.

pub fn is_empty(&self) -> bool

Whether there are no drawable triangles (vertices alone do not draw anything).

pub fn validate(&self) -> Result<(), String>

Checks triangle topology, finite vertex attributes and embedded image dimensions. Zero-length normals and degenerate triangles are allowed (common at primitive poles).

pub fn recalculate_normals(&mut self) -> Result<(), String>

Recomputes area-weighted smooth vertex normals from indexed triangles. Checks topology/positions before mutation; isolated vertices receive zero normals.

pub fn transformed(&self, matrix: Mat4) -> Result<Self, String>

Copies and transforms a mesh by a finite nonsingular affine matrix. Normals use the inverse transpose; mirrored transforms reverse triangle winding so the front-face convention stays consistent. Texture pixels remain shared.

pub fn effective_parts(&self) -> Vec<MeshPart>

The material runs of this mesh; a mesh without explicit parts is one run with its own albedo.

pub fn append(&mut self, other: &Self) -> Result<(), String>

Appends another valid mesh, offsetting indices, while retaining this mesh’s material. Checks both inputs and index overflow before mutation. Meshes with different textures should be drawn separately instead of merged through this operation.

pub fn surface_area(&self) -> Result<f32, String>

Sum of triangle areas in square local units, including duplicated/double-sided faces. Invalid topology or non-finite positions return an error.

pub fn bounds(&self) -> (Vec3, Vec3)

Axis-aligned local bounds (minimum, maximum). Empty meshes return two zero vectors.

pub fn primitive(name: &str) -> Option<MeshData>

Builds a built-in unit primitive by lowercase name, or None for an unknown name.

pub fn load(assets: &Assets, path: &str) -> Result<MeshData, String>

Loads primitive:<name> or a model file from the asset source.

Trait Implementations

impl Clone for MeshData

fn clone(&self) -> MeshData

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for MeshData

fn default() -> Self

Returns the “default value” for a type.