update examples and readme

Author: timhendriks93

README.md

@@ -153,24 +153,26 @@ void loop() {
 
 At first, an animation will be in the default mode. In this mode, the animation is simply not doing anything and waits until the mode has changed.
 
-| Mode | Constant | Description |
-|------|----------|-------------|
-| default | MODE_DEFAULT | Not playing / waiting |
-| play | MODE_PLAY | Playing back the animation |
-| pause | MODE_PAUSE | Pausing the animation at the current frame |
-| stop | MODE_STOP | Slowly moving the servos to their neutral position |
-| live | MODE_LIVE | Reading serial commands to move the servos in real-time |
+| Constant | Method | Description |
+|----------|--------|-------------|
+| MODE_DEFAULT | | Not playing / waiting |
+| MODE_PLAY | play() | Start or resume playing the animation once |
+| MODE_PAUSE | pause() | Pausing the animation at the current frame |
+| MODE_STOP | stop() | Slowly moving the servos to their neutral position |
+| MODE_LOOP | loop() | Start or resume playing the animation in a loop |
+| MODE_LIVE | live(stream) | Reading serial commands to move the servos in real-time |
 
-The modes can be changed or triggered via the following methods:
+The modes can be changed or triggered by calling the above methods on the animation object:
 
 ```ino
 myBlenderAnimation.play();
 myBlenderAnimation.pause();
-myBlenderAnimation.stop(stepDelay);
+myBlenderAnimation.loop();
+myBlenderAnimation.stop();
 myBlenderAnimation.live(stream);
 ```
 
-> Note: the default mode is only handled internally.
+> Note: the default mode can not be triggered as it is only handled internally.
 
 When calling the `stop` method, it is possible to pass a delay in milliseconds. This delay will be used when the servos are moved to their neutral position during the stop mode. To get to the neutral position, the current position will either be increased or decreased by 1. The delay therefore controls how fast or smooth this movement will take place. The default value for this parameter is `20`.
 

examples/AdafruitPCA9685/AdafruitPCA9685.ino

@@ -40,8 +40,8 @@ void setup() {
   animation.addServo(neckLeftServo);
   animation.addServo(neckRightServo);
 
-  // Trigger the animation play mode
-  animation.play();
+  // Trigger the animation loop mode
+  animation.loop();
 
   // Initialize servo driver
   pwm.begin();

examples/MultiplePCA9685/MultiplePCA9685.ino

@@ -73,8 +73,8 @@ void setup() {
     animation.addServo(servoMaps[i].servo);
   }
 
-  // Trigger the animation play mode
-  animation.play();
+  // Trigger the animation loop mode
+  animation.loop();
 
   // Initialize servo drivers
   pwmA.begin();

examples/StandardServoLib/StandardServoLib.ino

@@ -38,8 +38,8 @@ void setup() {
   // Add the Blender servo object to the animation
   animation.addServo(myBlenderServo);
 
-  // Trigger the animation play mode
-  animation.play();
+  // Trigger the animation loop mode
+  animation.loop();
 }
 
 void loop() {

examples/SwitchModeButton/SwitchModeButton.ino

@@ -10,6 +10,12 @@
   changes. For example, this can be used to control the animation audio. See the
   comments below to understand what happens on a short or long button press
   based on the current mode.
+
+  Starting the animation will only play it once, so another button press is
+  required to play it again. Alternatively, you can also use MODE_LOOP instead
+  of MODE_PLAY and loop() instead of play(). This will keep the animation
+  running until the button is short or long pressed again, thus pausing or
+  stopping the animation.
 */
 
 #include "simple.h"