/render

:eyeglasses: Stream for rendering audio data

Primary LanguageJavaScript

Audio-render is a pass-through audio stream, providing structure for rendering stream audio data.

It resolves common routines like frequency analysis (fft), buffering data, reading pcm format, providing unified API for rendering both in node/browser, events, options, hooks etc. Creating new rendering components based on audio-render is as simple as creating them from scratch, but times more reliable. It is also useful for creating quick debuggers.

Usage

$ npm install audio-render

myAudioStream
.pipe(Render(function (canvas) {
	var data = this.getFloatTimeDomainData();

	//draw volume, spectrum, spectrogram, waveform — any data you need
}))
.pipe(Speaker());

API

var Generator = require('audio-generator');
var Speaker = require('audio-speaker');
var RenderStream = require('audio-render');
var isBrowser = require('is-browser');


//create rendering stream from passed options
var renderer = RenderStream({
	//custom rendering function, can be passed instead of options
	render: function (canvas) {
		//see audio-analyser for API
		var fdata = this.getFrequencyData();
		var waveform = this.getTimeData(size);

		//or use web-audio-api AnalyserNode methods here
		this.getFloatFrequencyData(new Float32Array(self.frequencyBinCount));
		this.getFloatTimeDomainData(new Float32Array(self.fftSize));
	},

	//channel number to render, 0 - L, 1 - R, ...
	channel: 0,

	//FPS (node only)
	framesPerSecond: 20,

	//max amount of data to store, number of samples
	bufferSize: 44100,

	//custom canvas (optinal), if you need to render along with other renderer
	canvas: undefined,

	//Analysis options

	//Magnitude diapasone, in dB
	minDecibels: -100,
	maxDecibels: 0,

	// Number of points to grab for fft
	fftSize: 1024,

	// Number of points to plot for fft
	frequencyBinCount: 1024/2,

	// Smoothing, or the priority of the old data over the new data
	smoothingTimeConstant: 0.2

	//...any pcm format options, if required. See pcm-util below.
});


//Depending on the enviromnent, expose canvas
isBrowser && document.body.appendChild(renderer.canvas);

renderer.on('render', function (canvas, data) {
	process.stdout.write(canvas._canvas.frame());
});


//If renderer is not piped, it works as a sink, else - as pass-through
Generator().pipe(renderer).pipe(Speaker());

Related

audio-analyser — audio analyser stream.
audio-spectrum — render audio spectrum.
audio-spectrogram — render audio spectrogram.
audio-waveform — render audio waveform.
audio-stat — render any kind of audio info: waveform, spectrogram etc.
audio-spiral — render spiral spectrogram, based on audio-render.
drawille-canvas — node/browser canvas class.
pcm-util — utils for work with pcm-streams.