Struct iced_audio::core::param::LogDBParam

pub struct LogDBParam<ID: Debug + Copy + Clone> { /* fields omitted */ }

A Param that defines a continuous logarithmic range of dB values, with an inflection/stationary point at 0 dB

Values around 0 dB (positive and negative) will increment slower per slider movement than values farther away from 0 dB.

It stores a unique identifier of user supplied type ID. This can be an enum, u32, i32, String, etc. Each parameter must have a unique ID value!

Implementations

impl<ID: Debug + Copy + Clone> LogDBParam<ID>

pub fn new(
    id: ID,
    min: f32,
    max: f32,
    value: f32,
    default_value: f32,
    zero_normal: Normal
) -> Self

Creates a new LogDBParam

Arguments

• id - an identifier for the parameter (must be unique!)
• min - the minimum of the range in dB (inclusive), must be <= 0.0
• max - the maximum of the range in dB (inclusive), must be >= 0.0
• value - the initial value of the parameter in dB (if value falls outside the range given by min and max, then min or max will be used instead)
• default_value - the default value of the parameter in dB (if default_value falls outside the range given by min and max, then min or max will be used instead)
• zero_normal - a normal that defines where on the slider 0 decibels should be. For example, Normal::new(0.5) will have 0 dB at the center of the slider. Normals of 1.0 and 0.0 can be used for only negative or only positive decibels respectively

Panics

This will panic if

• max <= min
• min > 0.0
• max < 0.0

pub fn set_from_value(&mut self, value: f32)

Sets the parameter's value to value

If value falls outside the range given by min and max from FloatParam::new(), then min or max will be used instead.

Value to Normal calculactions will not be recalculated if the value has not changed.

pub fn set_from_normal(&mut self, normal: Normal)

Sets the parameter's value from a Normal

Normal to value calculactions will not be recalculated if the Normal has not changed.

pub fn value(&self) -> f32

Returns the parameter's value

pub fn default_value(&self) -> f32

Returns the parameter's default value

pub fn value_to_normal(&self, value: f32) -> Normal

Returns the corresponding Normal from the supplied value

pub fn normal_to_value(&self, normal: Normal) -> f32

Returns the corresponding dB value from the supplied Normal

Trait Implementations

impl<ID: Clone + Debug + Copy> Clone for LogDBParam<ID>

fn clone(&self) -> LogDBParam<ID>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<ID: Copy + Debug + Clone> Copy for LogDBParam<ID>

impl<ID: Debug + Copy + Clone> Debug for LogDBParam<ID>

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

Formats the value using the given formatter.

impl<ID: Debug + Copy + Clone> Param for LogDBParam<ID>

type ID = ID

A unique identifier of user supplied type ID. This can be an enum, u32, i32, String, etc. Each parameter must have a unique ID value!

fn id(&self) -> ID

returns the unique identifier of the parameter

fn normal(&self) -> Normal

returns the value of the parameter represented as a [Normal]

fn default_normal(&self) -> Normal

returns the default value of the parameter represented as a [Normal]