roomeq-model 0.5.5

RoomEQ configuration, pipeline, and DSP-chain contracts
Documentation
use super::default::default_cea2034_max_db;
use super::default::default_cea2034_max_q;
use super::default::default_cea2034_min_db;
use super::default::default_cea2034_num_filters;
use super::default::default_cea2034_version;
use super::default::default_nearfield_threshold;
use super::types::Cea2034CorrectionMode;
use schemars::JsonSchema;
use serde::{Deserialize, Serialize};

/// CEA2034 speaker pre-correction configuration
#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema)]
pub struct Cea2034CorrectionConfig {
    /// Enable CEA2034 speaker pre-correction
    #[serde(default)]
    pub enabled: bool,
    /// Speaker name on spinorama.org (overrides speaker_name from MeasurementSource)
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub speaker_name: Option<String>,
    /// Measurement version on spinorama.org (default: "asr")
    #[serde(default = "default_cea2034_version")]
    pub version: String,
    /// Correction mode: flat or auto (flat Listening Window pre-correction).
    /// `score` is rejected by validation: the Harman speaker score is
    /// anechoic-only and unsupported in roomeq.
    #[serde(default)]
    pub correction_mode: Cea2034CorrectionMode,
    /// Manual listening distance override in meters
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub listening_distance_m: Option<f64>,
    /// System round-trip latency in ms (for distance computation from impulse response)
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub system_latency_ms: Option<f64>,
    /// Distance threshold in meters for auto-mode diagnostics (default: 2.0m)
    #[serde(default = "default_nearfield_threshold")]
    pub nearfield_threshold_m: f64,
    /// Override minimum correction frequency in Hz (Schroeder frequency)
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub min_freq: Option<f64>,
    /// Number of PEQ filters for speaker correction (default: 5)
    #[serde(default = "default_cea2034_num_filters")]
    pub num_filters: usize,
    /// Maximum Q factor (default: 3.0)
    #[serde(default = "default_cea2034_max_q")]
    pub max_q: f64,
    /// Maximum boost in dB (default: 3.0)
    #[serde(default = "default_cea2034_max_db")]
    pub max_db: f64,
    /// Minimum gain in dB (default: -12.0)
    #[serde(default = "default_cea2034_min_db")]
    pub min_db: f64,
}

impl Default for Cea2034CorrectionConfig {
    fn default() -> Self {
        Self {
            enabled: false,
            speaker_name: None,
            version: default_cea2034_version(),
            correction_mode: Cea2034CorrectionMode::default(),
            listening_distance_m: None,
            system_latency_ms: None,
            nearfield_threshold_m: default_nearfield_threshold(),
            min_freq: None,
            num_filters: default_cea2034_num_filters(),
            max_q: default_cea2034_max_q(),
            max_db: default_cea2034_max_db(),
            min_db: default_cea2034_min_db(),
        }
    }
}