Merge pull request #2237 from bomoko/Documentation/p5_MediaElement_stop

Added p5.MediaElement.stop example

lib/addons/p5.dom.js

@@ -1877,6 +1877,61 @@
  *
  * @method stop
  * @return {Object|p5.Element}
+ * @example
+ * <div><code>
+ *
+ * //This example both starts 
+ * //and stops a sound sample
+ * //when the user clicks the canvas
+ *
+ * //We will store the p5.MediaElement
+ * //object in here
+ * var ele;
+ *
+ * //while our audio is playing,
+ * //this will be set to true
+ * var sampleIsPlaying = false;
+ *
+ * function setup() {
+ * //Here we create a p5.MediaElement object
+ * //using the createAudio() function.
+ * ele = createAudio('assets/beat.mp3');
+ * background(200);
+ * textAlign(CENTER);
+ * text("Click to play!", width/2, height/2);
+ * }
+ *
+ * function mouseClicked() {
+ * //here we test if the mouse is over the
+ * //canvas element when it's clicked
+ * if(mouseX >= 0 && mouseX <= width &&
+ * mouseY >= 0 && mouseY <= height) {
+ * background(200);
+ *
+ * if(sampleIsPlaying) {
+ * //if the sample is currently playing
+ * //calling the stop() function on
+ * //our p5.MediaElement will stop
+ * //it and reset its current
+ * //time to 0 (i.e. it will start
+ * //at the beginning the next time
+ * //you play it)
+ * ele.stop();
+ *
+ * sampleIsPlaying = false;
+ * text("Click to play!", width/2, height/2);
+ * } else {
+ * //loop our sound element until we
+ * //call ele.stop() on it.
+ * ele.loop(); 
+ *
+ * sampleIsPlaying = true;
+ * text("Click to stop!", width/2, height/2);
+ * }
+ * }
+ * }
+ *
+ * </code></div>
  */
  p5.MediaElement.prototype.stop = function() {
  this.elt.pause();