Waveform

A time-domain envelope visualizer that draws the min/max amplitude of the signal over time. It sits in the chain as a pass-through, so audio flows through unchanged.

waveform

Waveform - Time-domain envelope display showing min/max amplitude.

Param	Type	Description
in	signal	Input signal
name	string	Display label (optional)
opts	record	Options (optional)

Options:

Option	Type	Default	Description
width	number / string	200	Width in pixels, or "100%" for full width
height	number / string	50	Height in pixels, or "100%" for full height
scale	number	1.0	Amplitude multiplier (2.0 = zoom in 2x)
filled	boolean	true	Filled envelope or line waveform

Displays the signal as a min/max envelope over time. In filled mode (default), shows a shaded region between the minimum and maximum amplitude at each point. In line mode (filled: false), draws a single center-line waveform similar to the oscilloscope.

// Basic waveform
saw(110) |> waveform(@) |> out(@)

scale

Amplitude multiplier for the displayed envelope. Useful when the signal is quiet and you want to see detail without changing the actual gain.

// Zoomed in for a quiet signal
sine(440) * 0.3
    |> waveform(@, "quiet signal", {scale: 3.0})
    |> out(@)

filled

Toggle between filled-envelope mode (true, default) and line-waveform mode (false). Line mode looks similar to the oscilloscope but without trigger stabilization.

// Line waveform
sine(440) |> waveform(@, {filled: false}) |> out(@)

// Wide filled envelope
saw(55)
    |> lp(@, 400)
    |> waveform(@, "bass", {width: 400, height: 80})
    |> out(@)

Related: oscilloscope, spectrum