roomeq-model 0.5.5

RoomEQ configuration, pipeline, and DSP-chain contracts
Documentation
use super::default::default_all_channel_multiseat_enabled;
use super::default::default_all_channel_multiseat_strategy;
use super::default::default_max_deviation_db;
use super::default::default_multiseat_global_eq;
use super::default::default_multiseat_per_sub_peq;
use super::default::default_primary_seat_weight;
use super::types::ContinuousListeningAreaConfig;
use super::types::MultiMeasurementStrategy;
use super::types::MultiSeatStrategy;
use schemars::JsonSchema;
use serde::{Deserialize, Serialize};

/// Multi-seat optimization configuration
#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema)]
pub struct MultiSeatConfig {
    /// Enable multi-seat optimization
    #[serde(default)]
    pub enabled: bool,
    /// Optimization strategy
    #[serde(default)]
    pub strategy: MultiSeatStrategy,
    /// Index of primary seat (0-based, used with PrimaryWithConstraints strategy)
    #[serde(default)]
    pub primary_seat: usize,
    /// Maximum allowed deviation at non-primary seats (dB)
    #[serde(default = "default_max_deviation_db")]
    pub max_deviation_db: f64,
    /// Enable per-sub polarity search for MSO.
    #[serde(default)]
    pub optimize_polarity: bool,
    /// Number of per-sub all-pass filters allowed during MSO.
    #[serde(default)]
    pub allpass_filters_per_sub: usize,
    /// Optimize a per-subwoofer PEQ from that sub's measurements across all seats
    /// before the gain/delay/polarity/all-pass MSO pass.
    #[serde(default = "default_multiseat_per_sub_peq")]
    pub per_sub_peq: bool,
    /// Optimize a shared EQ on the post-MSO combined response across all seats.
    #[serde(default = "default_multiseat_global_eq")]
    pub global_eq: bool,
    /// Enable all-channel multi-seat correction for non-sub home-cinema channels.
    #[serde(default = "default_all_channel_multiseat_enabled")]
    pub all_channel_enabled: bool,
    /// Strategy used when deriving per-channel multi-measurement correction.
    #[serde(default = "default_all_channel_multiseat_strategy")]
    pub all_channel_strategy: MultiMeasurementStrategy,
    /// Optional seat weights for all-channel multi-seat correction.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub seat_weights: Option<Vec<f64>>,
    /// Relative primary-seat weight used with PrimaryWithConstraints.
    #[serde(default = "default_primary_seat_weight")]
    pub primary_seat_weight: f64,
    /// Continuous listening-area prior. Required (and only consulted) when
    /// `strategy = ContinuousArea`.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub continuous_area: Option<ContinuousListeningAreaConfig>,
}

impl Default for MultiSeatConfig {
    fn default() -> Self {
        Self {
            enabled: false,
            strategy: MultiSeatStrategy::MinimizeVariance,
            primary_seat: 0,
            max_deviation_db: default_max_deviation_db(),
            optimize_polarity: false,
            allpass_filters_per_sub: 0,
            per_sub_peq: default_multiseat_per_sub_peq(),
            global_eq: default_multiseat_global_eq(),
            all_channel_enabled: default_all_channel_multiseat_enabled(),
            all_channel_strategy: default_all_channel_multiseat_strategy(),
            seat_weights: None,
            primary_seat_weight: default_primary_seat_weight(),
            continuous_area: None,
        }
    }
}