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

Methods

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..

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 positions(&self) -> &VertexAttribute<f32>

Every 3 floats corresponds to one vertex's position

pub fn normals(&self) -> Option<&VertexAttribute<f32>>

Every 3 floats corresponds to one vertex's normal.

pub fn face_tangents(&self) -> Option<&VertexAttribute<f32>>

Every 3 floats corresponds to one tangent vector - useful for normal mapping.

pub fn uvs(&self) -> Option<&VertexAttribute<f32>>

Every 2 floats corresponds to one vertex's uv.

pub fn bones_influencers(&self) -> Option<&VertexAttribute<u8>>

The indices of the joints that influence each bone.

The number of floats per vertex can vary and can be found using VertexAttribute.attribute_size().

pub fn bone_influencer_weights(&self) -> Option<&VertexAttribute<f32>>

The weights of each bone influencer.

The number of floats per vertex can vary and can be found using VertexAttribute.attribute_size().

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