Struct TriangleMesh 

pub struct TriangleMesh {
    pub vertices: Vec<Vertex>,
    pub faces: Vec<Face>,
}

A triangle mesh with indexed face set representation

Examples

use scirs2_spatial::mesh::{TriangleMesh, Vertex, Face};

let vertices = vec![
    Vertex::new(0.0, 0.0, 0.0),
    Vertex::new(1.0, 0.0, 0.0),
    Vertex::new(0.5, 1.0, 0.0),
    Vertex::new(0.5, 0.5, 1.0),
];

let faces = vec![
    Face::new(0, 1, 2),
    Face::new(0, 1, 3),
    Face::new(1, 2, 3),
    Face::new(0, 2, 3),
];

let mesh = TriangleMesh::new(vertices, faces).expect("Operation failed");
assert_eq!(mesh.num_vertices(), 4);
assert_eq!(mesh.num_faces(), 4);

Fields

vertices: Vec<Vertex>

Vertex positions

faces: Vec<Face>

Triangle faces (indices into vertices)

Implementations

impl TriangleMesh

pub fn new(vertices: Vec<Vertex>, faces: Vec<Face>) -> SpatialResult<Self>

Create a new triangle mesh

Arguments

• vertices - List of vertex positions
• faces - List of triangular faces

Returns

A validated triangle mesh

pub fn empty() -> Self

Create an empty mesh

pub fn num_vertices(&self) -> usize

Number of vertices

pub fn num_faces(&self) -> usize

Number of faces

pub fn num_edges(&self) -> usize

Number of edges (computed from face connectivity)

pub fn edges(&self) -> HashSet<Edge>

Get all unique edges in the mesh

pub fn vertex_faces(&self) -> HashMap<usize, Vec<usize>>

Build vertex-to-face adjacency map

pub fn vertex_neighbors(&self) -> HashMap<usize, HashSet<usize>>

Build vertex-to-vertex adjacency (neighbors)

pub fn face_normal_raw(&self, face_idx: usize) -> SpatialResult<[f64; 3]>

Compute face normal for a given face index (unnormalized)

pub fn face_normal(&self, face_idx: usize) -> SpatialResult<[f64; 3]>

Compute normalized face normal for a given face index

pub fn compute_face_normals(&self) -> SpatialResult<Vec<[f64; 3]>>

Compute all face normals (normalized)

pub fn compute_vertex_normals(&self) -> SpatialResult<Vec<[f64; 3]>>

Compute vertex normals by averaging adjacent face normals weighted by face area

pub fn face_area(&self, face_idx: usize) -> SpatialResult<f64>

Compute the area of a face

pub fn surface_area(&self) -> SpatialResult<f64>

Compute the total surface area of the mesh

pub fn bounding_box(&self) -> Option<(Vertex, Vertex)>

Compute the bounding box of the mesh

pub fn to_stl_ascii(&self, name: &str) -> SpatialResult<String>

Export to ASCII STL format string

Arguments

• name - Name for the solid in the STL file

pub fn from_stl_ascii(stl_data: &str) -> SpatialResult<Self>

Import from ASCII STL format string

Arguments

• stl_data - The ASCII STL content as a string

pub fn is_manifold(&self) -> bool

Check if the mesh is manifold (every edge has exactly 1 or 2 adjacent faces)

pub fn is_closed(&self) -> bool

Check if the mesh is closed (every edge has exactly 2 adjacent faces)

pub fn boundary_edges(&self) -> Vec<Edge>

Get boundary edges (edges with only 1 adjacent face)

pub fn euler_characteristic(&self) -> i64

Compute the Euler characteristic: V - E + F

Trait Implementations

impl Clone for TriangleMesh

fn clone(&self) -> TriangleMesh

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TriangleMesh

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

Formats the value using the given formatter.