Struct Mesh 

pub struct Mesh { /* private fields */ }

Triangle mesh geometry decoded from, or prepared for, a Draco bitstream.

A mesh owns triangle topology and dereferences to its underlying PointCloud, where attributes and metadata are stored.

Implementations

impl Mesh

pub fn new() -> Self

Creates an empty mesh with no faces, points, attributes, or metadata.

pub fn add_face(&mut self, face: Face)

Appends one triangle face.

pub fn set_face(&mut self, face_id: FaceIndex, face: Face)

Sets a face, growing the face list with zeroed faces when needed.

pub fn set_faces_from_flat_indices(&mut self, indices: &[u32])

Bulk-set all faces from a flat u32 index array (3 indices per face). Assumes set_num_faces has already been called with the right count.

pub fn set_faces_from_u8_indices(&mut self, bytes: &[u8])

Bulk-set all faces from tightly packed u8 indices. Assumes set_num_faces has already been called with the right count.

pub fn set_faces_from_le_u16_indices(&mut self, bytes: &[u8])

Bulk-set all faces from tightly packed little-endian u16 indices. Assumes set_num_faces has already been called with the right count.

pub fn set_faces_from_le_u32_indices(&mut self, bytes: &[u8])

Bulk-set all faces from tightly packed little-endian u32 indices. Assumes set_num_faces has already been called with the right count.

pub fn set_face_from_indices(&mut self, face_id: usize, indices: [u32; 3])

Sets one face from raw u32 point ids.

pub fn face(&self, face_id: FaceIndex) -> Face

Returns the point indices for a face.

pub fn num_faces(&self) -> usize

Returns the number of triangle faces.

pub fn set_num_faces(&mut self, num_faces: usize)

Resizes the face list, filling new faces with point index zero.

pub fn try_set_num_faces(&mut self, num_faces: usize) -> Status

Fallibly resizes the face list.

pub fn deduplicate_point_ids(&mut self)

Deduplicate point IDs to match C++ Draco behavior.

This function remaps point indices such that:

1. Points are assigned new IDs in the order they’re first encountered in faces
2. Face indices are updated to use the new point IDs
3. Attribute point mappings are updated accordingly

This is needed for binary compatibility with C++ Draco, which internally creates separate points for each face corner during OBJ loading and then deduplicates them in face-traversal order.

Methods from Deref<Target = PointCloud>

pub fn set_num_points(&mut self, num_points: usize)

Sets the number of logical points.

pub fn add_attribute(&mut self, attribute: PointAttribute) -> i32

Adds an attribute and assigns it a unique id matching its attribute id.

pub fn add_attribute_preserve_unique_id( &mut self, attribute: PointAttribute, ) -> i32

Adds an attribute while preserving its existing unique id.

pub fn set_attribute(&mut self, att_id: i32, attribute: PointAttribute)

Places an attribute at att_id, growing the attribute list if needed.

Mirrors C++ PointCloud::SetAttribute: the attribute’s unique id is set to att_id. Any vacancies created when growing the list are filled with empty attributes.

pub fn num_attributes(&self) -> i32

Returns the number of attributes.

pub fn attribute_id_by_unique_id(&self, unique_id: u32) -> i32

Returns the attribute id for the given Draco unique id, or -1.

Mirrors C++ PointCloud::GetAttributeIdByUniqueId.

pub fn attribute_by_unique_id(&self, unique_id: u32) -> Option<&PointAttribute>

Returns the attribute with the given Draco unique id.

Mirrors C++ PointCloud::GetAttributeByUniqueId.

pub fn attribute(&self, att_id: i32) -> &PointAttribute

Returns an attribute by attribute id.

pub fn try_attribute(&self, att_id: i32) -> Result<&PointAttribute, DracoError>

Fallibly returns an attribute by attribute id.

pub fn attribute_mut(&mut self, att_id: i32) -> &mut PointAttribute

Returns a mutable attribute by attribute id.

pub fn try_attribute_mut( &mut self, att_id: i32, ) -> Result<&mut PointAttribute, DracoError>

Fallibly returns a mutable attribute by attribute id.

pub fn named_attribute_id(&self, att_type: GeometryAttributeType) -> i32

Returns the first attribute id with the requested semantic type, or -1.

pub fn named_attribute( &self, att_type: GeometryAttributeType, ) -> Option<&PointAttribute>

Returns the first attribute with the requested semantic type.

pub fn num_points(&self) -> usize

Returns the number of logical points.

pub fn metadata(&self) -> Option<&GeometryMetadata>

Returns geometry metadata, if present.

pub fn metadata_mut(&mut self) -> Option<&mut GeometryMetadata>

Returns mutable geometry metadata, if present.

pub fn metadata_or_insert(&mut self) -> &mut GeometryMetadata

Returns geometry metadata, inserting an empty block when absent.

pub fn set_metadata(&mut self, metadata: Option<GeometryMetadata>)

Replaces geometry metadata.

pub fn attribute_metadata_by_unique_id( &self, attribute_unique_id: u32, ) -> Option<&AttributeMetadata>

Finds per-attribute metadata by Draco attribute unique id.

pub fn attribute_metadata_by_string_entry( &self, entry_name: &str, entry_value: &str, ) -> Option<&AttributeMetadata>

Finds per-attribute metadata by a string metadata entry.

pub fn set_attribute_metadata( &mut self, att_id: i32, metadata: Metadata, ) -> Result<(), DracoError>

Sets metadata for an attribute id.

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 Deref for Mesh

type Target = PointCloud

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for Mesh

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.