import Tone from "../core/Tone";
import "../effect/MidSideEffect";
import "../signal/Signal";
import "../signal/Multiply";
import "../signal/Subtract";
/**
* @class Applies a width factor to the mid/side seperation.
* 0 is all mid and 1 is all side.
* Algorithm found in [kvraudio forums](http://www.kvraudio.com/forum/viewtopic.php?t=212587).
*
*
* Mid *= 2*(1-width)
* Side *= 2*width
*
*
* @extends {Tone.MidSideEffect}
* @constructor
* @param {NormalRange|Object} [width] The stereo width. A width of 0 is mono and 1 is stereo. 0.5 is no change.
*/
Tone.StereoWidener = function(){
var options = Tone.defaults(arguments, ["width"], Tone.StereoWidener);
Tone.MidSideEffect.call(this, options);
/**
* The width control. 0 = 100% mid. 1 = 100% side. 0.5 = no change.
* @type {NormalRange}
* @signal
*/
this.width = new Tone.Signal(options.width, Tone.Type.NormalRange);
this._readOnly(["width"]);
/**
* Two times the (1-width) for the mid channel
* @type {Tone.Multiply}
* @private
*/
this._twoTimesWidthMid = new Tone.Multiply(2);
/**
* Two times the width for the side channel
* @type {Tone.Multiply}
* @private
*/
this._twoTimesWidthSide = new Tone.Multiply(2);
/**
* Mid multiplier
* @type {Tone.Multiply}
* @private
*/
this._midMult = new Tone.Multiply();
this._twoTimesWidthMid.connect(this._midMult, 0, 1);
this.midSend.chain(this._midMult, this.midReturn);
/**
* 1 - width
* @type {Tone.Subtract}
* @private
*/
this._oneMinusWidth = new Tone.Subtract();
this._oneMinusWidth.connect(this._twoTimesWidthMid);
Tone.connect(this.context.getConstant(1), this._oneMinusWidth, 0, 0);
this.width.connect(this._oneMinusWidth, 0, 1);
/**
* Side multiplier
* @type {Tone.Multiply}
* @private
*/
this._sideMult = new Tone.Multiply();
this.width.connect(this._twoTimesWidthSide);
this._twoTimesWidthSide.connect(this._sideMult, 0, 1);
this.sideSend.chain(this._sideMult, this.sideReturn);
};
Tone.extend(Tone.StereoWidener, Tone.MidSideEffect);
/**
* the default values
* @static
* @type {Object}
*/
Tone.StereoWidener.defaults = {
"width" : 0.5
};
/**
* Clean up.
* @returns {Tone.StereoWidener} this
*/
Tone.StereoWidener.prototype.dispose = function(){
Tone.MidSideEffect.prototype.dispose.call(this);
this._writable(["width"]);
this.width.dispose();
this.width = null;
this._midMult.dispose();
this._midMult = null;
this._sideMult.dispose();
this._sideMult = null;
this._twoTimesWidthMid.dispose();
this._twoTimesWidthMid = null;
this._twoTimesWidthSide.dispose();
this._twoTimesWidthSide = null;
this._oneMinusWidth.dispose();
this._oneMinusWidth = null;
return this;
};
export default Tone.StereoWidener;