documentation of amplitude.connect() method

Author: Nitesh639

src/amplitude.js

@@ -177,6 +177,60 @@ class Amplitude {
     }
   }
 
+  /**
+   * Connects the output of a p5.Amplitude object to input of another
+   * p5.sound object. For example, you may connect a p5.Amplitude to an
+   * FFT or an Effect.
+   *
+   * @method connect
+   * @for p5.Amplitude
+   * @param {Object} object Audio object that accepts an input
+   * @example
+   *  <div><code>
+   *  let sound, amplitude, fft, button;
+   *  function preload(){
+   *    sound = loadSound('assets/beat.mp3');
+   *  }
+   *
+   *  function setup() {
+   *    let cnv = createCanvas(100,100);
+   *    cnv.mouseClicked(togglePlay);
+   *    amplitude = new p5.Amplitude();
+   *    button = createButton("tap to disconnect amp");
+   *    button.mouseClicked(amp_disconnect);
+   *    button.position(0,110);
+   *    fft = new p5.FFT();
+   *    sound.loop();
+   *  }
+   *
+   *  function draw() {
+   *    background(220);
+   *    text('tap to play', 20, 20);
+   *    let level = amplitude.getLevel();
+   *    let size = map(level, 0, 1, 0, 200);
+   *    ellipse(width/2, height/2, size, size);
+   *  }
+   *
+   *  function togglePlay() {
+   *    if (sound.isPlaying()){
+   *      sound.pause();
+   *    }
+   *    else{
+   *      sound.play();
+   *        }
+   *    }
+   *  function amp_disconnect(){
+   *     if (button.html()=="tap to disconnect amp"){
+   *      amplitude.disconnect();
+   *      button.html("tap to connect fft");
+   *      }
+   *      else{
+   *          amplitude.connect(fft);
+   *          button.html("tap to disconnect amp");
+   *        }
+   *     }
+   *  </code></div>
+   */
   connect(unit) {
     if (unit) {
       if (unit.hasOwnProperty('input')) {