demosaic 0.3.0

Demosaicing algorithms for Bayer and X-Trans CFA sensors
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

/// Convert linear RGB to CIELab.
///
/// Uses a fixed sRGB/D65 matrix for the RGB→XYZ step. This is used by
/// Markesteijn for homogeneity comparison — exact colorimetric accuracy
/// is not required, only consistent relative distances.
#[inline]
pub fn rgb_to_lab(r: f32, g: f32, b: f32) -> [f32; 3] {
    // sRGB linear → XYZ (D65)
    let x = 0.4124564 * r + 0.3575761 * g + 0.1804375 * b;
    let y = 0.2126729 * r + 0.7151522 * g + 0.0721750 * b;
    let z = 0.0193339 * r + 0.1191920 * g + 0.9503041 * b;

    // D65 white point
    let xn = 0.95047;
    let yn = 1.0;
    let zn = 1.08883;

    let fx = lab_f(x / xn);
    let fy = lab_f(y / yn);
    let fz = lab_f(z / zn);

    let l = 116.0 * fy - 16.0;
    let a = 500.0 * (fx - fy);
    let b_val = 200.0 * (fy - fz);

    [l, a, b_val]
}

#[inline(always)]
fn lab_f(t: f32) -> f32 {
    const DELTA_CB: f32 = (6.0 / 29.0) * (6.0 / 29.0) * (6.0 / 29.0);
    const LINEAR_SCALE: f32 = 1.0 / (3.0 * (6.0 / 29.0) * (6.0 / 29.0));
    const LINEAR_OFFSET: f32 = 4.0 / 29.0;

    if t > DELTA_CB {
        fast_cbrt(t)
    } else {
        t * LINEAR_SCALE + LINEAR_OFFSET
    }
}

/// Fast cube root approximation matching LibRaw's approach.
///
/// LibRaw uses an integer LUT (`cbrt[0x10000]`); darktable uses OpenCL fast-math.
/// This uses bit manipulation + one Newton-Raphson refinement, which is actually
/// more accurate than LibRaw's 16-bit LUT (~0.1% error vs ~0.15%).
///
/// Only used for homogeneity comparison — never affects final RGB output.
#[inline(always)]
fn fast_cbrt(x: f32) -> f32 {
    if x <= 0.0 { return 0.0; }
    let approx = f32::from_bits(x.to_bits() / 3 + 0x2a508000);
    // One Newton-Raphson step: y = (2*y + x/(y*y)) / 3
    (2.0 * approx + x / (approx * approx)) * (1.0 / 3.0)
}

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

    #[test]
    fn white_is_l100() {
        let [l, a, b] = rgb_to_lab(1.0, 1.0, 1.0);
        assert!((l - 100.0).abs() < 0.5, "L={l}");
        assert!(a.abs() < 1.0, "a={a}");
        assert!(b.abs() < 1.0, "b={b}");
    }

    #[test]
    fn black_is_l0() {
        let [l, a, b] = rgb_to_lab(0.0, 0.0, 0.0);
        assert!(l.abs() < 0.5, "L={l}");
        assert!(a.abs() < 0.5, "a={a}");
        assert!(b.abs() < 0.5, "b={b}");
    }
}