Struct Mesh 

pub struct Mesh<Attrib, Basis = Model> {
    pub faces: Vec<Tri<usize>>,
    pub verts: Vec<Vertex3<Attrib, Basis>>,
}

A triangle mesh.

An object made of flat polygonal faces that typically form a contiguous surface without holes or boundaries, so that every face shares each of its edges with another face. For instance, a cube can be represented by a mesh with 8 vertices and 12 faces. By using many faces, complex curved shapes can be approximated.

Fields

faces: Vec<Tri<usize>>

The faces of the mesh, with each face a triplet of indices to the verts vector. Several faces can share a vertex.

verts: Vec<Vertex3<Attrib, Basis>>

The vertices of the mesh.

Implementations

impl<A, B> Mesh<A, B>

pub fn new<F, V>(faces: F, verts: V) -> Self

where F: IntoIterator<Item = Tri<usize>>, V: IntoIterator<Item = Vertex3<A, B>>,

Creates a new triangle mesh with the given faces and vertices.

Each face in faces is a triplet of indices, referring to the vertices in verts that define that face.

Examples

use retrofire_core::geom::{Mesh, tri, vertex};
use retrofire_core::math::pt3;

let verts = [
    pt3(0.0, 0.0, 0.0),
    pt3(1.0, 0.0, 0.0),
    pt3(0.0, 1.0, 0.0),
    pt3(0.0, 0.0, 1.0)
]
.map(|v| vertex(v, ()));

let faces = [
    // Indices point to the verts array
    tri(0, 1, 2),
    tri(0, 1, 3),
    tri(0, 2, 3),
    tri(1, 2, 3)
];

// Create a mesh with a tetrahedral shape
let tetra: Mesh<()> = Mesh::new(faces, verts);

Panics

If any of the vertex indices in faces ≥ verts.len().

pub fn faces(&self) -> impl Iterator<Item = Tri<&Vertex3<A, B>>>

Returns an iterator over the faces of self, mapping the vertex indices to references to the corresponding vertices.

pub fn merge(self, _: Self) -> Self

Returns a mesh with the faces and vertices of both self and other.

impl<A> Mesh<A>

pub fn builder() -> Builder<A>

Returns a new mesh builder.

pub fn into_builder(self) -> Builder<A>

Consumes self and returns a mesh builder with the faces and vertices of self.

Trait Implementations

impl<Attrib: Clone, Basis: Clone> Clone for Mesh<Attrib, Basis>

fn clone(&self) -> Mesh<Attrib, Basis>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<A: Debug, S: Debug + Default> Debug for Mesh<A, S>

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

Formats the value using the given formatter.

impl<A, S> Default for Mesh<A, S>

fn default() -> Self

Returns an empty mesh.