Skip to main content

webizen_render/geo_viewport/
sky_atmosphere_limb.rs

1// SPDX-License-Identifier: MIT OR Apache-2.0
2//! Re-exports spherical atmospheric limb & aerial perspective, Gerstner waves, hypsometric tinting,
3//! and GPU picking from `etalon_render::geo_viewport::sky_limb`.
4
5pub use etalon_render::geo_viewport::sky_limb::*;
6
7#[cfg(test)]
8mod tests {
9    use super::*;
10
11    #[inline]
12    fn norm3(a: [f32; 3]) -> f32 {
13        (a[0] * a[0] + a[1] * a[1] + a[2] * a[2]).sqrt()
14    }
15
16    #[test]
17    fn test_atmosphere_params_size() {
18        assert_eq!(core::mem::size_of::<AtmosphereParams>(), 64);
19    }
20
21    #[test]
22    fn test_sky_limb_and_aerial_perspective() {
23        let params = AtmosphereParams {
24            planet_radius_m: 6_371_000.0,
25            atmosphere_top_m: 100_000.0,
26            rayleigh_scale_h_m: 8_000.0,
27            mie_scale_h_m: 1_200.0,
28            beta_rayleigh: [5.8e-6, 13.5e-6, 33.1e-6],
29            mie_g: 0.76,
30            beta_mie: [21.0e-6, 21.0e-6, 21.0e-6],
31            sun_intensity: 20.0,
32            sun_dir: [0.0, 1.0, 0.0],
33            ozone_peak_h_m: 25_000.0,
34        };
35
36        let (zenith_rad, zenith_trans) =
37            evaluate_sky_limb_and_aerial_perspective(&params, 10.0, [0.0, 1.0, 0.0], 100_000.0, 16);
38        assert!(
39            zenith_rad[2] > zenith_rad[0],
40            "Zenith scattered light must be blue dominant"
41        );
42        assert!(zenith_trans[0] > 0.0 && zenith_trans[0] <= 1.0);
43
44        let mut sunset_params = params;
45        sunset_params.sun_dir = [1.0, 0.0, 0.0];
46        let (_, sunset_trans) = evaluate_sky_limb_and_aerial_perspective(
47            &sunset_params,
48            10.0,
49            [1.0, 0.05, 0.0],
50            80_000.0,
51            16,
52        );
53        assert!(
54            sunset_trans[0] > sunset_trans[2],
55            "Sunset horizon transmittance preserves red over blue"
56        );
57
58        let (_, near_trans) =
59            evaluate_sky_limb_and_aerial_perspective(&params, 10.0, [1.0, 0.0, 0.0], 1_000.0, 8);
60        let (_, far_trans) =
61            evaluate_sky_limb_and_aerial_perspective(&params, 10.0, [1.0, 0.0, 0.0], 50_000.0, 8);
62        assert!(
63            near_trans[0] > far_trans[0],
64            "Aerial perspective transmittance decays over distance"
65        );
66    }
67
68    #[test]
69    fn test_gerstner_waves_and_foam() {
70        let sample = evaluate_water_wave_and_foam([15.0, 25.0], 2.0, 50.0, [1.0, 0.0], 1.8, 0.6);
71        let n_len = norm3(sample.normal_xyz);
72        assert!((n_len - 1.0).abs() < 1e-4, "Wave normal must be normalized");
73
74        let grazing = evaluate_water_wave_and_foam([0.0, 0.0], 0.0, 50.0, [1.0, 0.0], 1.0, 0.0);
75        assert!(
76            (grazing.fresnel_reflectance - 1.0).abs() < 1e-3,
77            "Grazing Fresnel must approach 1.0"
78        );
79        let normal_inc = evaluate_water_wave_and_foam([0.0, 0.0], 0.0, 50.0, [1.0, 0.0], 1.0, 1.0);
80        assert!(
81            (normal_inc.fresnel_reflectance - 0.02).abs() < 1e-3,
82            "Normal incidence must match R0"
83        );
84
85        let shallow = evaluate_water_wave_and_foam([0.0, 0.0], 0.0, 0.5, [1.0, 0.0], 2.0, 0.5);
86        let deep = evaluate_water_wave_and_foam([0.0, 0.0], 0.0, 100.0, [1.0, 0.0], 2.0, 0.5);
87        assert!(
88            shallow.shore_foam_weight > 0.4,
89            "Shallow breaking water generates foam"
90        );
91        assert!(
92            deep.shore_foam_weight < 0.05,
93            "Deep water has negligible shore foam"
94        );
95    }
96
97    #[test]
98    fn test_hypsometric_contours_and_picking() {
99        let dem = [50.0, 400.0, 1000.0, 1000.0];
100        let slope = [0.05, 0.05, 0.05, 0.05];
101        let mut out = [[0u8; 4]; 4];
102        shade_hypsometric_and_contours_into(&dem, &slope, 0.0, 2000.0, 100.0, 5, &mut out).unwrap();
103        assert_eq!(out[0][3], 255);
104        assert!(out[2][0] > 0);
105
106        let mut id_buf = [0u64; 25];
107        let mut depth_buf = [1.0f32; 25];
108        id_buf[2 * 5 + 2] = (12u64 << 32) | 101u64;
109        depth_buf[2 * 5 + 2] = 0.6;
110        id_buf[2 * 5 + 3] = (14u64 << 32) | 202u64;
111        depth_buf[2 * 5 + 3] = 0.3;
112
113        let hit = resolve_gpu_picking_id_aperture(&id_buf, &depth_buf, 5, 5, 2, 2, 1);
114        assert_eq!(
115            hit,
116            Some((202, 14, 3, 2, 0.3)),
117            "Must pick closest depth within aperture"
118        );
119        let miss = resolve_gpu_picking_id_aperture(&id_buf, &depth_buf, 5, 5, 0, 0, 0);
120        assert_eq!(miss, None);
121    }
122}