Spectrum Analyzer API

Real-time audio frequency analysis with windowing and dB conversion.

createSpectrumAnalyzer()

Creates a spectrum analyzer instance.

Signature

function createSpectrumAnalyzer(
  config?: Partial<SpectrumAnalyzerConfig>
): SpectrumAnalyzer;

Example

import { createSpectrumAnalyzer, WindowType } from 'webgpu-fft';

const analyzer = createSpectrumAnalyzer({
  fftSize: 2048,
  windowType: WindowType.Hann,
  sampleRate: 44100,
});

SpectrumAnalyzer Class

Properties

Property	Type	Description
fftSize	number	FFT size (power of 2)
sampleRate	number	Audio sample rate in Hz
windowType	WindowType	Current window function

Methods

analyze()

Analyzes an audio buffer and returns dB values.

analyze(buffer: Float32Array): Float32Array;

Parameters:

• buffer — Audio samples (real-valued)

Returns: Float32Array — Magnitude in dB per frequency bin.

const audioBuffer = new Float32Array(2048);
// ... fill with audio samples from Web Audio API ...

const spectrum = analyzer.analyze(audioBuffer);
// spectrum[i] is the dB value for bin i

getFrequencies()

Returns the frequency values for each bin.

getFrequencies(): Float32Array;

const frequencies = analyzer.getFrequencies();
console.log(`Bin 10 corresponds to ${frequencies[10]} Hz`);

dispose()

Releases resources.

dispose(): void;

SpectrumAnalyzerConfig Type

interface SpectrumAnalyzerConfig {
  /** FFT size (power of 2, default 2048) */
  fftSize: number;
  /** Window function type */
  windowType: WindowType;
  /** Audio sample rate in Hz (default 44100) */
  sampleRate: number;
}

WindowType Enum

enum WindowType {
  Rectangular = 'rectangular',
  Hann = 'hann',
  Hamming = 'hamming',
  Blackman = 'blackman',
  FlatTop = 'flattop',
}

Related

• Spectrum Analysis Tutorial — Usage guide
• Window Functions — Window function details