Files
hyperframes/packages/core/src/runtime/levelTap.ts
T
Miguel Ángel 97420736d5 feat(studio): audio level meters at the timeline's right edge (#4193)
* feat(studio): audio level meters at the timeline's right edge

* test(core): cover metering started before the audio context finishes init

* fix(studio): keep meter follow after a dead preview and start bars at silence

* fix(studio): keep the 0 dB peak tick inside the meter

* fix(studio): keep the 0 dB peak tick visible without calc()

* fix(core): tap meters on the program bus, mute on a monitor gain

* style(core): wrap applyMasterGain to satisfy oxfmt
2026-09-21 16:19:30 -04:00

49 lines
1.4 KiB
TypeScript

export interface StereoLevel {
l: number;
r: number;
}
export interface LevelTap {
/** Peak of the last analyser window per channel, linear 0..1+. */
read(): StereoLevel;
dispose(): void;
}
const WINDOW = 2048;
function peak(analyser: AnalyserNode, buf: Float32Array<ArrayBuffer>): number {
analyser.getFloatTimeDomainData(buf);
let max = 0;
for (let i = 0; i < buf.length; i++) max = Math.max(max, Math.abs(buf[i] ?? 0));
return max;
}
/** A side branch off `source`; the explicit-stereo gain up-mixes mono to both channels. */
export function createLevelTap(ctx: BaseAudioContext, source: AudioNode): LevelTap {
const mix = ctx.createGain();
mix.channelCount = 2;
mix.channelCountMode = "explicit";
const splitter = ctx.createChannelSplitter(2);
const left = ctx.createAnalyser();
const right = ctx.createAnalyser();
left.fftSize = right.fftSize = WINDOW;
source.connect(mix);
mix.connect(splitter);
splitter.connect(left, 0);
splitter.connect(right, 1);
const bufL = new Float32Array(new ArrayBuffer(WINDOW * 4));
const bufR = new Float32Array(new ArrayBuffer(WINDOW * 4));
return {
read: () => ({ l: peak(left, bufL), r: peak(right, bufR) }),
dispose: () => {
try {
source.disconnect(mix);
mix.disconnect();
splitter.disconnect();
} catch {
// Source already torn down.
}
},
};
}