Merge branch 'master' into GMC_0.6.2

Author: Lanny McNie

VERSIONS.txt

@@ -12,6 +12,12 @@ CRITICAL
 - added automatic "playEmptySound" support on iOS to unlock the WebAudio context
 
 
+Version 0.6.1-HOTFIX [October 8, 2015]
+****************************************************************************************************
+- fixed issue with panning in Chrome, caused by an unset pan value in WebAudio. This minor fix is
+  provided to fix existing content online that was broken with a browser update.
+
+
 Version 0.6.1 [May 21,2015]
 ****************************************************************************************************
 CRITICAL (may break existing content):

build/Gruntfile.js

@@ -336,6 +336,9 @@ module.exports = function (grunt) {
 		"updateversion", "combine", "uglify", "clearversion", "copy:src"
 	]);
 
+	/** Aliased task for WebStorm quick-run */
+	grunt.registerTask('_next_sound', ["next"]);
+
 	/**
 	 * Task for exporting a release build (version based on package.json)
 	 *

build/createjsTheme/assets/scss/elements/tags.scss

@@ -163,7 +163,7 @@ h2 {
 
 h3 {
 	@extend h1;
-	font-size: $fontSize-smaller;
+	font-size: $fontSize-small;
 	font-weight: 700;
 	text-transform: none;
 }

docs/soundjs_docs-NEXT.zip

@@ -1,15 +1,24 @@
 # lib directory
-This directory contains a compressed version of the SoundJS library, including the most recent tagged release and the in-progress NEXT release.
+This directory contains a compressed version of the SoundJS library, including the most recent tagged release and the
+in-progress NEXT release.
 
-Both combined and minified versions of the library are included. The former being useful for debugging, and the latter for deployment.
+Both combined and minified versions of the library are included. The former being useful for debugging, and the latter
+for deployment.
 
-You can also link to the libraries on the [CreateJS CDN](http://code.createjs.com/), to benefit from faster load times and shared caching across sites.
+You can also link to the libraries on the [CreateJS CDN](http://code.createjs.com/), to benefit from faster load times
+and shared caching across sites.
 
 # libraries
-**soundjs-VERSION.min.js** contains minified versions of all of the SoundJS classes (comments and white space stripped) except the contents of soundjs/flashaudio/
-
-**flashaudioplugin-VERSION.min.js** contains a minified version of FlashAudio support. This class is used to support older browsers.
+**soundjs-VERSION.min.js** contains minified versions of all of the SoundJS classes (comments and white space stripped)
+except for the Flash and Cordova audio plugins.
+**flashaudioplugin-VERSION.min.js** contains minified versions of the Flash audio plugin.
+**cordovaaudioplugin-VERSION.min.js** contains minified versions of the Cordova audio plugin.
+**soundjs-VERSION.combined.js** contains all the SoundJS classes (except Flash and Cordova plugin classes) including
+whitespace and comments.
+**flashaudioplugin-VERSION.combined.js** contains all the Flash audio plugin classes.
+**cordovaaudioplugin-VERSION.combined.js** contains all the Cordova audio plugin classes.
 
 
 # license
-The libraries are ©2010 gskinner.com, inc., and made available under the highly permissive MIT open source software license. See the source file header for the full license text.
+The libraries are ©2010 gskinner.com, inc., and made available under the highly permissive MIT open source software
+license. See the source file header for the full license text.

lib/README.txt

@@ -6473,6 +6473,7 @@ this.createjs = this.createjs || {};
 		this.panNode = s.context.createPanner();
 		this.panNode.panningModel = s._panningModel;
 		this.panNode.connect(this.gainNode);
+		this._updatePan();
 
 		/**
 		 * NOTE this is only intended for use by advanced users.

lib/soundjs-0.6.1.combined.js

@@ -1,3 +1,30 @@
+/*!
+* SoundJS
+* Visit http://createjs.com/ for documentation, updates and examples.
+*
+* Copyright (c) 2010 gskinner.com, inc.
+*
+* Permission is hereby granted, free of charge, to any person
+* obtaining a copy of this software and associated documentation
+* files (the "Software"), to deal in the Software without
+* restriction, including without limitation the rights to use,
+* copy, modify, merge, publish, distribute, sublicense, and/or sell
+* copies of the Software, and to permit persons to whom the
+* Software is furnished to do so, subject to the following
+* conditions:
+*
+* The above copyright notice and this permission notice shall be
+* included in all copies or substantial portions of the Software.
+*
+* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+* OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+* NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+* HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+* WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+* OTHER DEALINGS IN THE SOFTWARE.
+*/
 
 
 //##############################################################################
@@ -30,7 +57,7 @@ this.createjs = this.createjs || {};
 	 * @type String
 	 * @static
 	 **/
-	s.buildDate = /*=date*/"Thu, 01 Oct 2015 22:42:18 GMT"; // injected by build process
+	s.buildDate = /*=date*/"Thu, 29 Oct 2015 03:02:56 GMT"; // injected by build process
 
 })();
 
@@ -3409,12 +3436,12 @@ this.createjs = this.createjs || {};
 	 *      createjs.FlashAudioPlugin.swfPath = "../src/soundjs/flashaudio";
 	 *      createjs.Sound.registerPlugins([createjs.WebAudioPlugin, createjs.FlashAudioPlugin]);
 	 *      createjs.Sound.alternateExtensions = ["mp3"];
-	 *      createjs.Sound.on("fileload", createjs.proxy(this.loadHandler, (this)));
+	 *      createjs.Sound.on("fileload", this.loadHandler, this);
 	 *      createjs.Sound.registerSound("path/to/mySound.ogg", "sound");
 	 *      function loadHandler(event) {
      *          // This is fired for each sound that is registered.
      *          var instance = createjs.Sound.play("sound");  // play using id.  Could also use full source path or event.src.
-     *          instance.on("complete", createjs.proxy(this.handleComplete, this));
+     *          instance.on("complete", this.handleComplete, this);
      *          instance.volume = 0.5;
 	 *      }
 	 *
@@ -3427,9 +3454,9 @@ this.createjs = this.createjs || {};
 	 *
 	 * Sound can be used as a plugin with PreloadJS to help preload audio properly. Audio preloaded with PreloadJS is
 	 * automatically registered with the Sound class. When audio is not preloaded, Sound will do an automatic internal
-	 * load. As a result, it may fail to play the first time play is called if the audio is not finished loading. Use the
-	 * {{#crossLink "Sound/fileload"}}{{/crossLink}} event to determine when a sound has finished internally preloading.
-	 * It is recommended that all audio is preloaded before it is played.
+	 * load. As a result, it may fail to play the first time play is called if the audio is not finished loading. Use
+	 * the {{#crossLink "Sound/fileload:event"}}{{/crossLink}} event to determine when a sound has finished internally
+	 * preloading. It is recommended that all audio is preloaded before it is played.
 	 *
 	 *      var queue = new createjs.LoadQueue();
 	 *		queue.installPlugin(createjs.Sound);
@@ -3457,28 +3484,47 @@ this.createjs = this.createjs || {};
 	 *		// after load is complete
 	 *		createjs.Sound.play("sound2");
 	 *
-	 * <b>Mobile Safe Approach</b><br />
-	 * Mobile devices require sounds to be played inside of a user initiated event (touch/click) in varying degrees.
-	 * As of SoundJS 0.4.1, you can launch a site inside of a user initiated event and have audio playback work. To
-	 * enable as broadly as possible, the site needs to setup the Sound plugin in its initialization (for example via
-	 * <code>createjs.Sound.initializeDefaultPlugins();</code>), and all sounds need to be played in the scope of the
-	 * application.  See the MobileSafe demo for a working example.
-	 *
-	 * <h4>Example</h4>
+	 * <b>Mobile Playback</b><br />
+	 * Devices running iOS require the WebAudio context to be "unlocked" by playing at least one sound inside of a user-
+	 * initiated event (such as touch/click). Earlier versions of SoundJS included a "MobileSafe" sample, but this is no
+	 * longer necessary as of SoundJS 0.6.2.
+	 * <ul>
+	 *     <li>
+	 *         In SoundJS 0.4.1 and above, you can either initialize plugins or use the {{#crossLink "WebAudioPlugin/playEmptySound"}}{{/crossLink}}
+	 *         method in the call stack of a user input event to manually unlock the audio context.
+	 *     </li>
+	 *     <li>
+	 *         In SoundJS 0.6.2 and above, SoundJS will automatically listen for the first document-level "mousedown"
+	 *         and "touchend" event, and unlock WebAudio. This will continue to check these events until the WebAudio
+	 *         context becomes "unlocked" (changes from "suspended" to "running")
+	 *     </li>
+	 *     <li>
+	 *         Both the "mousedown" and "touchend" events can be used to unlock audio in iOS9+, the "touchstart" event
+	 *         will work in iOS8 and below. The "touchend" event will only work in iOS9 when the gesture is interpreted
+	 *         as a "click", so if the user long-presses the button, it will no longer work.
+	 *     </li>
+	 *     <li>
+	 *         When using the <a href="http://www.createjs.com/docs/easeljs/classes/Touch.html">EaselJS Touch class</a>,
+	 *         the "mousedown" event will not fire when a canvas is clicked, since MouseEvents are prevented, to ensure
+	 *         only touch events fire. To get around this, you can either rely on "touchend", or:
+	 *         <ol>
+	 *             <li>Set the `allowDefault` property on the Touch class constructor to `true` (defaults to `false`).</li>
+	 *             <li>Set the `preventSelection` property on the EaselJS `Stage` to `false`.</li>
+	 *         </ol>
+	 *         These settings may change how your application behaves, and are not recommended.
+	 *     </li>
+	 * </ul>
 	 *
-	 *     document.getElementById("status").addEventListener("click", handleTouch, false);    // works on Android and iPad
-	 *     function handleTouch(event) {
-	 *         document.getElementById("status").removeEventListener("click", handleTouch, false);    // remove the listener
-	 *         var thisApp = new myNameSpace.MyApp();    // launch the app
-	 *     }
+	 * <b>Loading Alternate Paths and Extension-less Files</b><br />
+	 * SoundJS supports loading alternate paths and extension-less files by passing an object instead of a string for
+	 * the `src` property, which is a hash using the format `{extension:"path", extension2:"path2"}`. These labels are
+	 * how SoundJS determines if the browser will support the sound. This also enables multiple formats to live in
+	 * different folders, or on CDNs, which often has completely different filenames for each file.
 	 *
-	 * <b>Loading Alternate Paths and Extensionless Files</b><br />
-	 * SoundJS supports loading alternate paths and extensionless files by passing an object for src that has various paths
-	 * with property labels matching the extension.  These labels are how SoundJS determines if the browser will support the sound.
 	 * Priority is determined by the property order (first property is tried first).  This is supported by both internal loading
 	 * and loading with PreloadJS.
 	 *
-	 * Note an id is required for playback.
+	 * <em>Note: an id is required for playback.</em>
 	 *
 	 * <h4>Example</h4>
 	 *
@@ -3491,7 +3537,7 @@ this.createjs = this.createjs || {};
 	 *		createjs.Sound.addEventListener("fileload", handleLoad);
 	 *		createjs.Sound.registerSounds(sounds);
 	 *
-	 * <h4>Known Browser and OS issues</h4>
+	 * <h3>Known Browser and OS issues</h3>
 	 * <b>IE 9 HTML Audio limitations</b><br />
 	 * <ul><li>There is a delay in applying volume changes to tags that occurs once playback is started. So if you have
 	 * muted all sounds, they will all play during this delay until the mute applies internally. This happens regardless of
@@ -3500,20 +3546,23 @@ this.createjs = this.createjs || {};
 	 * encoding with 64kbps works.</li>
 	 * <li>Occasionally very short samples will get cut off.</li>
 	 * <li>There is a limit to how many audio tags you can load and play at once, which appears to be determined by
-	 * hardware and browser settings.  See {{#crossLink "HTMLAudioPlugin.MAX_INSTANCES"}}{{/crossLink}} for a safe estimate.</li></ul>
+	 * hardware and browser settings.  See {{#crossLink "HTMLAudioPlugin.MAX_INSTANCES"}}{{/crossLink}} for a safe
+	 * estimate.</li></ul>
 	 *
 	 * <b>Firefox 25 Web Audio limitations</b>
 	 * <ul><li>mp3 audio files do not load properly on all windows machines, reported
 	 * <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=929969" target="_blank">here</a>. </br>
-	 * For this reason it is recommended to pass another FF supported type (ie ogg) first until this bug is resolved, if possible.</li></ul>
+	 * For this reason it is recommended to pass another FF supported type (ie ogg) first until this bug is resolved, if
+	 * possible.</li></ul>
 
 	 * <b>Safari limitations</b><br />
 	 * <ul><li>Safari requires Quicktime to be installed for audio playback.</li></ul>
 	 *
 	 * <b>iOS 6 Web Audio limitations</b><br />
-	 * <ul><li>Sound is initially muted and will only unmute through play being called inside a user initiated event
-	 * (touch/click).</li>
-	 * <li>A bug exists that will distort un-cached web audio when a video element is present in the DOM that has audio at a different sampleRate.</li>
+	 * <ul><li>Sound is initially locked, and must be unlocked via a user-initiated event. Please see the section on
+	 * Mobile Playback above.</li>
+	 * <li>A bug exists that will distort un-cached web audio when a video element is present in the DOM that has audio
+	 * at a different sampleRate.</li>
 	 * </ul>
 	 *
 	 * <b>Android HTML Audio limitations</b><br />
@@ -3522,8 +3571,8 @@ this.createjs = this.createjs || {};
 	 * a delay.</li></ul>
 	 *
 	 * <b>Web Audio and PreloadJS</b><br />
-	 * <ul><li>Web Audio must be loaded through XHR, therefore when used with PreloadJS tag loading is not possible.  This means that tag loading cannot
-	 * be used to avoid cross domain issues if WebAudioPlugin is used</li><ul>
+	 * <ul><li>Web Audio must be loaded through XHR, therefore when used with PreloadJS, tag loading is not possible.
+	 * This means that tag loading can not be used to avoid cross domain issues.</li><ul>
 	 *
 	 * @class Sound
 	 * @static
@@ -6168,7 +6217,7 @@ this.createjs = this.createjs || {};
 		this._audioSources[loadItem.src] = true;
 		this._soundInstances[loadItem.src] = [];
 		loader = new this._loaderClass(loadItem);
-		loader.on("complete", createjs.proxy(this._handlePreloadComplete, this));
+		loader.on("complete", this._handlePreloadComplete, this);
 		this._loaders[loadItem.src] = loader;
 		return loader;
 	};
@@ -6180,7 +6229,7 @@ this.createjs = this.createjs || {};
 	 * @param {Loader} loader The sound URI to load.
 	 */
 	p.preload = function (loader) {
-		loader.on("error", createjs.proxy(this._handlePreloadError, this));
+		loader.on("error", this._handlePreloadError, this);
 		loader.load();
 	};
 
@@ -6728,18 +6777,29 @@ this.createjs = this.createjs || {};
 
 	 * <h4>Known Browser and OS issues for Web Audio</h4>
 	 * <b>Firefox 25</b>
-	 * <ul><li>mp3 audio files do not load properly on all windows machines, reported
-	 * <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=929969" target="_blank">here</a>. </br>
-	 * For this reason it is recommended to pass another FF supported type (ie ogg) first until this bug is resolved, if possible.</li></ul>
-	 * <br />
+	 * <li>
+	 *     mp3 audio files do not load properly on all windows machines, reported <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=929969" target="_blank">here</a>.
+	 *     <br />For this reason it is recommended to pass another FireFox-supported type (i.e. ogg) as the default
+	 *     extension, until this bug is resolved
+	 * </li>
+	 *
 	 * <b>Webkit (Chrome and Safari)</b>
-	 * <ul><li>AudioNode.disconnect does not always seem to work.  This can cause the file size to grow over time if you
-	 * are playing a lot of audio files.</li></ul>
-	 * <br />
+	 * <li>
+	 *     AudioNode.disconnect does not always seem to work.  This can cause the file size to grow over time if you
+	 * 	   are playing a lot of audio files.
+	 * </li>
+	 *
 	 * <b>iOS 6 limitations</b>
-	 * 	<ul><li>Sound is initially muted and will only unmute through play being called inside a user initiated event (touch/click).</li>
-	 *	<li>A bug exists that will distort uncached audio when a video element is present in the DOM.  You can avoid this bug
-	 * 	by ensuring the audio and video audio share the same sampleRate.</li>
+	 * <ul>
+	 *     <li>
+	 *         Sound is initially muted and will only unmute through play being called inside a user initiated event
+	 *         (touch/click). Please read the mobile playback notes in the the {{#crossLink "Sound"}}{{/crossLink}}
+	 *         class for a full overview of the limitations, and how to get around them.
+	 *     </li>
+	 *	   <li>
+	 *	       A bug exists that will distort un-cached audio when a video element is present in the DOM. You can avoid
+	 *	       this bug by ensuring the audio and video audio share the same sample rate.
+	 *	   </li>
 	 * </ul>
 	 * @class WebAudioPlugin
 	 * @extends AbstractPlugin
@@ -6856,6 +6916,7 @@ this.createjs = this.createjs || {};
 	 * empty sound.
 	 * @property _unlocked
 	 * @type {boolean}
+	 * @since 0.6.2
 	 * @private
 	 */
 	s._unlocked = false;
@@ -7032,6 +7093,7 @@ this.createjs = this.createjs || {};
 	 * a `touchstart` event to support older platforms may preclude a `mousedown` even from getting fired on iOS9, so we
 	 * stick with `mousedown` and `touchend`.
 	 * @method _unlock
+	 * @since 0.6.2
 	 * @private
 	 */
 	s._unlock = function() {

lib/soundjs-0.6.1.min.js

@@ -159,7 +159,7 @@ this.createjs = this.createjs || {};
 		this._audioSources[loadItem.src] = true;
 		this._soundInstances[loadItem.src] = [];
 		loader = new this._loaderClass(loadItem);
-		loader.on("complete", createjs.proxy(this._handlePreloadComplete, this));
+		loader.on("complete", this._handlePreloadComplete, this);
 		this._loaders[loadItem.src] = loader;
 		return loader;
 	};
@@ -171,7 +171,7 @@ this.createjs = this.createjs || {};
 	 * @param {Loader} loader The sound URI to load.
 	 */
 	p.preload = function (loader) {
-		loader.on("error", createjs.proxy(this._handlePreloadError, this));
+		loader.on("error", this._handlePreloadError, this);
 		loader.load();
 	};