Struct Mesh 

pub struct Mesh {
    pub vertices: Vec<Vertex>,
    pub triangles: Vec<Triangle>,
    pub beam_lattice: Option<BeamLattice>,
}

A triangle mesh representing 3D geometry.

A mesh is the fundamental geometry container in 3MF, consisting of vertices (3D points) and triangles that connect those vertices. Meshes can optionally include beam lattice structures for lightweight, high-strength geometry.

Examples

use lib3mf_core::model::Mesh;

let mut mesh = Mesh::new();
let v1 = mesh.add_vertex(0.0, 0.0, 0.0);
let v2 = mesh.add_vertex(1.0, 0.0, 0.0);
let v3 = mesh.add_vertex(0.0, 1.0, 0.0);
mesh.add_triangle(v1, v2, v3);
assert_eq!(mesh.triangles.len(), 1);

Fields

vertices: Vec<Vertex>

List of vertices (points in 3D space).

triangles: Vec<Triangle>

List of triangles connecting vertices by their indices.

beam_lattice: Option<BeamLattice>

Beam Lattice extension data for structural lattice geometry (optional).

Implementations

impl Mesh

pub fn new() -> Self

Creates a new empty mesh.

pub fn add_vertex(&mut self, x: f32, y: f32, z: f32) -> u32

Adds a vertex to the mesh and returns its index.

Arguments

• x - X coordinate in model units
• y - Y coordinate in model units
• z - Z coordinate in model units

Returns

The index of the newly added vertex, which can be used to reference this vertex in triangles.

pub fn add_triangle(&mut self, v1: u32, v2: u32, v3: u32)

Adds a triangle to the mesh connecting three vertices.

Arguments

• v1 - Index of the first vertex
• v2 - Index of the second vertex
• v3 - Index of the third vertex

The vertex indices should be in counter-clockwise order when viewed from outside the mesh for correct normal orientation.

pub fn compute_aabb(&self) -> Option<BoundingBox>

Computes the axis-aligned bounding box (AABB) of the mesh.

Returns None if the mesh has no vertices.

pub fn compute_area_and_volume(&self) -> (f64, f64)

Computes the total surface area and volume of the mesh.

Uses triangle area calculation and signed tetrahedron volumes. Returns (0.0, 0.0) if the mesh has no triangles.

Returns

A tuple of (surface_area, volume) in square and cubic model units respectively.

pub fn compute_triangle_area(&self, triangle: &Triangle) -> f64

Computes the area of a single triangle.

Arguments

• triangle - Reference to the triangle whose area to compute

Returns

The area of the triangle in square model units.

Trait Implementations

impl Clone for Mesh

fn clone(&self) -> Mesh

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Mesh

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

Formats the value using the given formatter.

impl Default for Mesh

fn default() -> Mesh

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Mesh

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl MeshRepair for Mesh

fn repair(&mut self, options: RepairOptions) -> RepairStats

Attempts to repair the mesh in-place based on the provided options.

impl PartialEq for Mesh

fn eq(&self, other: &Mesh) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Mesh

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Mesh