alice-sdf 5.0.0

ALICE-SDF: 3D/Spatial Data Specialist — Store laws, not polygons. GLSL/WGSL/HLSL transpile, SVO, GPU marching cubes, texture-fit, procedural CSG. Optional bridges to alice-physics / alice-codec / libasp / alice-cache behind features.
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

//! PMY Surface TPMS SDF (Deep Fried Edition)
//!
//! PMY triply-periodic minimal surface.
//! Implicit: 2*cos(x)*cos(y)*cos(z) + sin(2x)*sin(y) + sin(x)*sin(2z) + sin(2y)*sin(z) = 0
//!
//! Author: Moroya Sakamoto

use glam::Vec3;

/// Approximate SDF for a PMY surface (TPMS)
///
/// - `scale`: spatial frequency
/// - `thickness`: shell half-thickness
#[inline(always)]
pub fn sdf_pmy(p: Vec3, scale: f32, thickness: f32) -> f32 {
    let sp = p * scale;
    let (sx, cx) = alice_det_math::sin_cos(sp.x);
    let (sy, cy) = alice_det_math::sin_cos(sp.y);
    let (sz, cz) = alice_det_math::sin_cos(sp.z);
    // Double-angle identity: sin(2x) = 2*sin(x)*cos(x) — eliminates 3 trig calls
    let s2x = 2.0 * sx * cx;
    let s2y = 2.0 * sy * cy;
    let s2z = 2.0 * sz * cz;
    let d = (sx * s2z + ((2.0 * cx * cy) * cz + (s2x * sy))) + s2y * sz;
    d.abs() / scale - thickness
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_pmy_origin() {
        // At origin: cos=1, sin=0: d = 2*1*1*1 + 0 + 0 + 0 = 2
        let d = sdf_pmy(Vec3::ZERO, 1.0, 0.1);
        assert!((d - 1.9).abs() < 0.01, "Expected ~1.9, got {}", d);
    }

    #[test]
    fn test_pmy_periodicity() {
        let tau = 2.0 * std::f32::consts::PI;
        let d1 = sdf_pmy(Vec3::new(0.5, 0.3, 0.7), 1.0, 0.1);
        let d2 = sdf_pmy(Vec3::new(0.5 + tau, 0.3 + tau, 0.7 + tau), 1.0, 0.1);
        assert!((d1 - d2).abs() < 0.01, "Should be periodic");
    }

    #[test]
    fn test_pmy_finite() {
        let d = sdf_pmy(Vec3::new(1.0, 2.0, 3.0), 2.0, 0.05);
        assert!(d.is_finite());
    }
}