Struct DspProfile 

pub struct DspProfile {

    pub name: String,
    pub devices: Vec<String>,
    pub preamp_db: Option<f64>,
    pub filters: Vec<DspFilter>,
    pub impulses: Vec<PathBuf>,
    pub source: Vec<String>,
    pub target: Option<DspTarget>,
    pub layers: Vec<DspLayer>,
    pub group: bool,
    pub preset: bool,
    pub filters_only: bool,
    pub scope: Option<DspScope>,
    pub uid: Option<String>,
    pub origin: Option<String>,
    pub role: Option<DspRole>,
    pub measurement: Option<DspMeasurement>,
    pub fitted: Option<DspMeasurement>,
    pub tuned_for: Option<String>,
    pub original: Option<DspOriginal>,
}

Fields

name: String

devices: Vec<String>

Output devices, by name, that play through this profile.

preamp_db: Option<f64>

Gain before the filters. Unset, it is derived from the filters’ peak gain, so that no boost can push a sample past full scale.

filters: Vec<DspFilter>

Run in order, at the output rate, ahead of the impulse responses.

impulses: Vec<PathBuf>

Impulse responses as WAV files, one per sample rate the correction was exported at; a relative path is read from beside the config. Each file’s own rate is the rate it applies to.

source: Vec<String>

The files it was imported from, by name, for showing where it came from. Nothing reads them again.

target: Option<DspTarget>

For a correction installed from AutoEQ: the target it was made for, and another to move it to. See audio::dsp::targets.

layers: Vec<DspLayer>

Other profiles played first, in order: a headphone’s correction and then taste on top of it, each switched on or off. A profile with layers is a stack. See audio::dsp::Setup::load.

group: bool

A group rather than a stack of layers: exactly one of its layers plays, the one switched on, chosen as one picks a radio button. Whole presets imported together are a group: alternatives, not taste to play together.

preset: bool

A preset: a correction and its tuning saved together, its layers the correction first and then the tuning’s EQs, each on or off. What an output is set from, and what the quick EQ menu lists.

filters_only: bool

For a preset: the output plays its filters alone, with no correction (DspConfig::filters_only).

scope: Option<DspScope>

Whether it is the account’s, kept on every device signed in to its kōan server, or this device’s alone. Unset, it follows from what the profile is: see audio::dsp::profiles::scope.

uid: Option<String>

What every device calls it, made when it is first shared. Its name may change; this does not.

origin: Option<String>

The device that first shared it, by name: what tells two different profiles of one name apart when they meet.

role: Option<DspRole>

What it is for: correcting a headphone, or tuning on top of one. Unset, it follows from what the profile is: see audio::dsp::profiles::role.

measurement: Option<DspMeasurement>

A correction built from a headphone’s measurement, kept as measurement.csv in the profile’s folder, to target, as kōan saved one before it fitted bands: played as the bands squig.link’s auto-EQ fits to it, which are not written back. See fitted.

fitted: Option<DspMeasurement>

A correction fitted to a headphone’s measurement, kept as measurement.csv in the profile’s folder, and target: its filters and preamp are the bands squig.link’s auto-EQ fits, refitted when the target changes. A key of its own rather than measurement, so a build that knows only measurement plays the bands alone and not a correction of its own after them.

tuned_for: Option<String>

For a tuning: the target it was made against, by id. On a correction to another target, the difference between the two plays first, so the tuning sounds as it was made to.

original: Option<DspOriginal>

What an import made it, kept so an edit can be undone.

Implementations

impl DspProfile

pub fn measured(&self) -> Option<&DspMeasurement>

The measurement and target a correction is built from: fitted, or saved before kōan fitted bands.

impl DspProfile

pub fn sanitize(&mut self) -> Vec<String>

Bring the profile within dsp_bounds, saying what was changed: values past a bound are clamped to it, ones that are not finite are dropped with what holds them, and filters, bands, layers and points past a cap are cut off at it. Every profile is played as this leaves it, wherever it came from, so one that would deafen a listener, starve the decode thread or exhaust memory still plays, adjusted, and its page says how.

pub fn sanitized(&self) -> Self

As played: sanitized, leaving this one as it is.

Trait Implementations

impl Clone for DspProfile

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DspProfile

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for DspProfile

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for DspProfile

where DspProfile: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for DspProfile

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for DspProfile

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for DspProfile