Module bismuth::mesh

This module provides tools for generating meshes for simple shapes like cubes and spheres.

The interface is iterator-based and begins with a unit shape and manipulates its constituent primitives like points, lines, and polygons. All shapes provide position information and some can additionally generate index, texture, and conjoint point information as well.

Examples

Generating position and index data for a scaled sphere mesh:

use bismuth::mesh::{ConjointPoints, IndexPolygons, Points, Triangulate};
use bismuth::mesh::sphere::UVSphere;

let sphere = UVSphere::with_unit_radius(16, 16);
let positions: Vec<_> = sphere
    .conjoint_points() // Get the unique set of points.
    .map(|point| point * 10.0) // Scale the points by 10.
    .collect();
let indeces: Vec<_> = sphere
    .index_polygons() // Get indeces into the unique set of points as polygons.
    .triangulate() // Decompose the polygons into triangles.
    .points() // Decompose the triangles into points (indeces).
    .collect();

Modules

cube
sphere

Structs

Line
Quad
Triangle

Enums

Polygon

Traits

ConjointPoints
IndexPolygons
Lines
MapPoints
Points
Polygons
Rotate
Subdivide
Tetrahedrons
TexturePolygons
Triangulate