Struct blender_mesh::SingleIndexedVertexAttributes

pub struct SingleIndexedVertexAttributes { /* fields omitted */ }

Most 3D model file formats export vertex data with multiple indices.

There might be indices for the positions, normals and uvs.

The SingleIndexVertexData is vertex data that only has one index.

When we've run BlenderMesh.combine_vertex_indices we'll end up generating SingleIndexVertexData

Implementations

impl SingleIndexedVertexAttributes

pub fn face_weight_normals(&mut self) -> Result<(), WeightedNormalsError>

Alter normals to be both surface weighted (connected triangle size) and angle weighted (angle of connected triangle corner)

@see http://www.bytehazard.com/articles/vertnorm.html

TODO: We could also implement this for multi-indexed - but we should wait until we refactor / replace the combine_indices function because, for example, if we weight normals before we calculate face tangents our face tangents will be incorrect. In general this entire crate needs to be heavily TDD"d and refactored into something clean..

TODO: When we combine normals we'll end up with a lot of vertices that have the same data so we should dedupe the vertices / indices

impl SingleIndexedVertexAttributes

pub fn interleave<T: Copy>(
    attribs: &[&VertexAttribute<T>]
) -> Result<Vec<T>, InterleaveError>

Combine anu number of vertex attributes into a single buffer of vertex data.

Say you have positions: [0., 1., 2., 10., 11., 12.] with attribute size 3 uvs : [0., 1., 1., 1.]

This would get stitched together as [0., 1., 2., 0., 1., 10., 11., 12., 1., 1.]

More generally, say you have attributes P with size 3, U with size 2, N with size 3.

They'll get interleaved as [ P0, P0, P0, U0, U0, N0, N0, P1, P1, P1, U1, U1, N1, N1, ... ],

impl SingleIndexedVertexAttributes

pub fn indices(&self) -> &Vec<u16>

For SingleIndexVertexData every 3 indices corresponds to one triangle.

There can not be any other faces (quads, ngons) - only triangles.

pub fn vertices(&self) -> &Vec<Vertex>

All of the vertex data for the mesh.

You can index into this data using SingleIndexedVertexAttributes

Trait Implementations

impl Debug for SingleIndexedVertexAttributes

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

Formats the value using the given formatter.

impl Default for SingleIndexedVertexAttributes

fn default() -> SingleIndexedVertexAttributes

Returns the "default value" for a type.

impl<'de> Deserialize<'de> for SingleIndexedVertexAttributes

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

Deserialize this value from the given Serde deserializer.

impl PartialEq<SingleIndexedVertexAttributes> for SingleIndexedVertexAttributes

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

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

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

This method tests for !=.

impl Serialize for SingleIndexedVertexAttributes

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

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for SingleIndexedVertexAttributes