Tone.js/Tone/signal/Route.js

define(["Tone/core/Tone", "Tone/signal/Equal", "Tone/signal/Signal"], function(Tone){

	"use strict";

	/**
	 *  @class Route a single input to the specified output. 
	 *
	 *  @constructor
	 *  @extends {Tone.SignalBase}
	 *  @param {number} [outputCount=2] the number of inputs the switch accepts
	 *  @example
	 * var route = new Tone.Route(4);
	 * var signal = new Tone.Signal(3).connect(route);
	 * route.select(0);
	 * //signal is routed through output 0
	 * route.select(3);
	 * //signal is now routed through output 3
	 */
	Tone.Route = function(outputCount){

		outputCount = this.defaultArg(outputCount, 2);
		Tone.call(this, 1, outputCount);

		/**
		 *  The control signal.
		 *  @type {Number}
		 *  @signal
		 */
		this.gate = new Tone.Signal(0);
		this._readOnly("gate");

		//make all the inputs and connect them
		for (var i = 0; i < outputCount; i++){
			var routeGate = new RouteGate(i);
			this.output[i] = routeGate;
			this.gate.connect(routeGate.selecter);
			this.input.connect(routeGate);
		}
	};

	Tone.extend(Tone.Route, Tone.SignalBase);

	/**
	 *  Routes the signal to one of the outputs and close the others.
	 *  @param {number} [which=0] Open one of the gates (closes the other).
	 *  @param {Time} [time=now] The time when the switch will open.
	 *  @returns {Tone.Route} this
	 */
	Tone.Route.prototype.select = function(which, time){
		//make sure it's an integer
		which = Math.floor(which);
		this.gate.setValueAtTime(which, this.toSeconds(time));
		return this;
	};

	/**
	 *  Clean up.
	 *  @returns {Tone.Route} this
	 */
	Tone.Route.prototype.dispose = function(){
		this._writable("gate");
		this.gate.dispose();
		this.gate = null;
		for (var i = 0; i < this.output.length; i++){
			this.output[i].dispose();
			this.output[i] = null;
		}
		Tone.prototype.dispose.call(this);
		return this;
	}; 

	////////////START HELPER////////////

	/**
	 *  helper class for Tone.Route representing a single gate
	 *  @constructor
	 *  @extends {Tone}
	 *  @private
	 */
	var RouteGate = function(num){

		/**
		 *  the selector
		 *  @type {Tone.Equal}
		 */
		this.selecter = new Tone.Equal(num);

		/**
		 *  the gate
		 *  @type {GainNode}
		 */
		this.gate = this.input = this.output = this.context.createGain();

		//connect the selecter to the gate gain
		this.selecter.connect(this.gate.gain);
	};

	Tone.extend(RouteGate);

	/**
	 *  clean up
	 *  @private
	 */
	RouteGate.prototype.dispose = function(){
		Tone.prototype.dispose.call(this);
		this.selecter.dispose();
		this.selecter = null;
		this.gate.disconnect();
		this.gate = null;
	};

	////////////END HELPER////////////

	//return Tone.Route
	return Tone.Route;
});