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
//! Spherical harmonics light probes and image-based lighting for 3DGS avatar rendering.
//!
//! This module provides:
//! - Real SH basis functions (L=0,1,2) via `lp_sh_basis_l0/l1/l2`
//! - `IrradianceSH`: 27-coefficient (9 basis × 3 channels) SH representation
//! - `CubemapProbe`: 6-face cubemap with bilinear sampling
//! - `LightProbe`: positional probe with influence radius
//! - `LightProbeBlend`: multi-probe weighted blending
//! - Diffuse IBL evaluation via `lp_evaluate_diffuse_ibl` / `lp_apply_ibl_to_gaussians`
//!
//! ## Coefficient layout (IrradianceSH)
//!
//! Interleaved RGB: `coefficients[basis_i * 3 + channel]`
//! for `basis_i` in `0..9` and `channel` in `{0=R, 1=G, 2=B}`.
//!
//! ## xorshift64 PRNG
//!
//! Monte Carlo sphere sampling uses xorshift64 to avoid an external `rand`
//! dependency. One step of the generator is:
//!
//! ```
//! let mut state: u64 = 0x2545_F491_4F6C_DD1D;
//! state ^= state << 13;
//! state ^= state >> 7;
//! state ^= state << 17;
//! if state == 0 {
//! state = 1;
//! }
//! assert_ne!(state, 0, "the generator must never latch to the zero state");
//! ```
//!
//! Implementation split across private submodules (`error`, `sh_math`,
//! `irradiance`, `sampling`, `projection`, `cubemap`, `probe`, `blend`,
//! `ibl`, `config`); every item below is re-exported at this module's root
//! unchanged, so the split is purely internal and does not move any public
//! path.
pub use ;
pub use ;
pub use ;
pub use LightProbeError;
pub use ;
pub use IrradianceSH;
pub use LightProbe;
pub use ;
pub use ;