add show example

Author: timhendriks93

.github/workflows/ci.yml

@@ -29,6 +29,7 @@ jobs:
             AdafruitPCA9685,
             LiveMode,
             MultiplePCA9685,
+            Show,
             StandardServoLib,
             SwitchModeButton,
           ]

examples/Show/Show.ino

@@ -0,0 +1,63 @@
+/*
+  Setting up a show consisting of 2 animations.
+
+  Note the namespaces which are used to distinguish the positions
+  of one scene / animation from another. It's even possible to
+  have different playback rates (fps) and frames per animation.
+*/
+
+#include "scene-a.h"
+#include "scene-b.h"
+#include <BlenderServoAnimation.h>
+#include <Servo.h>
+
+// Servo object to send positions
+Servo myServo;
+
+// Callback function which is called whenever a servo needs to be moved
+void move(byte servoID, int angle) {
+  // Ignore the servoID (there is only one servo) and write the current angle
+  myServo.write(angle);
+}
+
+// Show object to manage all Blender animations
+BlenderServoAnimation::Show show;
+
+// Animation objects to represent the original Blender animations
+BlenderServoAnimation::Animation animationA(0, SceneA::FPS, SceneA::FRAMES);
+BlenderServoAnimation::Animation animationB(1, SceneB::FPS, SceneB::FRAMES);
+
+// Servo objects to manage the positions
+BlenderServoAnimation::Servo myBlenderServoA(0, SceneA::Bone, move);
+BlenderServoAnimation::Servo myBlenderServoB(0, SceneB::Bone, move);
+
+void setup() {
+  // Attach the servo to pin 9
+  myServo.attach(9);
+
+  // Add the Blender servo objects to the animations
+  animationA.addServo(myBlenderServoA);
+  animationB.addServo(myBlenderServoB);
+
+  // Add the Blender animation objects to the show
+  show.addAnimation(animationA);
+  show.addAnimation(animationB);
+
+  // Trigger the show loop mode
+  show.loop();
+  
+  // There are also other playback options
+  // show.play(); // Plays all animations once in the order they have been added
+  // show.playRandom(); // Randomly plays animations in a loop
+  // show.playSingle(1); // Play the animation with the given ID once
+
+  // Further controls are similar to what we can do on animation objects
+  // show.pause();
+  // show.stop();
+  // show.live(Serial);
+}
+
+void loop() {
+  // Update the show state on each loop
+  show.run();
+}

examples/Show/platformio.ini

@@ -0,0 +1,18 @@
+[env]
+lib_deps = 
+	arduino-libraries/Servo@^1.1.8
+
+[env:uno]
+board = uno
+platform = atmelavr
+framework = arduino
+
+[env:ATmega2560]
+board = ATmega2560
+platform = atmelavr
+framework = arduino
+
+[env:nanoatmega328]
+board = nanoatmega328
+platform = atmelavr
+framework = arduino

examples/Show/scene-a.h

@@ -0,0 +1,26 @@
+/*
+  Blender Servo Animation Positions
+
+  FPS: 30
+  Frames: 100
+  Seconds: 3
+  Bones: 1
+  Armature: Armature
+  Scene: SceneA
+  File: scenes.blend
+*/
+
+#include <Arduino.h>
+
+namespace SceneA {
+
+const byte FPS = 30;
+const int FRAMES = 100;
+
+// Servo ID: 0
+const int Bone[FRAMES] PROGMEM = {
+  90, 90, 89, 89, 88, 87, 86, 84, 83, 81, 80, 78, 76, 74, 72, 70, 68, 65, 63, 61, 59, 57, 55, 54, 52, 51, 49, 48, 47, 46, 46, 45, 45, 45, 46, 47, 49, 51, 53, 55, 58, 61, 65, 68, 72, 76, 80, 84, 88, 92,
+  96, 100, 104, 108, 112, 115, 119, 122, 125, 127, 129, 131, 133, 134, 135, 135, 135, 135, 134, 133, 132, 131, 130, 129, 127, 126, 124, 122, 120, 118, 116, 114, 112, 111, 109, 107, 105, 103, 101, 99, 98, 96, 95, 94, 93, 92, 91, 90, 90, 90,
+};
+
+} // namespace SceneA

examples/Show/scene-b.h

@@ -0,0 +1,28 @@
+/*
+  Blender Servo Animation Positions
+
+  FPS: 60
+  Frames: 200
+  Seconds: 3
+  Bones: 1
+  Armature: Armature.001
+  Scene: SceneB
+  File: scenes.blend
+*/
+
+#include <Arduino.h>
+
+namespace SceneB {
+
+const byte FPS = 60;
+const int FRAMES = 200;
+
+// Servo ID: 0
+const int Bone[FRAMES] PROGMEM = {
+  90, 90, 90, 90, 90, 90, 90, 89, 89, 89, 89, 88, 88, 88, 88, 87, 87, 86, 86, 86, 85, 85, 84, 84, 83, 83, 82, 82, 81, 81, 80, 80, 79, 78, 78, 77, 76, 76, 75, 75, 74, 73, 73, 72, 71, 71, 70, 69, 69, 68,
+  67, 66, 66, 65, 64, 64, 63, 62, 62, 61, 60, 60, 59, 59, 58, 57, 57, 56, 55, 55, 54, 54, 53, 53, 52, 52, 51, 51, 50, 50, 49, 49, 49, 48, 48, 47, 47, 47, 47, 46, 46, 46, 46, 45, 45, 45, 45, 45, 45, 45,
+  45, 45, 45, 45, 45, 45, 46, 46, 46, 46, 47, 47, 47, 47, 48, 48, 48, 49, 49, 50, 50, 51, 51, 52, 52, 53, 53, 54, 54, 55, 55, 56, 56, 57, 58, 58, 59, 60, 60, 61, 61, 62, 63, 63, 64, 65, 65, 66, 67, 68,
+  68, 69, 70, 70, 71, 72, 72, 73, 74, 74, 75, 75, 76, 77, 77, 78, 79, 79, 80, 80, 81, 81, 82, 82, 83, 83, 84, 84, 85, 85, 86, 86, 87, 87, 87, 88, 88, 88, 88, 89, 89, 89, 89, 90, 90, 90, 90, 90, 90, 90,
+};
+
+} // namespace SceneB

src/show/Show.cpp

@@ -43,7 +43,7 @@ void Show::setRandomAnimation() {
   byte randomIndex = 0;
 
   if (this->countAnimations() > 1) {
-    randomIndex = random(this->addIndex - 1);
+    randomIndex = random(this->addIndex);
   }
 
   this->playIndex = randomIndex;