Tone.js/Tone/effect/FeedbackEffect.js
2016-09-19 23:53:07 -04:00

65 lines
1.6 KiB
JavaScript

define(["Tone/core/Tone", "Tone/effect/Effect", "Tone/signal/Signal",
"Tone/signal/Multiply", "Tone/core/Gain"], function(Tone){
"use strict";
/**
* @class Tone.FeedbackEffect provides a loop between an
* audio source and its own output. This is a base-class
* for feedback effects.
*
* @constructor
* @extends {Tone.Effect}
* @param {NormalRange|Object} [feedback] The initial feedback value.
*/
Tone.FeedbackEffect = function(){
var options = this.optionsObject(arguments, ["feedback"]);
options = this.defaultArg(options, Tone.FeedbackEffect.defaults);
Tone.Effect.call(this, options);
/**
* the gain which controls the feedback
* @type {Tone.Gain}
* @private
*/
this._feedbackGain = new Tone.Gain(options.feedback, Tone.Type.NormalRange);
/**
* The amount of signal which is fed back into the effect input.
* @type {NormalRange}
* @signal
*/
this.feedback = this._feedbackGain.gain;
//the feedback loop
this.effectReturn.chain(this._feedbackGain, this.effectSend);
this._readOnly(["feedback"]);
};
Tone.extend(Tone.FeedbackEffect, Tone.Effect);
/**
* @static
* @type {Object}
*/
Tone.FeedbackEffect.defaults = {
"feedback" : 0.125
};
/**
* Clean up.
* @returns {Tone.FeedbackEffect} this
*/
Tone.FeedbackEffect.prototype.dispose = function(){
Tone.Effect.prototype.dispose.call(this);
this._writable(["feedback"]);
this._feedbackGain.dispose();
this._feedbackGain = null;
this.feedback = null;
return this;
};
return Tone.FeedbackEffect;
});