Struct TriMesh

pub struct TriMesh {
    pub positions: Vec<Point3>,
    pub indices: Vec<u32>,
    pub normals: Option<NormalAttribute>,
    pub attributes: Vec<AttributeChannel>,
}

Indexed triangle mesh in local coordinates.

Dirty source geometry is representable. Call TriMesh::validate_structure at trust boundaries; manifold validation is a separate, more expensive pass.

Fields

positions: Vec<Point3>

Vertex positions.

indices: Vec<u32>

Triangle corner indices, three entries per triangle.

normals: Option<NormalAttribute>

Optional normals preserved from the source.

attributes: Vec<AttributeChannel>

Named per-vertex channels carried alongside positions.

Empty by default: a mesh with no extra data pays nothing for this.

Implementations

impl TriMesh

pub fn new(positions: Vec<Point3>, indices: Vec<u32>) -> Self

Construct a position/index mesh without normals.

pub fn triangle_count(&self) -> usize

Number of complete triangles.

pub fn bounds(&self) -> Aabb

Bounds of all positions.

pub fn validate_structure(&self) -> Result<(), MeshValidationError>

Cheap index-buffer and attribute-size validation.

pub fn is_structurally_valid(&self) -> bool

Whether cheap structural validation succeeds.

pub fn triangles(&self) -> impl ExactSizeIterator<Item = [u32; 3]> + '_

Triangles in deterministic index-buffer order.

Trait Implementations

impl Clone for TriMesh

fn clone(&self) -> TriMesh

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for TriMesh

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

Formats the value using the given formatter.

impl Default for TriMesh

fn default() -> TriMesh

Returns the “default value” for a type.

impl MeshView for TriMesh

fn positions(&self) -> &[Point3]

Position buffer.

fn indices(&self) -> &[u32]

Triangle corner index buffer.

impl PartialEq for TriMesh

fn eq(&self, other: &TriMesh) -> 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 TriangleMeshView for TriMesh

fn position_count(&self) -> usize

Number of addressable positions.

fn position(&self, index: usize) -> Point3

Position at a valid index.

fn triangle_count(&self) -> usize

Number of complete triangle records.

fn triangle(&self, index: usize) -> [u64; 3]

Three caller-provided position indices for one triangle.

impl StructuralPartialEq for TriMesh