indicatrix 0.3.0

A physically-based spectral gemstone renderer that turns GemCAD-style cutting schedules into rendered output.
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

//! Determinism: two dispatches of `transport_main` against byte-identical input.

use crate::{
    optics::raytracer::{
        LightingPreset, compute_illuminant_white_balance, illuminant_temperature_k,
    },
    renderer::buffers::{GpuGemMaterial, GpuTransportParams, transport_env_mode},
};

use super::{
    all_polished_finishes, camera_params_for, dispatch_transport, round_brilliant_planes,
    test_camera, tier3_material,
};

#[derive(Debug, Clone)]
pub struct DeterminismResult {
    pub total_values: usize,
    pub mismatches: usize,
}

impl DeterminismResult {
    #[must_use]
    pub const fn passed(&self) -> bool {
        self.mismatches == 0
    }
}

/// Two dispatches of `transport_main` against byte-identical input.
///
/// Same material, planes, camera, and params both times -- per-thread pixel ownership
/// and no atomics means GPU scheduling order can never affect the result (see
/// `shaders/spectral_transport.wgsl`'s doc comment), so the two runs' `out_xyz` buffers
/// must be bit-for-bit identical.
#[must_use]
pub fn run_determinism(ctx: &crate::renderer::gpu::GpuContext) -> DeterminismResult {
    let camera = test_camera();
    let (width, height, samples) = (32u32, 32u32, 16u32);
    let planes = round_brilliant_planes();
    let material = tier3_material();
    let gpu_material = GpuGemMaterial::encode(&material);
    let camera_params = camera_params_for(&camera, width, height, samples);
    let temp_k = illuminant_temperature_k(LightingPreset::Daylight);
    let wb = compute_illuminant_white_balance(temp_k);
    let params = GpuTransportParams::new(
        width * height,
        10,
        0,
        transport_env_mode::STUDIO_RIG,
        0.0,
        temp_k,
        1.0,
        1.0,
        0.0,
        0.0,
        wb.to_array(),
    );
    let total = (width * height * samples) as usize;

    let finishes = all_polished_finishes(planes.len());
    let run1 = dispatch_transport(
        ctx,
        &camera_params,
        &params,
        &gpu_material,
        &planes,
        &finishes,
        total,
    );
    let run2 = dispatch_transport(
        ctx,
        &camera_params,
        &params,
        &gpu_material,
        &planes,
        &finishes,
        total,
    );

    let mismatches = run1
        .xyz
        .iter()
        .zip(run2.xyz.iter())
        .filter(|(a, b)| a.to_bits() != b.to_bits())
        .count();

    DeterminismResult {
        total_values: run1.xyz.len(),
        mismatches,
    }
}