mod3d-base 0.3.0

3D Models for Gl processing
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

//a Documentation
/*!

This provides a function to create [ExampleVertices] object that is a triangle of a specified size at z=0

 */

//a Imports
use super::ExampleVertices;
use crate::{
    BufferElementType, Mesh, Primitive, PrimitiveType, Renderable, ShortIndex, VertexAttr,
    VertexDesc,
};

/// Add positions, normals and indices to an [ExampleVertices] for a
/// flat upward-facing triangle on z=0 of a given size
pub fn new<R: Renderable>(eg: &mut ExampleVertices<R>, size: f32)
where
    <R as Renderable>::Descriptor: Unpin,
{
    let vertex_data = [
        -size, -size, 0.0, size, -size, 0.0, 0.0, size, 0.0, 0., 0., 1., 0., 0., 1., 0., 0., 1.,
    ];
    let index_data = [0u8, 1, 2];

    let data_vertices = eg.push_byte_buffer(Box::new(vertex_data));
    let data_indices = eg.push_byte_buffer(Box::new(index_data));

    let indices = eg.push_index_accessor(data_indices, 3, BufferElementType::UInt8, 0);

    let vertex_desc = eg.push_descriptor(data_vertices, 0, 9 * 4, 0); // stride used to be 0
    let vertices = eg.push_data_accessor(
        vertex_desc,
        VertexDesc::vec(VertexAttr::Position, BufferElementType::Float32, 3, 0),
    );

    let normal_desc = eg.push_descriptor(data_vertices, 9 * 4, 9 * 4, 0); // stride used to be 0
    let normals = eg.push_data_accessor(
        normal_desc,
        VertexDesc::vec(VertexAttr::Normal, BufferElementType::Float32, 3, 0),
    );

    // Create set of data (indices, vertex data) to by subset into by the meshes and their primitives
    eg.push_vertices(Some(indices), vertices, &[normals]);
}

/// Create a mesh for the triangle given the vertices index and
/// material index within a parent model3d::Object
///
/// The object should have had the vertices for the triangle (created
/// with new() above) added to it (using a parent [ExampleVertices])
pub fn mesh(v_id: ShortIndex, m_id: ShortIndex) -> Mesh {
    let mut mesh = Mesh::default();
    mesh.add_primitive(Primitive::new(PrimitiveType::Triangles, v_id, 0, 3, m_id));
    mesh
}