molgfx-render 0.3.0

The render graph, passes and the engine that drives a frame.
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
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81

use super::*;
use molgfx_core::{ClipCap, ClipPlane};
use molgfx_math::Rgba8;

fn vertex(position: [f32; 3]) -> RibbonVertex {
    RibbonVertex {
        position,
        entity_id: 0,
        normal: [0.0, 0.0, 1.0],
        color: Rgba8::WHITE,
    }
}

#[test]
fn a_solid_plane_adds_a_closed_cross_section() {
    let mut vertices = vec![
        vertex([-1.0, -1.0, -1.0]),
        vertex([-1.0, 1.0, -1.0]),
        vertex([1.0, 1.0, -1.0]),
        vertex([1.0, -1.0, -1.0]),
        vertex([-1.0, -1.0, 1.0]),
        vertex([-1.0, 1.0, 1.0]),
        vertex([1.0, 1.0, 1.0]),
        vertex([1.0, -1.0, 1.0]),
    ];
    let mut indices = vec![
        0, 1, 2, 0, 2, 3, 4, 6, 5, 4, 7, 6, 0, 4, 5, 0, 5, 1, 1, 5, 6, 1, 6, 2, 2, 6, 7, 2, 7, 3,
        3, 7, 4, 3, 4, 0,
    ];
    let Ok(plane) = ClipPlane::from_point_normal(Vec3::ZERO, Vec3::Z) else {
        panic!("plane validates")
    };
    let Ok(clipping) = ClipSet::new(&[plane]).map(|set| set.with_cap(ClipCap::Solid)) else {
        panic!("clip set validates")
    };

    append_caps(
        &mut vertices,
        &mut indices,
        0..8,
        0..36,
        Mat4::IDENTITY,
        clipping,
    );

    assert!(vertices.len() > 8);
    assert!(indices.len() > 36);
    assert!(
        vertices[8..]
            .iter()
            .all(|cap| cap.position[2].abs() <= EPSILON)
    );
}

#[test]
fn an_open_clip_does_not_add_geometry() {
    let mut vertices = vec![
        vertex([-1.0, 0.0, -1.0]),
        vertex([1.0, 0.0, 1.0]),
        vertex([0.0, 1.0, 1.0]),
    ];
    let mut indices = vec![0, 1, 2];
    let Ok(plane) = ClipPlane::from_point_normal(Vec3::ZERO, Vec3::Z) else {
        panic!("plane validates")
    };
    let Ok(clipping) = ClipSet::new(&[plane]).map(|set| set.with_cap(ClipCap::Open)) else {
        panic!("clip set validates")
    };

    append_caps(
        &mut vertices,
        &mut indices,
        0..3,
        0..3,
        Mat4::IDENTITY,
        clipping,
    );

    assert_eq!(vertices.len(), 3);
    assert_eq!(indices.len(), 3);
}