use crate::pipeline::mid_grey_log_e;
const LUMA: [f64; 3] = [0.2126, 0.7152, 0.0722];
#[derive(Debug, Clone, Copy, PartialEq)]
pub struct Metering {
pub key: f64,
pub ev: f64,
}
impl Metering {
#[must_use]
pub fn of(pixels: &[[f64; 3]]) -> Self {
if pixels.is_empty() {
return Self { key: 0.0, ev: 0.0 };
}
let mut sum = 0.0;
for pixel in pixels {
let value = LUMA[0] * pixel[0].max(0.0)
+ LUMA[1] * pixel[1].max(0.0)
+ LUMA[2] * pixel[2].max(0.0);
if value.is_finite() {
sum += value;
}
}
let key = sum / pixels.len() as f64;
Self {
key,
ev: offset_for(key),
}
}
}
#[must_use]
pub fn offset_for(key: f64) -> f64 {
if !key.is_finite() || key <= 0.0 {
return 0.0;
}
(mid_grey_log_e() - key.log10()) / 2.0_f64.log10()
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn a_frame_of_mid_grey_needs_no_offset() {
let metered = Metering::of(&[[0.18; 3]; 64]);
assert!((metered.key - 0.18).abs() < 1e-12, "{}", metered.key);
assert!(metered.ev.abs() < 1e-9, "{}", metered.ev);
}
#[test]
fn a_frame_two_stops_dark_is_lifted_by_two() {
let metered = Metering::of(&[[0.045; 3]; 64]);
assert!((metered.ev - 2.0).abs() < 1e-9, "{}", metered.ev);
}
#[test]
fn a_frame_with_no_light_gets_no_offset() {
let metered = Metering::of(&[[0.0; 3]; 16]);
assert_eq!(metered.key, 0.0);
assert_eq!(metered.ev, 0.0);
}
#[test]
fn an_empty_frame_is_not_a_division_by_zero() {
assert_eq!(Metering::of(&[]), Metering { key: 0.0, ev: 0.0 });
}
#[test]
fn the_meter_weighs_the_channels_as_luminance() {
let metered = Metering::of(&[[1.0, 0.0, 0.0]]);
assert!((metered.key - LUMA[0]).abs() < 1e-12, "{}", metered.key);
}
#[test]
fn the_offset_lands_the_key_on_mid_grey() {
for key in [1e-3, 0.02, 0.18, 0.9] {
let metered = Metering::of(&[[key; 3]]);
let landed = key * 2.0_f64.powf(metered.ev);
assert!((landed - 0.18).abs() < 1e-9, "{key} landed at {landed}");
}
}
#[test]
fn the_mean_is_arithmetic_not_geometric() {
let mut pixels = vec![[0.0; 3]; 8];
pixels.extend(std::iter::repeat_n([1.0; 3], 8));
let metered = Metering::of(&pixels);
assert!((metered.key - 0.5).abs() < 1e-12, "{}", metered.key);
assert!((metered.ev + 1.4739).abs() < 1e-3, "{}", metered.ev);
}
#[test]
fn negatives_and_nonsense_do_not_poison_the_mean() {
let mut pixels = vec![[0.18; 3]; 4];
pixels.push([-1.0, -1.0, -1.0]);
pixels.push([f64::NAN, f64::NAN, f64::NAN]);
let metered = Metering::of(&pixels);
assert!((metered.key - 0.12).abs() < 1e-12, "{}", metered.key);
}
}