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.

Related

• audio-buffer
• audio-buffer-utils
• pcm-convert

License

© 2017 Dmitry Yv. MIT License