mirror of
https://github.com/Tonejs/Tone.js
synced 2024-11-16 16:48:00 +00:00
126 lines
No EOL
2.9 KiB
JavaScript
126 lines
No EOL
2.9 KiB
JavaScript
define(["Tone/core/Tone", "Tone/component/CrossFade", "Tone/component/Merge",
|
|
"Tone/component/Split", "Tone/signal/Signal", "Tone/signal/GainToAudio"],
|
|
function(Tone){
|
|
|
|
"use strict";
|
|
|
|
/**
|
|
* @class Tone.Panner is an equal power Left/Right Panner and does not
|
|
* support 3D. Panner uses the StereoPannerNode when available.
|
|
*
|
|
* @constructor
|
|
* @extends {Tone}
|
|
* @param {NormalRange} [initialPan=0.5] The initail panner value (defaults to 0.5 = center)
|
|
* @example
|
|
* //pan the input signal hard right.
|
|
* var panner = new Tone.Panner(1);
|
|
*/
|
|
Tone.Panner = function(initialPan){
|
|
|
|
Tone.call(this);
|
|
|
|
/**
|
|
* indicates if the panner is using the new StereoPannerNode internally
|
|
* @type {boolean}
|
|
* @private
|
|
*/
|
|
this._hasStereoPanner = this.isFunction(this.context.createStereoPanner);
|
|
|
|
if (this._hasStereoPanner){
|
|
|
|
/**
|
|
* the panner node
|
|
* @type {StereoPannerNode}
|
|
* @private
|
|
*/
|
|
this._panner = this.input = this.output = this.context.createStereoPanner();
|
|
|
|
/**
|
|
* The pan control. 0 = hard left, 1 = hard right.
|
|
* @type {NormalRange}
|
|
* @signal
|
|
*/
|
|
this.pan = new Tone.Signal(0, Tone.Type.NormalRange);
|
|
|
|
/**
|
|
* scale the pan signal to between -1 and 1
|
|
* @type {Tone.WaveShaper}
|
|
* @private
|
|
*/
|
|
this._scalePan = new Tone.GainToAudio();
|
|
|
|
//connections
|
|
this.pan.chain(this._scalePan, this._panner.pan);
|
|
|
|
} else {
|
|
|
|
/**
|
|
* the dry/wet knob
|
|
* @type {Tone.CrossFade}
|
|
* @private
|
|
*/
|
|
this._crossFade = new Tone.CrossFade();
|
|
|
|
/**
|
|
* @type {Tone.Merge}
|
|
* @private
|
|
*/
|
|
this._merger = this.output = new Tone.Merge();
|
|
|
|
/**
|
|
* @type {Tone.Split}
|
|
* @private
|
|
*/
|
|
this._splitter = this.input = new Tone.Split();
|
|
|
|
/**
|
|
* The pan control. 0 = hard left, 1 = hard right.
|
|
* @type {NormalRange}
|
|
* @signal
|
|
*/
|
|
this.pan = this._crossFade.fade;
|
|
|
|
//CONNECTIONS:
|
|
//left channel is a, right channel is b
|
|
this._splitter.connect(this._crossFade, 0, 0);
|
|
this._splitter.connect(this._crossFade, 1, 1);
|
|
//merge it back together
|
|
this._crossFade.a.connect(this._merger, 0, 0);
|
|
this._crossFade.b.connect(this._merger, 0, 1);
|
|
}
|
|
|
|
//initial value
|
|
this.pan.value = this.defaultArg(initialPan, 0.5);
|
|
this._readOnly("pan");
|
|
};
|
|
|
|
Tone.extend(Tone.Panner);
|
|
|
|
/**
|
|
* Clean up.
|
|
* @returns {Tone.Panner} this
|
|
*/
|
|
Tone.Panner.prototype.dispose = function(){
|
|
Tone.prototype.dispose.call(this);
|
|
this._writable("pan");
|
|
if (this._hasStereoPanner){
|
|
this._panner.disconnect();
|
|
this._panner = null;
|
|
this.pan.dispose();
|
|
this.pan = null;
|
|
this._scalePan.dispose();
|
|
this._scalePan = null;
|
|
} else {
|
|
this._crossFade.dispose();
|
|
this._crossFade = null;
|
|
this._splitter.dispose();
|
|
this._splitter = null;
|
|
this._merger.dispose();
|
|
this._merger = null;
|
|
this.pan = null;
|
|
}
|
|
return this;
|
|
};
|
|
|
|
return Tone.Panner;
|
|
}); |