Struct truck_rendimpl::polymesh::PolygonMesh

pub struct PolygonMesh { /* fields omitted */ }

Polygon mesh

The polygon data is held in a method compliant with wavefront obj. Position, uv (texture) coordinates, and normal vectors are held in separate arrays, and each face vertex accesses those values by an indices triple.

Implementations

impl PolygonMesh

pub fn new(
    positions: Vec<Point3<f64>, Global>,
    uv_coords: Vec<Vector2<f64>, Global>,
    normals: Vec<Vector3<f64>, Global>,
    faces: Faces
) -> PolygonMesh

complete constructor

Panics

Panic occurs if there is an index is out of range.

Remarks

This method does not check whether the normal is normalized or not.

pub fn try_new(
    positions: Vec<Point3<f64>, Global>,
    uv_coords: Vec<Vector2<f64>, Global>,
    normals: Vec<Vector3<f64>, Global>,
    faces: Faces
) -> Result<PolygonMesh, Error>

complete constructor

Errors

Returns Error::OutOfRange if there is an index is out of range.

Remarks

This method does not check whether the normal is normalized or not.

pub fn positions(&self) -> &Vec<Point3<f64>, Global>

Returns the vector of all positions.

pub fn positions_mut(&mut self) -> &mut [Point3<f64>]

Returns the mutable slice of all positions.

pub fn push_position(&mut self, position: Point3<f64>)

Adds a position.

pub fn extend_positions<I>(&mut self, iter: I) where
    I: IntoIterator<Item = Point3<f64>>, 

Extend positions by iterator.

pub fn uv_coords(&self) -> &Vec<Vector2<f64>, Global>

Returns the vector of all uv (texture) coordinates.

pub fn uv_coords_mut(&mut self) -> &mut [Vector2<f64>]

Returns the mutable slice of all uv (texture) coordinates.

pub fn push_uv_coord(&mut self, uv_coord: Vector2<f64>)

Adds a uv (texture) coordinate.

pub fn extend_uv_coords<I>(&mut self, iter: I) where
    I: IntoIterator<Item = Vector2<f64>>, 

Extend uv (texture) coordinates by iterator.

pub fn normals(&self) -> &Vec<Vector3<f64>, Global>

Returns the vector of all normals.

pub fn normals_mut(&mut self) -> &mut [Vector3<f64>]

Returns the mutable slice of all normals.

pub fn extend_normals<I>(&mut self, iter: I) where
    I: IntoIterator<Item = Vector3<f64>>, 

Extend normals by iterator

pub fn faces(&self) -> &Faces

Returns the faces of the polygon.

pub fn tri_faces(&self) -> &Vec<[Vertex; 3], Global>

Returns the vector of all triangles of the polygon.

pub fn tri_faces_mut(&mut self) -> &mut [[Vertex; 3]]

Returns the mutable slice of all triangles.

pub fn quad_faces(&self) -> &Vec<[Vertex; 4], Global>

Returns the vector of all quadrangles.

pub fn quad_faces_mut(&mut self) -> &mut [[Vertex; 4]]

Returns the mutable slice of all quadrangles.

pub fn other_faces(&self) -> &[Vec<Vertex, Global>]

Returns the vector of n-gons (n > 4).

pub fn other_faces_mut(&mut self) -> &mut [Vec<Vertex, Global>]

Returns the mutable iterator of n-gons (n > 4).

pub fn face_iter(&'a self) -> impl Iterator<Item = &'a [Vertex]>

Returns the iterator of the slice.

By the internal optimization, this iterator does not runs in the simple order in which they are registered, but runs order: triangle, square, and the others. cf: Faces::face_iter

pub fn face_iter_mut(&'a mut self) -> impl Iterator<Item = &'a mut [Vertex]>

Returns the iterator of the slice.

By the internal optimization, this iterator does not runs in the simple order in which they are registered, but runs order: triangle, square, and the others. cf: Faces::face_iter

pub fn editor(&mut self) -> PolygonMeshEditor<'_>

Creates an editor that performs boundary checking on dropped.

pub fn uncheck_editor(&mut self) -> PolygonMeshEditor<'_>

Creates an editor that does NOT perform boundary checking on dropped.

pub fn debug_editor(&mut self) -> PolygonMeshEditor<'_>

Creates an editor that performs boundary checking on dropped ONLY in debug build.

pub fn merge(&mut self, mesh: PolygonMesh)

Returns polygonmesh merged self and mesh.

pub fn bounding_box(&self) -> BoundingBox<Point3<f64>>

Creates the bounding box of the polygon mesh.

Trait Implementations

impl Clone for PolygonMesh

pub fn clone(&self) -> PolygonMesh

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for PolygonMesh

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PolygonMesh

pub fn deserialize<__D>(
    __deserializer: __D
) -> Result<PolygonMesh, <__D as Deserializer<'de>>::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl NormalFilters for PolygonMesh

pub fn normalize_normals(&mut self) -> &mut PolygonMesh

Normalize all normals and assign None to the nor index of the vertices that has irregular normals.

pub fn add_naive_normals(&mut self, overwrite: bool) -> &mut PolygonMesh

Adds face normals to each vertices.

pub fn add_smooth_normals(
    &mut self,
    tol_ang: f64,
    overwrite: bool
) -> &mut PolygonMesh

add the smooth normal vectors to the mesh.

impl OptimizingFilter for PolygonMesh

pub fn remove_unused_attrs(&mut self) -> &mut PolygonMesh

remove all unused position, texture coordinates, and normal vectors.

pub fn remove_degenerate_faces(&mut self) -> &mut PolygonMesh

Removes degenerate polygons.

pub fn put_together_same_attrs(&mut self) -> &mut PolygonMesh

Gives the same indices to the same positions, texture coordinate, and normal vectors, respectively.

impl PartialEq<PolygonMesh> for PolygonMesh

pub fn eq(&self, other: &PolygonMesh) -> bool

This method tests for self and other values to be equal, and is used by ==.

pub fn ne(&self, other: &PolygonMesh) -> bool

This method tests for !=.

impl Polygon for PolygonMesh

fn buffers(
    &self,
    vertex_usage: BufferUsage,
    index_usage: BufferUsage,
    device: &Device
) -> (BufferHandler, BufferHandler)

Creates buffer handlers of attributes and indices.

fn into_instance(
    &self,
    creator: &InstanceCreator,
    desc: &PolygonInstanceDescriptor
) -> PolygonInstance

impl Serialize for PolygonMesh

pub fn serialize<__S>(
    &self,
    __serializer: __S
) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.

impl Splitting for PolygonMesh

pub fn create_mesh_by_face_indices(&self, indices: &[usize]) -> PolygonMesh

Creates a sub mesh by the face indices.

pub fn extract_planes(
    &self,
    tol: f64
) -> (Vec<usize, Global>, Vec<usize, Global>)

Extracts polygons such that there exists its normal is the same as its face normal.

pub fn into_components(&self) -> Vec<Vec<usize, Global>, Global>

Splits into the components.

impl StructuralPartialEq for PolygonMesh

impl StructuringFilter for PolygonMesh

pub fn triangulate(&mut self) -> &mut PolygonMesh

triangulate all n-gons

pub fn quadrangulate(
    &mut self,
    plane_tol: f64,
    score_tol: f64
) -> &mut PolygonMesh

join two triangles into one quadrangle.