Class AudioAnalyser

Wraps an AnalyserNode for visualization and level metering. Acts as a pass-through node — connect a source to input and (optionally) output onward — so it can tap any point of the graph without changing the signal. Reuse the out typed arrays across frames to avoid per-frame allocation.

const a = audio.createAnalyser();
bus.connect(a.input);            // tap the bus
const wave = new Float32Array(a.node.fftSize);
function draw() { a.getWaveform(wave); ... }

Index

Constructors

constructor

new AudioAnalyser(
ctx: BaseAudioContext,
opts?: AudioAnalyserOptions,
): AudioAnalyser
Parameters
- ctx: BaseAudioContext
- opts: AudioAnalyserOptions = {}
Returns AudioAnalyser
- Defined in src/audio/audio_analyser.ts:27

Properties

`Readonly`node

node: AnalyserNode

The underlying analyser. Connect sources here; this is also input.

Accessors

input

get input(): AudioNode
Node to connect sources into.

Returns AudioNode
- Defined in src/audio/audio_analyser.ts:34

output

get output(): AudioNode
Node to connect onward (the analyser is a transparent pass-through).

Returns AudioNode
- Defined in src/audio/audio_analyser.ts:39

binCount

get binCount(): number
Number of frequency bins (fftSize / 2).

Returns number
- Defined in src/audio/audio_analyser.ts:44

fftSize

get fftSize(): number
Returns number
- Defined in src/audio/audio_analyser.ts:82
set fftSize(value: number): void
Parameters
- value: number
Returns void
- Defined in src/audio/audio_analyser.ts:85

smoothing

get smoothing(): number
Returns number
- Defined in src/audio/audio_analyser.ts:90
set smoothing(value: number): void
Parameters
- value: number
Returns void
- Defined in src/audio/audio_analyser.ts:93

Methods

getWaveform

getWaveform(out?: Float32Array<ArrayBuffer>): Float32Array<ArrayBuffer>
Fill out with the current time-domain waveform in [-1, 1]. Allocates a Float32Array(fftSize) if out is omitted. Returns the array used.
Parameters
- Optionalout: Float32Array<ArrayBuffer>
Returns Float32Array<ArrayBuffer>
- Defined in src/audio/audio_analyser.ts:52

getFrequencies

getFrequencies(out?: Float32Array<ArrayBuffer>): Float32Array<ArrayBuffer>
Fill out with the current frequency spectrum in dB (typically -100..0). Allocates a Float32Array(binCount) if out is omitted. Returns the array.
Parameters
- Optionalout: Float32Array<ArrayBuffer>
Returns Float32Array<ArrayBuffer>
- Defined in src/audio/audio_analyser.ts:62

getLevel

getLevel(): number
Root-mean-square amplitude of the current waveform in [0, 1] — a cheap loudness/level estimate for meters and reactive visuals.

Returns number
- Defined in src/audio/audio_analyser.ts:72

disconnect

disconnect(): void
Disconnect the analyser from the graph.

Returns void
- Defined in src/audio/audio_analyser.ts:98

Class AudioAnalyser

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns AudioAnalyser

Properties

`Readonly`node

Accessors

input

Returns AudioNode

output

Returns AudioNode

binCount

Returns number

fftSize

Returns number

Parameters

Returns void

smoothing

Returns number

Parameters

Returns void

Methods

getWaveform

Parameters

Returns Float32Array<ArrayBuffer>

getFrequencies

Parameters

Returns Float32Array<ArrayBuffer>

getLevel

Returns number

disconnect

Returns void

Settings

On This Page

Class AudioAnalyser

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns AudioAnalyser

Properties

Readonlynode

Accessors

input

Returns AudioNode

output

Returns AudioNode

binCount

Returns number

fftSize

Returns number

Parameters

Returns void

smoothing

Returns number

Parameters

Returns void

Methods

getWaveform

Parameters

Returns Float32Array<ArrayBuffer>

getFrequencies

Parameters

Returns Float32Array<ArrayBuffer>

getLevel

Returns number

disconnect

Returns void

Settings

On This Page

`Readonly`node