scena 1.7.2

A Rust-native scene-graph renderer with typed scene state, glTF assets, and explicit prepare/render lifecycles.
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
86
87
88
89
90
91
92
93
94
95
96
97
98
99

use super::*;

#[test]
fn reflection_quality_known_bad_fireflies_fail_exact_reason_and_good_passes() {
    let width = 64;
    let height = 32;
    let region = RenderQualityRegion::full_frame(width, height);
    let expectation = crate::SceneRecipeQualityReflectionV1 {
        target: None,
        min_luminance_range: Some(0.12),
        min_sobel_energy: Some(0.02),
        min_chroma_range: Some(0.06),
        max_firefly_fraction: Some(0.005),
        min_bright_fraction: None,
        min_dark_fraction: None,
    };

    let bad = firefly_reflection_fixture(width, height);
    write_ppm_artifact(
        "target/gate-artifacts/render-quality/reflection-known-bad-fireflies.ppm",
        &bad,
        width,
        height,
    );
    let bad_checks = evaluate_reflection_region_quality(
        "bad-reflection",
        &bad,
        width,
        height,
        region,
        expectation.clone(),
    );
    assert!(
        bad_checks
            .iter()
            .any(|check| check.code == "reflection_firefly_outliers"
                && check.status == RenderQualityStatusV1::Failed),
        "isolated bright reflection specks must fail exact reflection_firefly_outliers: {bad_checks:#?}"
    );

    let good = structured_reflection_fixture(width, height);
    write_ppm_artifact(
        "target/gate-artifacts/render-quality/reflection-known-good-structured.ppm",
        &good,
        width,
        height,
    );
    let good_checks = evaluate_reflection_region_quality(
        "good-reflection",
        &good,
        width,
        height,
        region,
        expectation,
    );
    assert_no_failed_checks(
        &good_checks,
        "structured reflection without isolated bright specks should pass quality checks",
    );
}

#[test]
fn reflection_quality_known_bad_flat_chrome_fails_exact_reason() {
    let width = 64;
    let height = 64;
    let region = RenderQualityRegion::full_frame(width, height);
    let expectation = crate::SceneRecipeQualityReflectionV1 {
        target: None,
        min_luminance_range: Some(0.18),
        min_sobel_energy: Some(0.01),
        min_chroma_range: Some(0.0),
        max_firefly_fraction: Some(0.01),
        min_bright_fraction: Some(0.08),
        min_dark_fraction: Some(0.04),
    };

    let bad = flat_dark_chrome_fixture(width, height);
    write_ppm_artifact(
        "target/gate-artifacts/render-quality/reflection-known-bad-flat-chrome.ppm",
        &bad,
        width,
        height,
    );
    let bad_checks = evaluate_reflection_region_quality(
        "bad-flat-chrome",
        &bad,
        width,
        height,
        region,
        expectation,
    );
    assert!(
        bad_checks
            .iter()
            .any(|check| check.code == "reflection_chrome_read_missing"
                && check.status == RenderQualityStatusV1::Failed),
        "flat/dark chrome must fail exact reflection_chrome_read_missing: {bad_checks:#?}"
    );
}