Struct Falloff 

pub struct Falloff { /* private fields */ }

Levels that rise at once and fall under gravity, as cava’s bars do: a level that drops is not followed down at once, but falls faster and faster, by g more each update, until it meets the new level. Rises are followed at once. Keep one per view, and update it once a frame with the new levels (bands).

use rich_ext::dsp::Falloff;

let mut bars = Falloff::gravity(0.1);
assert_eq!(bars.update(&[1.0]), [1.0]);
// Silence: down by 0.1, then 0.2, then 0.3 more, then at the floor.
assert_eq!(bars.update(&[0.0]), [0.9]);
assert!((bars.update(&[0.0])[0] - 0.7).abs() < 1e-12);
assert!((bars.update(&[0.0])[0] - 0.4).abs() < 1e-12);
assert_eq!(bars.update(&[0.0]), [0.0]);
// A rise is shown at once.
assert_eq!(bars.update(&[0.8]), [0.8]);

Implementations

impl Falloff

pub fn gravity(g: f64) -> Self

Levels falling g faster each update (in the levels’ units per update, per update); 0 or less follows every drop at once.

pub fn update(&mut self, levels: &[f64]) -> &[f64]

Take the newest levels and return those to show. A level the last update did not have starts where it is; a NaN level is taken as silence, so the shown level falls.

pub fn levels(&self) -> &[f64]

The levels the last update returned.

pub fn reset(&mut self)

Forget the levels: the next update starts afresh.

Trait Implementations

impl Clone for Falloff

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 Falloff

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

Formats the value using the given formatter.

impl Default for Falloff

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for Falloff

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Falloff