Enum TriMeshBuilderError

pub enum TriMeshBuilderError {
    EmptyIndices,
    TopologyError(TopologyError),
}

Errors that occur when creating a triangle mesh.

When constructing a TriMesh using TriMesh::new or TriMesh::with_flags, various validation checks are performed. This error type describes what went wrong.

Common Usage

let vertices = vec![Point3::origin()];
let indices = vec![];  // Empty!

match TriMesh::new(vertices, indices) {
    Err(TriMeshBuilderError::EmptyIndices) => {
        println!("Cannot create a mesh with no triangles");
    }
    Err(TriMeshBuilderError::TopologyError(topo_err)) => {
        println!("Mesh topology is invalid: {}", topo_err);
    }
    Ok(mesh) => {
        println!("Mesh created successfully");
    }
}

Variants

EmptyIndices

The index buffer is empty (no triangles provided).

A triangle mesh must contain at least one triangle. An empty index buffer is not valid because there’s nothing to render or use for collision detection.

How to Fix

Ensure your index buffer has at least one triangle:

let vertices = vec![
    Point3::origin(),
    Point3::new(1.0, 0.0, 0.0),
    Point3::new(0.0, 1.0, 0.0),
];

// BAD: No triangles
let empty_indices = vec![];
assert!(TriMesh::new(vertices.clone(), empty_indices).is_err());

// GOOD: At least one triangle
let indices = vec![[0, 1, 2]];
assert!(TriMesh::new(vertices, indices).is_ok());

TopologyError(TopologyError)

The mesh topology is invalid.

This wraps a TopologyError that provides details about the specific topology problem. This only occurs when creating a mesh with topology validation enabled (e.g., TriMeshFlags::HALF_EDGE_TOPOLOGY).

See TopologyError for details on specific topology problems and how to fix them.

Example

let vertices = vec![
    Point3::origin(),
    Point3::new(1.0, 0.0, 0.0),
    Point3::new(0.0, 1.0, 0.0),
];

// Triangle with duplicate vertices
let bad_indices = vec![[0, 0, 1]];

match TriMesh::with_flags(vertices, bad_indices, TriMeshFlags::HALF_EDGE_TOPOLOGY) {
    Err(TriMeshBuilderError::TopologyError(topo_err)) => {
        println!("Topology error: {}", topo_err);
        // Handle the specific topology issue
    }
    _ => {}
}

Trait Implementations

impl Clone for TriMeshBuilderError

fn clone(&self) -> TriMeshBuilderError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TriMeshBuilderError

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

Formats the value using the given formatter.

impl Display for TriMeshBuilderError

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

Formats the value using the given formatter.

impl Error for TriMeshBuilderError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<TriMeshBuilderError> for MeshIntersectionError

fn from(value: TriMeshBuilderError) -> Self

Converts to this type from the input type.

impl PartialEq for TriMeshBuilderError

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

impl Eq for TriMeshBuilderError

impl StructuralPartialEq for TriMeshBuilderError