mirror of
https://github.com/Tonejs/Tone.js
synced 2024-11-16 16:48:00 +00:00
113 lines
No EOL
2.9 KiB
JavaScript
113 lines
No EOL
2.9 KiB
JavaScript
define(["Tone/core/Tone", "Tone/core/Buffer", "Tone/effect/Effect"], function(Tone){
|
|
|
|
"use strict";
|
|
|
|
/**
|
|
* @class Tone.Convolver is a wrapper around the Native Web Audio
|
|
* [ConvolverNode](http://webaudio.github.io/web-audio-api/#the-convolvernode-interface).
|
|
* Convolution is useful for reverb and filter emulation. Read more about convolution reverb on
|
|
* [Wikipedia](https://en.wikipedia.org/wiki/Convolution_reverb).
|
|
*
|
|
* @constructor
|
|
* @extends {Tone.Effect}
|
|
* @param {string|Tone.Buffer|Object} [url] The URL of the impulse response or the Tone.Buffer
|
|
* contianing the impulse response.
|
|
* @example
|
|
* //initializing the convolver with an impulse response
|
|
* var convolver = new Tone.Convolver("./path/to/ir.wav");
|
|
* convolver.toMaster();
|
|
* //after the buffer has loaded
|
|
* Tone.Buffer.onload = function(){
|
|
* //testing out convolution with a noise burst
|
|
* var burst = new Tone.NoiseSynth().connect(convolver);
|
|
* burst.triggerAttackRelease("16n");
|
|
* };
|
|
*/
|
|
Tone.Convolver = function(){
|
|
|
|
var options = this.optionsObject(arguments, ["url"], Tone.Convolver.defaults);
|
|
Tone.Effect.call(this, options);
|
|
|
|
/**
|
|
* convolver node
|
|
* @type {ConvolverNode}
|
|
* @private
|
|
*/
|
|
this._convolver = this.context.createConvolver();
|
|
|
|
/**
|
|
* the convolution buffer
|
|
* @type {Tone.Buffer}
|
|
* @private
|
|
*/
|
|
this._buffer = new Tone.Buffer(options.url, function(buffer){
|
|
this.buffer = buffer;
|
|
options.onload();
|
|
}.bind(this));
|
|
|
|
this.connectEffect(this._convolver);
|
|
};
|
|
|
|
Tone.extend(Tone.Convolver, Tone.Effect);
|
|
|
|
/**
|
|
* @static
|
|
* @const
|
|
* @type {Object}
|
|
*/
|
|
Tone.Convolver.defaults = {
|
|
"url" : "",
|
|
"onload" : Tone.noOp
|
|
};
|
|
|
|
/**
|
|
* The convolver's buffer
|
|
* @memberOf Tone.Convolver#
|
|
* @type {AudioBuffer}
|
|
* @name buffer
|
|
*/
|
|
Object.defineProperty(Tone.Convolver.prototype, "buffer", {
|
|
get : function(){
|
|
return this._buffer.get();
|
|
},
|
|
set : function(buffer){
|
|
this._buffer.set(buffer);
|
|
this._convolver.buffer = this._buffer.get();
|
|
}
|
|
});
|
|
|
|
/**
|
|
* Load an impulse response url as an audio buffer.
|
|
* Decodes the audio asynchronously and invokes
|
|
* the callback once the audio buffer loads.
|
|
* @param {string} url The url of the buffer to load.
|
|
* filetype support depends on the
|
|
* browser.
|
|
* @param {function=} callback
|
|
* @returns {Tone.Convolver} this
|
|
*/
|
|
Tone.Convolver.prototype.load = function(url, callback){
|
|
this._buffer.load(url, function(buff){
|
|
this.buffer = buff;
|
|
if (callback){
|
|
callback();
|
|
}
|
|
}.bind(this));
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* Clean up.
|
|
* @returns {Tone.Convolver} this
|
|
*/
|
|
Tone.Convolver.prototype.dispose = function(){
|
|
Tone.Effect.prototype.dispose.call(this);
|
|
this._convolver.disconnect();
|
|
this._convolver = null;
|
|
this._buffer.dispose();
|
|
this._buffer = null;
|
|
return this;
|
|
};
|
|
|
|
return Tone.Convolver;
|
|
}); |