Struct three_d::renderer::geometry::CpuMesh

pub struct CpuMesh {
    pub name: String,
    pub material_name: Option<String>,
    pub positions: Positions,
    pub indices: Option<Indices>,
    pub normals: Option<Vec<Vector3<f32>, Global>>,
    pub tangents: Option<Vec<Vector4<f32>, Global>>,
    pub uvs: Option<Vec<Vector2<f32>, Global>>,
    pub colors: Option<Vec<Color, Global>>,
}

A CPU-side version of a triangle mesh.

Fields

name: String

Name.

material_name: Option<String>

Name of the associated material, use this to match with PbrMaterial::name.

positions: Positions

The positions of the vertices. If there is no indices associated with this mesh, three contiguous positions defines a triangle, in that case, the length must be divisable by 3.

indices: Option<Indices>

The indices into the positions, normals, uvs and colors arrays which defines the three vertices of a triangle. Three contiguous indices defines a triangle, therefore the length must be divisable by 3.

normals: Option<Vec<Vector3<f32>, Global>>

The normals of the vertices.

tangents: Option<Vec<Vector4<f32>, Global>>

The tangents of the vertices, orthogonal direction to the normal. The fourth value specifies the handedness (either -1.0 or 1.0).

uvs: Option<Vec<Vector2<f32>, Global>>

The uv coordinates of the vertices.

colors: Option<Vec<Color, Global>>

The colors of the vertices. The colors are assumed to be in linear space.

Implementations

impl TriMesh

pub fn material(&self, materials: &'a [PbrMaterial]) -> Option<&'a PbrMaterial>

Returns the material for this mesh in the given list of materials. Returns None if no suitable material can be found.

impl TriMesh

pub fn transform(&mut self, transform: &Matrix4<f32>) -> Result<(), Error>

Transforms the mesh by the given transformation.

pub fn square() -> TriMesh

Returns a square mesh spanning the xy-plane with positions in the range [-1..1] in the x and y axes.

pub fn circle(angle_subdivisions: u32) -> TriMesh

Returns a circle mesh spanning the xy-plane with radius 1 and center in (0, 0, 0).

pub fn sphere(angle_subdivisions: u32) -> TriMesh

Returns a sphere mesh with radius 1 and center in (0, 0, 0).

pub fn cube() -> TriMesh

Returns an axis aligned unconnected cube mesh with positions in the range [-1..1] in all axes.

pub fn cylinder(angle_subdivisions: u32) -> TriMesh

Returns a cylinder mesh around the x-axis in the range [0..1] and with radius 1.

pub fn cone(angle_subdivisions: u32) -> TriMesh

Returns a cone mesh around the x-axis in the range [0..1] and with radius 1 at -1.0.

pub fn arrow(
    tail_length: f32,
    tail_radius: f32,
    angle_subdivisions: u32
) -> TriMesh

Returns an arrow mesh around the x-axis in the range [0..1] and with radius 1. The tail length and radius should be in the range ]0..1[.

pub fn compute_normals(&mut self)

Computes the per vertex normals and updates the normals of the mesh. It will override the current normals if they already exist.

pub fn compute_tangents(&mut self) -> Result<(), Error>

Computes the per vertex tangents and updates the tangents of the mesh. It will override the current tangents if they already exist.

pub fn for_each_vertex(&self, callback: impl FnMut(usize))

Iterates over all vertices in this mesh and calls the callback function with the index for each vertex.

pub fn for_each_triangle(&self, callback: impl FnMut(usize, usize, usize))

Iterates over all triangles in this mesh and calls the callback function with the three indices, one for each vertex in the triangle.

pub fn compute_aabb(&self) -> AxisAlignedBoundingBox

Computes the axis aligned bounding box of the mesh.

pub fn validate(&self) -> Result<(), Error>

Returns an error if the mesh is not valid.

Trait Implementations

impl Debug for TriMesh

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

Formats the value using the given formatter.

impl Default for TriMesh

fn default() -> TriMesh

Returns the “default value” for a type.