iced_audio 0.0.3

Audio based widgets for use in the Rust iced GUI library
Documentation

iced_audio

Audio based widgets for the iced GUI library for Rust

This crate is currently experimental and incomplete.

Run example with

cargo run --example all_widgets

or

cargo run --example all_widgets --release

Widgets partially implemented

  • HSlider - a horizontal slider (just need to add texture style variant)

Roadmap of planned widgets

Inputs

  • VSlider - vertical slider
  • HSlider - horizontal slider
  • HTickMarks - horizontal tick marks
  • VTickMark - vertical tick marks
  • HRangeSlider - a horizontal slider with two or more handles for controlling the automation range of a parameter.
  • Knob - a rotating knob with optional notches. Texture style may have optional highlight and shadow layers.
  • KnobTickMarks - tick marks around a knob
  • KnobAutoRange - an adjustable line around a Knob that represents the range of automation active on that parameter. Will have a unipolar and bipolar mode. May also have multiple of these widgets in a ring-like pattern like in the original Massive synthesizer.
  • EnvelopeEditor - adjustable points connected by lines that represent an envelope / lfo. Lines can be straight or curved, and extra points can be added or removed.
  • StepEditor - a row of vertical sliders for step automation
  • ParEqEditor - a row of points connected by lines used to control parametric equalizers. These points can also be controlled with the scroll wheel to adjust Q value.
  • Keys - piano keys that can be clicked with a mouse to play a synthesizer. Velocity is controlled by how low on the key the mouse was clicked at. It can be horizontal or vertical.
  • PitchWheel - like VSlider but the slider snaps back to the middle when the mouse is released. Texture style may have an optional highlight and shadow layer.
  • XYPad - a draggable point in a 2D square used to control 2 parameters at once

Visualizers

  • DBMeter - a meter that displays peak loudness of a signal. This can have optional colors for good headroom (green), low headroom (yellow), and peaking (red). It can have be either vertical or horizontal. It can also have an optional line showing the average loudness.
  • ReductionMeter - a meter that displays the reduction of loudness in a signal. It can be either vertical or horizontal.
  • KnobReductionMeter - same as Reduction meter but displays around a knob
  • Oscilloscope - displays oscillations of an audio signal in a given time window
  • Spectrometer - displays the amplitude of a range of frequencies from 20hz to 20000hz.
  • SpectrometerGrid - a grid behind a Spectrometer that shows frequency on x axis and amplitude on y axis
  • WaveformView - displays the peak amplitude of a signal over time. It can optionally be zoomed in and out of (like Audacity).
  • PhaseMeter - a line that shows the phase correlation of an audio signal. It can be horizontal or vertical.
  • Goniometer - displays a polar graph representing the stereo phase of an audio signal
  • WavetableView - same as oscilloscope but specifically for rendering single waveforms instead of an audio signal

Each input widget with a continuous output can accept one of four types of parameters

  • FloatParam - a linear range of f32 values
  • IntParam - a discrete range of i32 values. This will cause the widget to "step" when moved.
  • LogDBParam - a logarithmic range of decibel values. Values around 0 dB will increment slower than values farther away from 0 dB.
  • OctaveParam - a logarithmic range of frequency values. Each octave in the 10 octave spectrum (from 20 Hz to 20480 Hz) is spaced evenly.