Struct TriMesh

pub struct TriMesh {
    pub positions: Vec<DVec3>,
    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<DVec3>

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<DVec3>, indices: Vec<u32>) -> TriMesh

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

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<(), Error>

Formats the value using the given formatter.

impl Default for TriMesh

fn default() -> TriMesh

Returns the “default value” for a type.

impl Diagnose<TriMesh> for MeshHealer

type Error = MeshHealError

Structured failure to complete diagnosis.

fn diagnose( &self, mesh: &TriMesh, tolerance: Tolerance, ) -> Result<Diagnosis, <MeshHealer as Diagnose<TriMesh>>::Error>

Inspect one value.

impl From<TriMesh> for GeometryNode

fn from(value: TriMesh) -> GeometryNode

Converts to this type from the input type.

impl Measure<TriMesh> for MeshMeasure

fn measure( &self, value: &TriMesh, tolerance: Tolerance, ) -> Result<MassProperties, <MeshMeasure as Measure<TriMesh>>::Error>

Area, signed volume, volume centroid and second moments in one pass.

The centroid reported is the VOLUME centroid, not the area centroid: for mass properties of a solid that is the meaningful one, and surface_properties still exposes the area centroid separately for callers measuring a shell.

type Error = MeshMeasureError

Structured failure (open shell, self intersection, unsupported shape).

impl MeshView for TriMesh

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

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 Repair<TriMesh> for MeshHealer

type Error = MeshHealError

Structured repair failure.

fn repair( &self, mesh: &TriMesh, plan: &RepairPlan, tolerance: Tolerance, ) -> Result<(TriMesh, RepairReport), <MeshHealer as Repair<TriMesh>>::Error>

Never mutates the caller’s source value in place.

impl TriangleMeshView for TriMesh

fn position_count(&self) -> usize

Number of addressable positions.

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

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 BuiltInNode for TriMesh

impl StructuralPartialEq for TriMesh