0.3.10 (#337)

add userStartAudio method to start audio on user gesture

Author: therewasaguy

lib/p5.sound.js

@@ -1,4 +1,4 @@
-/*! p5.sound.js v0.3.9 2018-09-10 */
+/*! p5.sound.js v0.3.10 2019-01-10 */
 /**
  *  p5.sound extends p5 with <a href="http://caniuse.com/audio-api"
  *  target="_blank">Web Audio</a> functionality including audio input,
@@ -6199,7 +6199,7 @@ envelope = function () {
    *  var attackLevel = 1.0;
    *  var releaseLevel = 0;
    *
-   *  var attackTime = 0.001
+   *  var attackTime = 0.001;
    *  var decayTime = 0.2;
    *  var susPercent = 0.2;
    *  var releaseTime = 0.5;
@@ -6224,7 +6224,7 @@ envelope = function () {
    *    cnv.mousePressed(playEnv);
    *  }
    *
-   *  function playEnv(){
+   *  function playEnv()  {
    *    env.play();
    *  }
    *  </code></div>
@@ -6375,7 +6375,7 @@ envelope = function () {
    *  var attackLevel = 1.0;
    *  var releaseLevel = 0;
    *
-   *  var attackTime = 0.001
+   *  var attackTime = 0.001;
    *  var decayTime = 0.2;
    *  var susPercent = 0.2;
    *  var releaseTime = 0.5;
@@ -6400,7 +6400,7 @@ envelope = function () {
    *    cnv.mousePressed(playEnv);
    *  }
    *
-   *  function playEnv(){
+   *  function playEnv()  {
    *    env.play();
    *  }
    *  </code></div>
@@ -6426,7 +6426,7 @@ envelope = function () {
    *  var attackLevel = 1.0;
    *  var releaseLevel = 0;
    *
-   *  var attackTime = 0.001
+   *  var attackTime = 0.001;
    *  var decayTime = 0.2;
    *  var susPercent = 0.2;
    *  var releaseTime = 0.5;
@@ -6451,7 +6451,7 @@ envelope = function () {
    *    cnv.mousePressed(playEnv);
    *  }
    *
-   *  function playEnv(){
+   *  function playEnv()  {
    *    env.play();
    *  }
    *  </code></div>
@@ -6545,7 +6545,7 @@ envelope = function () {
    *  var attackLevel = 1.0;
    *  var releaseLevel = 0;
    *
-   *  var attackTime = 0.001
+   *  var attackTime = 0.001;
    *  var decayTime = 0.2;
    *  var susPercent = 0.2;
    *  var releaseTime = 0.5;
@@ -6570,7 +6570,7 @@ envelope = function () {
    *    cnv.mousePressed(playEnv);
    *  }
    *
-   *  function playEnv(){
+   *  function playEnv()  {
    *    // trigger env on triOsc, 0 seconds from now
    *    // After decay, sustain for 0.2 seconds before release
    *    env.play(triOsc, 0, 0.2);
@@ -6605,7 +6605,7 @@ envelope = function () {
    *  var attackLevel = 1.0;
    *  var releaseLevel = 0;
    *
-   *  var attackTime = 0.001
+   *  var attackTime = 0.001;
    *  var decayTime = 0.3;
    *  var susPercent = 0.4;
    *  var releaseTime = 0.5;
@@ -6630,7 +6630,7 @@ envelope = function () {
    *    cnv.mousePressed(envAttack);
    *  }
    *
-   *  function envAttack(){
+   *  function envAttack()  {
    *    console.log('trigger attack');
    *    env.triggerAttack();
    *
@@ -6709,7 +6709,7 @@ envelope = function () {
    *  var attackLevel = 1.0;
    *  var releaseLevel = 0;
    *
-   *  var attackTime = 0.001
+   *  var attackTime = 0.001;
    *  var decayTime = 0.3;
    *  var susPercent = 0.4;
    *  var releaseTime = 0.5;
@@ -6734,7 +6734,7 @@ envelope = function () {
    *    cnv.mousePressed(envAttack);
    *  }
    *
-   *  function envAttack(){
+   *  function envAttack()  {
    *    console.log('trigger attack');
    *    env.triggerAttack();
    *
@@ -8505,7 +8505,6 @@ filter = function () {
       freq = 1;
     }
     if (typeof freq === 'number') {
-      this.biquad.frequency.value = freq;
       this.biquad.frequency.cancelScheduledValues(this.ac.currentTime + 0.01 + t);
       this.biquad.frequency.exponentialRampToValueAtTime(freq, this.ac.currentTime + 0.02 + t);
     } else if (freq) {
@@ -10425,14 +10424,14 @@ looper = function () {
   };
   /**
    *  <p>A p5.Part plays back one or more p5.Phrases. Instantiate a part
-   *  with steps and tatums. By default, each step represents 1/16th note.</p>
+   *  with steps and tatums. By default, each step represents a 1/16th note.</p>
    *
    *  <p>See p5.Phrase for more about musical timing.</p>
    *
    *  @class p5.Part
    *  @constructor
    *  @param {Number} [steps]   Steps in the part
-   *  @param {Number} [tatums] Divisions of a beat (default is 1/16, a quarter note)
+   *  @param {Number} [tatums] Divisions of a beat, e.g. use 1/4, or 0.25 for a quater note (default is 1/16, a sixteenth note)
    *  @example
    *  <div><code>
    *  var box, drum, myPart;
@@ -10511,7 +10510,7 @@ looper = function () {
     this.metro.setBPM(tempo, rampTime);
   };
   /**
-   *  Returns the Beats Per Minute of this currently part.
+   *  Returns the tempo, in Beats Per Minute, of this part.
    *
    *  @method getBPM
    *  @return {Number}
@@ -10565,7 +10564,7 @@ looper = function () {
     };
   };
   /**
-   *  Stop the part and cue it to step 0.
+   *  Stop the part and cue it to step 0. Playback will resume from the begining of the Part when it is played again.
    *
    *  @method  stop
    *  @param  {Number} [time] seconds from now
@@ -10636,8 +10635,7 @@ looper = function () {
     }
   };
   /**
-   *  Get a phrase from this part, based on the name it was
-   *  given when it was created. Now you can modify its array.
+   *  Find all sequences with the specified name, and replace their patterns with the specified array.
    *
    *  @method  replaceSequence
    *  @param  {String} phraseName
@@ -10664,7 +10662,7 @@ looper = function () {
     }
   };
   /**
-   *  Fire a callback function at every step.
+   *  Set the function that will be called at every step. This will clear the previous function.
    *
    *  @method onStep
    *  @param  {Function} callback The name of the callback