molgfx-render 0.3.2

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
82
83
84
85

use super::tests::{camera, engine, represented_scene, structure};

#[test]
fn picking_resolves_the_global_atom_from_integer_attachments() {
    let mut engine = engine();
    let scene = represented_scene(2, 1);
    if let Err(error) = engine.render(&scene, &camera()) {
        panic!("frame renders: {error}")
    }
    let pick = match engine.pick(0, 0) {
        Ok(Some(pick)) => pick,
        Ok(None) => panic!("mock readback resolves zero ids"),
        Err(error) => panic!("pick resolves: {error}"),
    };
    let Some((_, placed)) = scene.structures().next() else {
        panic!("scene has structures")
    };
    let super::PickEntity::Structure(entity) = pick.entity else {
        panic!("molecular pick resolves to a global identity")
    };
    assert_eq!(entity.dataset(), placed.dataset_id());
    assert_eq!(entity.chunk(), molgfx_core::ChunkId::new(0));
    assert_eq!(entity.kind(), molgfx_core::EntityKind::Atom);
    assert_eq!(entity.row(), molgfx_core::LogicalRow::new(0));
    assert!(pick.selection.contains(0));
    assert_eq!(pick.selection.count(3), 1);
    let outside = engine.width;
    assert!(matches!(engine.pick(outside, 0), Ok(None)));
}

#[test]
fn recycled_pick_page_rejects_an_older_submission_generation() {
    let mut engine = engine();
    let mut scene = represented_scene(2, 1);
    engine
        .render(&scene, &camera())
        .unwrap_or_else(|error| panic!("{error}"));
    engine
        .capture_pick_submission_for_test()
        .unwrap_or_else(|error| panic!("{error}"));
    let old = molgfx_core::GpuPickToken::new(0, 0);

    let source = structure();
    let asset = molgfx_core::StructureAsset::new(molgfx_core::DatasetId::new(99), &source)
        .unwrap_or_else(|error| panic!("{error}"));
    scene.add_asset(&asset);
    engine
        .render(&scene, &camera())
        .unwrap_or_else(|error| panic!("{error}"));

    let error = engine
        .resolve_pick_token_for_test(old)
        .expect_err("recycled page generation must be stale");
    assert_eq!(error.code(), "MOLGFX-E0082");
    assert!(matches!(
        error,
        crate::RenderError::Picking(molgfx_core::PickingError::StaleGeneration)
    ));
}

#[test]
fn changing_to_a_distinct_scene_rebuilds_equal_revision_pick_pages() {
    let mut engine = engine();
    let first = represented_scene(2, 1);
    let second = represented_scene(2, 1);
    engine
        .render(&first, &camera())
        .unwrap_or_else(|error| panic!("first scene renders: {error}"));
    engine
        .capture_pick_submission_for_test()
        .unwrap_or_else(|error| panic!("first picking table is captured: {error}"));
    let old = molgfx_core::GpuPickToken::new(0, 0);

    engine
        .render(&second, &camera())
        .unwrap_or_else(|error| panic!("second scene renders: {error}"));

    let error = engine
        .resolve_pick_token_for_test(old)
        .expect_err("a different scene must recycle equal-revision pages");
    assert!(matches!(
        error,
        crate::RenderError::Picking(molgfx_core::PickingError::StaleGeneration)
    ));
}