Audio-buffer-from NPM

audio-buffer-from

Create AudioBuffer from any source.

Usage

var createBuffer = require('audio-buffer-from')

//mono-buffer 1024 samples
var abuf = createBuffer(1024)

//stereo-buffer 1024 samples
var abuf2 = createBuffer(1024, 2)

//buffer from data with bound audio context
var abuf3 = createBuffer(floatArray, {context: audioContext})

//empty 1-sample mono buffer with default context
var abuf4 = createBuffer()

//0-length no-context buffer
var abuf5 = createBuffer(0)

//from duration
var abuf6 = createBuffer({duration: 1})

//from pcm data
var abuf7 = createBuffer(new Uint8Array([0, 0, 255, 255]), 'interleaved 96000')

//from data-uri
var abuf8 = createBuffer('data:application/octet-stream;base64,AP8A/w==', 'uint8')

//from base64 string
var abuf9 = createBuffer('AAAAAAAAAAAAAIA/AACAPw==', 'float32 stereo planar')

//from node Buffer
var abuf10 = createBuffer(Buffer.from([0, 255, 0, 127]), 'interleaved')

API

audioBuffer = createBuffer(source|length, channels|format|options)

Create audio buffer from any source data or a number indicating length, pass options to ensure output buffer parameters. A channels number or format string can be used to shorthand options argument.

Source:

Type	Interpretation
`null`	Blank 1-sample length buffer.
`Number`	Length of resulting buffer.
`Array` of `Arrays`	Every subarray is considered a channel data.
`AudioBuffer`	Clone other AudioBuffer.
`AudioBufferList`	Coalesce AudioBufferList to AudioBuffer.
`Audio`	Retrieve AudioBuffer from Audio.
`Object`	Create based on `length`/`duration`, `channels`/`numberOfChannels` and `sampleRate` properties.
`Array` of `Numbers`	Raw data, interpreted by `options.format`, defaults to `float64`.
`Float32Array`	Raw `float32` data, amplitude range is `-1..+1`.
`Float64Array`	Raw `float64` data, amplitude range is `-1..+1`.
`Int8Array`	Raw `int8` data, amplitude range is `-128..+127`.
`Uint8Array`	Raw `uint8` data, amplitude range is `0..255`.
`TypedArray`	Any other typed array, described by `options.format` argument (see pcm-convert).
`ArrayBuffer`	Raw data, interpreted by `options.format`.
`Buffer`	Raw data, interpreted by `options.format`.
`base64` string	Base64-encoded data.
`dataURI` string	DataURI string.
`ndarray`	Create from ndarray instance. The `shape` property is considered as `[length, channels]`.
`ndsamples`	Create from ndsamples instance, similar to ndarray.

Options:

Property	Default	Meaning
`length`	`1`	Buffer length. If `0`, buffer is unbound from context.
`context`	`audio-context`	Audio context to bind. `null`-context creates context-free audio buffer.
`channels`, `numberOfChannels`	`1`	Buffer number of channels.
`sampleRate`, `rate`	`44100`	Buffer sample rate.
`format`	`null`	Source pcm format string or object, see audio-format. If `null`, it will be detected from the `source`.