Merge branch 'dev'

Author: tambien

.github/CONTRIBUTING.md

@@ -0,0 +1,33 @@
+Bug fixes and contributions are welcome!
+
+If you're looking for ideas for where to get started, consider jumping in on any of these areas:
+
+### Examples
+
+To contribute examples, please follow the current style of the examples. Add your example's title and file name to `ExampleList.js` file for it to appear in the examples list on the index page. 
+
+### Docs
+
+There is always more work that can be done on documentation. Especially adding good examples to methods and members to make the docs more informative and useful for people coming from diverse musical and technical backgrounds. 
+
+All of the docs are written in [jsdoc](http://usejsdoc.org/)-style comments in the source code. If you catch a mistake, please send a pull request. 
+
+Along with this, It'd be great to integrate more visuals and references in the docs to help illustrate concepts. 
+
+### Forum
+
+If you are someone who is familiar with Tone.js, consider jumping in on [the forum](https://groups.google.com/forum/#!forum/tonejs) to answer some questions.
+
+### Tutorials
+
+I'd love to see more tutorials for newcomers to Tone.js to help them get up and running or solve a particular issue. If you make a tutorial, please send me a link.
+
+### Tests 
+
+Tone.js has an extensive [test suite](Testing) using Mocha and Chai. I'd love help getting more of these tests to pass on Safari and Firefox.
+
+Along with more unit tests, I'd also be great to have more tests which run in the online context and generate music to help find bugs by ear that the automated tests might not illuminate. [Audiokit](http://audiokit.io/tests/), for example, has a great suite of aural tests.
+
+### Synths/Effects
+
+If you'd like to contribute a cool and expressive synth or effect, i'd love to hear it. Please send me an example that i can play with along with the PR. 

.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,3 @@
+Bugs and feature requests only please. For help questions, check out [the forum](https://groups.google.com/forum/#!forum/tonejs).
+
+If possible, please include a link which illustrates the issue.

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,5 @@
+1. Please make all pull requests on the `dev` branch.
+2. Don't commit build files
+2. Try to get all [tests](https://github.com/Tonejs/Tone.js/wiki/Testing) to pass.
+
+

.gitignore

@@ -50,3 +50,5 @@ build/p5.Tone.js
 examples/graph.html
 
 *.asd
+
+test/supports.html

.travis.yml

@@ -2,7 +2,7 @@ sudo: required
 dist: trusty  
 language: node_js  
 node_js:  
- - "4.2"
+ - "7"
 
 before_install:  
  - export CHROME_BIN=/usr/bin/google-chrome

CHANGELOG.md

@@ -1,3 +1,13 @@
+### r10
+
+* Tone.Context wraps AudioContext
+* Tone.OfflineContext wraps OfflineAudioContext
+* Tone.Offline: method for rendering audio offline
+* Rewriting tests with Tone.Offline
+* Optimizing Tone.Draw to only loop when events are scheduled: [#194](https://github.com/Tonejs/Tone.js/issues/194)
+* Time.eval->valueOf which takes advantage of build-in primitive evaluation [#205](https://github.com/Tonejs/Tone.js/issues/205)
+* [Offline example](https://tonejs.github.io/examples/#offline)
+
 ### r9
 
 * Tone.Clock performance and lookAhead updates. 

Tone/component/Analyser.js

@@ -2,6 +2,22 @@ define(["Tone/core/Tone"], function (Tone) {
 
 	"use strict";
 
+	/**
+	 *  AnalyserNode.getFloatTimeDomainData polyfill
+	 *  @private
+	 */
+	if (window.AnalyserNode && !AnalyserNode.prototype.getFloatTimeDomainData){
+		//referenced https://github.com/mohayonao/get-float-time-domain-data 
+		AnalyserNode.prototype.getFloatTimeDomainData = function(array){
+			var uint8 = new Uint8Array(array.length);
+			this.getByteTimeDomainData(uint8);
+			for (var i = 0; i < uint8.length; i++){
+				array[i] = (uint8[i] - 128) / 128;
+			}
+		};
+	}
+
+
 	/**
 	 *  @class  Wrapper around the native Web Audio's 
 	 *          [AnalyserNode](http://webaudio.github.io/web-audio-api/#idl-def-AnalyserNode).
@@ -104,17 +120,7 @@ define(["Tone/core/Tone"], function (Tone) {
 			if (this._returnType === Tone.Analyser.ReturnType.Byte){
 				this._analyser.getByteTimeDomainData(this._buffer);
 			} else {
-				if (this.isFunction(AnalyserNode.prototype.getFloatTimeDomainData)){
-					this._analyser.getFloatTimeDomainData(this._buffer);
-				} else {
-					var uint8 = new Uint8Array(this._buffer.length);
-					this._analyser.getByteTimeDomainData(uint8);
-					//referenced https://github.com/mohayonao/get-float-time-domain-data 
-					// POLYFILL
-					for (var i = 0; i < uint8.length; i++){
-						this._buffer[i] = (uint8[i] - 128) * 0.0078125;
-					}
-				}
+				this._analyser.getFloatTimeDomainData(this._buffer);
 			}
 		}
 		return this._buffer;

Tone/component/MidSideMerge.js

@@ -61,25 +61,12 @@ define(["Tone/core/Tone", "Tone/signal/Signal", "Tone/signal/Expr", "Tone/compon
 		this.side.connect(this._right, 0, 1);
 		this._left.connect(this._merge, 0, 0);
 		this._right.connect(this._merge, 0, 1);
-		sqrtTwo.connect(this._left, 0, 2);
-		sqrtTwo.connect(this._right, 0, 2);
+		this.context.getConstant(Math.SQRT1_2).connect(this._left, 0, 2);
+		this.context.getConstant(Math.SQRT1_2).connect(this._right, 0, 2);
 	};
 
 	Tone.extend(Tone.MidSideMerge);
 
-	/**
-	 *  A constant signal equal to 1 / sqrt(2).
-	 *  @type {Number}
-	 *  @signal
-	 *  @private
-	 *  @static
-	 */
-	var sqrtTwo = null;
-
-	Tone._initAudioContext(function(){
-		sqrtTwo = new Tone.Signal(1 / Math.sqrt(2));
-	});
-
 	/**
 	 *  clean up
 	 *  @returns {Tone.MidSideMerge} this

Tone/component/MidSideSplit.js

@@ -43,25 +43,12 @@ define(["Tone/core/Tone", "Tone/signal/Expr", "Tone/signal/Signal", "Tone/compon
 		this._split.connect(this.mid, 1, 1);
 		this._split.connect(this.side, 0, 0);
 		this._split.connect(this.side, 1, 1);
-		sqrtTwo.connect(this.mid, 0, 2);
-		sqrtTwo.connect(this.side, 0, 2);
+		this.context.getConstant(Math.SQRT1_2).connect(this.mid, 0, 2);
+		this.context.getConstant(Math.SQRT1_2).connect(this.side, 0, 2);
 	};
 
 	Tone.extend(Tone.MidSideSplit);
 
-	/**
-	 *  a constant signal equal to 1 / sqrt(2)
-	 *  @type {Number}
-	 *  @signal
-	 *  @private
-	 *  @static
-	 */
-	var sqrtTwo = null;
-
-	Tone._initAudioContext(function(){
-		sqrtTwo = new Tone.Signal(1 / Math.sqrt(2));
-	});
-
 	/**
 	 *  clean up
 	 *  @returns {Tone.MidSideSplit} this

Tone/component/Volume.js

@@ -28,14 +28,7 @@ define(["Tone/core/Tone", "Tone/signal/Signal", "Tone/core/Gain"], function(Tone
 		 * @type {Decibels}
 		 * @private
 		 */
-		this._unmutedVolume = 0;
-
-		/**
-		 *  if the volume is muted
-		 *  @type {Boolean}
-		 *  @private
-		 */
-		this._muted = false;
+		this._unmutedVolume = options.volume;
 
 		/**
 		 *  The volume control in decibels. 
@@ -74,17 +67,16 @@ define(["Tone/core/Tone", "Tone/signal/Signal", "Tone/core/Gain"], function(Tone
 	 */
 	Object.defineProperty(Tone.Volume.prototype, "mute", {
 		get : function(){
-			return this._muted;
+			return this.volume.value === -Infinity;
 		}, 
 		set : function(mute){
-			if (!this._muted && mute){
+			if (!this.mute && mute){
 				this._unmutedVolume = this.volume.value;
 				//maybe it should ramp here?
 				this.volume.value = -Infinity;
-			} else if (this._muted && !mute){
+			} else if (this.mute && !mute){
 				this.volume.value = this._unmutedVolume;
 			}
-			this._muted = mute;
 		}
 	});
 

Tone/core/Buffer.js

@@ -2,6 +2,27 @@ define(["Tone/core/Tone", "Tone/core/Emitter", "Tone/type/Type"], function(Tone)
 
 	"use strict";
 
+	/**
+	 *  AudioBuffer.copyToChannel polyfill
+	 *  @private
+	 */
+	if (window.AudioBuffer && !AudioBuffer.prototype.copyToChannel){
+		AudioBuffer.prototype.copyToChannel = function(src, chanNum, start){
+			var channel = this.getChannelData(chanNum);
+			start = start || 0;
+			for (var i = 0; i < channel.length; i++){
+				channel[i+start] = src[i];
+			}
+		};
+		AudioBuffer.prototype.copyFromChannel = function(dest, chanNum, start){
+			var channel = this.getChannelData(chanNum);
+			start = start || 0;
+			for (var i = 0; i < channel.length; i++){
+				dest[i] = channel[i+start];
+			}
+		};
+	}
+
 	/**
 	 *  @class  Buffer loading and storage. Tone.Buffer is used internally by all 
 	 *          classes that make requests for audio files such as Tone.Player,
@@ -230,17 +251,35 @@ define(["Tone/core/Tone", "Tone/core/Emitter", "Tone/type/Type"], function(Tone)
 			array = [array];
 		}
 		for (var c = 0; c < channels; c++){
-			if (this.isFunction(buffer.copyToChannel)){
-				buffer.copyToChannel(array[c], c);
-			} else {
-				var channel = buffer.getChannelData(c);
-				var channelArray = array[c];
+			buffer.copyToChannel(array[c], c);
+		}
+		this._buffer = buffer;
+		return this;
+	};
+
+	/**
+	 * 	Sums muliple channels into 1 channel
+	 *  @param {Number=} channel Optionally only copy a single channel from the array.
+	 *  @return {Array}
+	 */
+	Tone.Buffer.prototype.toMono = function(chanNum){
+		if (this.isNumber(chanNum)){
+			this.fromArray(this.toArray(chanNum));
+		} else {
+			var outputArray = new Float32Array(this.length);
+			var numChannels = this.numberOfChannels;
+			for (var channel = 0; channel < numChannels; channel++){
+				var channelArray = this.toArray(channel);
 				for (var i = 0; i < channelArray.length; i++){
-					channel[i] = channelArray[i];
+					outputArray[i] += channelArray[i];
 				}
 			}
+			//divide by the number of channels
+			outputArray = outputArray.map(function(sample){
+				return sample / numChannels;
+			});
+			this.fromArray(outputArray);
 		}
-		this._buffer = buffer;
 		return this;
 	};
 
@@ -252,29 +291,27 @@ define(["Tone/core/Tone", "Tone/core/Emitter", "Tone/type/Type"], function(Tone)
 	 */
 	Tone.Buffer.prototype.toArray = function(channel){
 		if (this.isNumber(channel)){
-			return this._buffer.getChannelData(channel);
+			return this.getChannelData(channel);
+		} else if (this.numberOfChannels === 1){
+			return this.toArray(0);
 		} else {
 			var ret = [];
 			for (var c = 0; c < this.numberOfChannels; c++){
-				ret[c] = new Float32Array(this.length);
-				if (this.isFunction(this._buffer.copyFromChannel)){
-					this._buffer.copyFromChannel(ret[c], c);
-				} else {
-					var channelData = this._buffer.getChannelData(c);
-					var retArray = ret[c];
-					for (var i = 0; i < channelData.length; i++){
-						retArray[i] = channelData[i];
-					}
-				}
-			}
-			if (ret.length === 1){
-				return ret[0];
-			} else {
-				return ret;
+				ret[c] = this.getChannelData(c);
 			}
+			return ret;
 		}
 	};
 
+	/**
+	 *  Returns the Float32Array representing the PCM audio data for the specific channel.
+	 *  @param  {Number}  channel  The channel number to return
+	 *  @return  {Float32Array}  The audio as a TypedArray
+	 */
+	Tone.Buffer.prototype.getChannelData = function(channel){
+		return this._buffer.getChannelData(channel);
+	};
+
 	/**
 	 *  Cut a subsection of the array and return a buffer of the
 	 *  subsection. Does not modify the original buffer
@@ -302,8 +339,8 @@ define(["Tone/core/Tone", "Tone/core/Emitter", "Tone/type/Type"], function(Tone)
 	 */
 	Tone.Buffer.prototype._reverse = function(){
 		if (this.loaded){
-			for (var i = 0; i < this._buffer.numberOfChannels; i++){
-				Array.prototype.reverse.call(this._buffer.getChannelData(i));
+			for (var i = 0; i < this.numberOfChannels; i++){
+				Array.prototype.reverse.call(this.getChannelData(i));
 			}
 		}
 		return this;
@@ -370,6 +407,7 @@ define(["Tone/core/Tone", "Tone/core/Emitter", "Tone/type/Type"], function(Tone)
 		function onError(e){
 			if (onerror){
 				onerror(e);
+				Tone.Buffer.emit("error", e);
 			} else {
 				throw new Error(e);
 			}
@@ -434,8 +472,9 @@ define(["Tone/core/Tone", "Tone/core/Emitter", "Tone/type/Type"], function(Tone)
 	/**
 	 *  Stop all of the downloads in progress
 	 *  @return {Tone.Buffer}
+	 *  @static
 	 */
-	Tone.Buffer.stopDownloads = function(){
+	Tone.Buffer.cancelDownloads = function(){
 		Tone.Buffer._downloadQueue.forEach(function(request){
 			request.abort();
 		});
@@ -459,5 +498,32 @@ define(["Tone/core/Tone", "Tone/core/Emitter", "Tone/type/Type"], function(Tone)
 		return response !== "";
 	};
 
+	/**
+	 *  Returns a Promise which resolves when all of the buffers have loaded
+	 *  @return {Promise}
+	 */
+	Tone.loaded = function(){
+		var onload, onerror;
+		function removeEvents(){
+			//remove the events when it's resolved
+			Tone.Buffer.off("load", onload);
+			Tone.Buffer.off("error", onerror);
+		}
+		return new Promise(function(success, fail){
+			onload = function(){
+				success();
+			};
+			onerror = function(){
+				fail();
+			};
+			//add the event listeners
+			Tone.Buffer.on("load", onload);
+			Tone.Buffer.on("error", onerror);
+		}).then(removeEvents).catch(function(e){
+			removeEvents();
+			throw new Error(e);
+		});
+	};
+
 	return Tone.Buffer;
 });