Struct Builder 

pub struct Builder<Attrib = (), Basis = Model> {
    pub mesh: Mesh<Attrib, Basis>,
}

A builder type for creating meshes.

Fields

mesh: Mesh<Attrib, Basis>

Implementations

impl<A> Builder<A>

pub fn push_face(&mut self, a: usize, b: usize, c: usize)

Appends a face with the given vertex indices.

Invalid indices (referring to vertices not yet added) are permitted, as long as all indices are valid when the build method is called.

pub fn push_faces<Fs>(&mut self, faces: Fs)

where Fs: IntoIterator<Item = [usize; 3]>,

Appends all the faces yielded by the given iterator.

The faces may include invalid vertex indices (referring to vertices not yet added) are permitted, as long as all indices are valid when the build method is called.

pub fn push_vert(&mut self, pos: Point3, attrib: A)

Appends a vertex with the given position and attribute.

pub fn push_verts<Vs>(&mut self, verts: Vs)

where Vs: IntoIterator<Item = (Point3, A)>,

Appends all the vertices yielded by the given iterator.

pub fn build(self) -> Mesh<A>

Returns the finished mesh containing all the added faces and vertices.

Panics

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

impl<A> Builder<A>

pub fn transform(self, tf: &Mat4x4<RealToReal<3, Model, Model>>) -> Self

Applies the given transform to the position of each vertex.

This is an eager operation, that is, only vertices currently added to the builder are transformed.

pub fn warp(self, f: impl FnMut(Vertex3<A>) -> Vertex3<A>) -> Self

Applies an arbitrary mapping to each vertex.

This method can be used for various nonlinear transformations such as twisting or dilation. This is an eager operation, that is, only vertices currently added to the builder are transformed.

pub fn with_vertex_normals(self) -> Builder<Normal3>

Computes a vertex normal for each vertex as an area-weighted average of normals of the faces adjacent to it.

The algorithm is as follows:

1. Initialize the normal of each vertex to 0
2. For each face:
   1. Take the cross product of two of the face’s edge vectors
   2. Add the result to the normal of each of the face’s vertices.
3. Normalize each vertex normal to unit length.

This is an eager operation, that is, only vertices currently added to the builder are transformed. The attribute type of the result is Normal3; the vertex type it accepts is changed accordingly.

Trait Implementations

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

fn clone(&self) -> Builder<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 Builder<A, S>

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

Formats the value using the given formatter.

impl<A> Default for Builder<A>

fn default() -> Self

Returns an empty builder.