directly allow animation live stream write

Author: timhendriks93

examples/AdafruitPCA9685/AdafruitPCA9685.ino

@@ -10,9 +10,6 @@
 #include <Adafruit_PWMServoDriver.h>
 #include <BlenderServoAnimation.h>
 
-// Using the namespace to have short class references (Animation and Servo)
-using namespace BlenderServoAnimation;
-
 // PWM driver instance to set PWM output
 Adafruit_PWMServoDriver pwm = Adafruit_PWMServoDriver();
 
@@ -22,10 +19,16 @@ void move(byte servoID, int position) {
   pwm.setPWM(servoID, 0, position);
 }
 
-// Animation object to represent the original Blender animation
-Animation animation;
+// Animation object to control the animation
+BlenderServoAnimation::Animation animation;
+
+#define POWER_PIN 19
 
 void setup() {
+  // Set power pin
+  pinMode(POWER_PIN, OUTPUT);
+  digitalWrite(POWER_PIN, HIGH);
+
   // Set the position callback
   animation.onPositionChange(move);
 

examples/MultiplePCA9685/MultiplePCA9685.ino

@@ -10,15 +10,12 @@
 #include <Adafruit_PWMServoDriver.h>
 #include <BlenderServoAnimation.h>
 
-// Using the namespace to have short class references (Animation and Servo)
-using namespace BlenderServoAnimation;
-
 // PWM driver instances to set PWM output
 Adafruit_PWMServoDriver pwmA(0x40);
 Adafruit_PWMServoDriver pwmB(0x41);
 
-// Animation object to represent the original Blender animation
-Animation animation;
+// Animation object to control the animation
+BlenderServoAnimation::Animation animation;
 
 // We use a struct to map a servo to a PCA9685 board and channel
 struct servoMapping {

examples/MultipleScenes/MultipleScenes.ino

@@ -27,7 +27,7 @@ void move(byte servoID, int position) {
   myServo.writeMicroseconds(position);
 }
 
-// Animation object to represent the original Blender animation
+// Animation object to control the animation
 BlenderServoAnimation::Animation animation;
 
 void setup() {

examples/MultipleScenesSD/MultipleScenesSD.ino

@@ -60,7 +60,7 @@ void changeSceneFile(byte prevSceneIndex, byte nextSceneIndex) {
   }
 }
 
-// Animation object to represent the original Blender animation
+// Animation object to control the animation
 BlenderServoAnimation::Animation animation;
 
 void setup() {

examples/MultipleScenesSD/README.md

@@ -4,4 +4,4 @@ Setting up a show consisting of 2 animations.
 
 By default, the 2 animations will be played synchronously in a loop.
 
-![Arduino Nano with servo](../../images/arduino-nano-with-servo.png)
+![Arduino Nano with servo](../../images/arduino-nano-with-sd-module.png)

examples/SDAnimation/README.md

@@ -4,4 +4,4 @@ Using the standard Arduino servo library to send servo positions.
 
 The setup requires nothing but a micro controller and a single servo.
 
-![Arduino Nano with servo](../../images/arduino-nano-with-servo.png)
+![Arduino Nano with servo](../../images/arduino-nano-with-sd-module.png)

examples/SDAnimation/SDAnimation.ino

@@ -36,7 +36,7 @@ void resetFile(byte prevSceneIndex, byte nextSceneIndex) {
   animationFile.seek(0);
 }
 
-// Animation object to represent the original Blender animation
+// Animation object to control the animation
 BlenderServoAnimation::Animation animation;
 
 void setup() {

examples/SerialLiveMode/SerialLiveMode.ino

@@ -14,6 +14,8 @@
 #include <Servo.h>
 #endif
 
+#define SERVO_PIN 12
+
 // Servo object to send positions
 Servo myServo;
 
@@ -23,15 +25,15 @@ void move(byte servoID, int position) {
   myServo.writeMicroseconds(position);
 }
 
-// Animation object to represent the original Blender animation
+// Animation object to control the animation
 BlenderServoAnimation::Animation animation;
 
 void setup() {
   // Initialize serial communication
   Serial.begin(115200);
 
-  // Attach the servo to pin 12
-  myServo.attach(12);
+  // Attach the servo to the defined servo pin
+  myServo.attach(SERVO_PIN);
 
   // Set the position callback
   animation.onPositionChange(move);

examples/StandardServoLib/StandardServoLib.ino

@@ -1,9 +1,6 @@
 /*
   Using the standard Arduino servo library to send servo positions.
-
-  Note the namespace BlenderServoAnimation which helps to distinguish
-  between the standard library servo class (Servo) and the servo
-  class of this library (BlenderServoAnimation::Servo).
+  The animation is played in a loop.
 */
 
 #include "simple.h"
@@ -15,6 +12,8 @@
 #include <Servo.h>
 #endif
 
+#define SERVO_PIN 12
+
 // Servo object to send positions
 Servo myServo;
 
@@ -24,12 +23,12 @@ void move(byte servoID, int position) {
   myServo.writeMicroseconds(position);
 }
 
-// Animation object to represent the original Blender animation
+// Animation object to control the animation
 BlenderServoAnimation::Animation animation;
 
 void setup() {
-  // Attach the servo to pin 12
-  myServo.attach(12);
+  // Attach the servo to the defined servo pin
+  myServo.attach(SERVO_PIN);
 
   // Set the position callback
   animation.onPositionChange(move);

examples/SwitchModeButton/SwitchModeButton.ino

@@ -62,7 +62,7 @@ void modeChanged(byte prevMode, byte newMode) {
   }
 }
 
-// Animation object to represent the original Blender animation
+// Animation object to control the animation
 BlenderServoAnimation::Animation animation;
 
 // Callback to be triggered on a short button press

examples/WebSocketLiveMode/WebSocketLiveMode.ino

@@ -13,6 +13,8 @@
 #include <ESP32Servo.h>
 #include <WiFi.h>
 
+#define SERVO_PIN 12
+
 // Change to your SSID and password
 const char *ssid = "SSID";
 const char *password = "PASSWORD";
@@ -30,27 +32,25 @@ void move(byte servoID, int position) {
   myServo.writeMicroseconds(position);
 }
 
-// Animation object to represent the original Blender animation
+// Animation object to control the animation
 BlenderServoAnimation::Animation animation;
 
-// AnimationData instance acting as a middleware between web socket and
-// animation instance
-BlenderServoAnimation::AnimationData liveStream;
-
-// Handler function writing data to the live stream instance when receiving data
+// Callback function writing live stream data to the animation
 void onWebSocketEvent(AsyncWebSocket *server, AsyncWebSocketClient *client,
                       AwsEventType type, void *arg, uint8_t *data, size_t len) {
   if (type != WS_EVT_DATA) {
     return;
   }
 
   for (size_t i = 0; i < len; i++) {
-    liveStream.writeByte(data[i]);
+    animation.writeLiveStream(data[i]);
   }
 }
 
 void setup() {
   Serial.begin(9600);
+  while (!Serial) {
+  };
 
   WiFi.begin(ssid, password);
   while (WiFi.status() != WL_CONNECTED) {
@@ -65,14 +65,14 @@ void setup() {
   server.addHandler(&ws);
   server.begin();
 
-  // Attach the servo to pin 12
-  myServo.attach(12);
+  // Attach the servo to the defined servo pin
+  myServo.attach(SERVO_PIN);
 
   // Set the position callback
   animation.onPositionChange(move);
 
   // Trigger the animation live mode
-  animation.live(liveStream);
+  animation.live();
 }
 
 void loop() {

images/arduino-nano-with-sd-module.png

@@ -1,3 +1,2 @@
 #include "internal/Animation.h"
-#include "internal/AnimationData.h"
 #include <Arduino.h>

images/arduino-nano-with-servo-and-button.png

@@ -2,14 +2,15 @@
 #include "AnimationData.h"
 #include <Arduino.h>
 
-using namespace BlenderServoAnimation;
+using BlenderServoAnimation::Animation;
+using BlenderServoAnimation::Scene;
 
 Animation::~Animation() {
   if (this->scenes) {
     delete[] this->scenes;
   }
 
-  if (this->liveStream != nullptr && this->isOneTimeLiveStream) {
+  if (this->liveStream != nullptr) {
     delete this->liveStream;
   }
 
@@ -189,25 +190,38 @@ void Animation::stop() {
   this->changeMode(MODE_STOP);
 }
 
-void Animation::live(Stream &stream) {
+void Animation::live() {
   if (this->mode != MODE_DEFAULT) {
     return;
   }
 
-  this->liveStream = new AnimationData(&stream);
-  this->isOneTimeLiveStream = true;
+  if (this->liveStream != nullptr) {
+    delete this->liveStream;
+  }
+
+  this->liveStream = new AnimationData();
   this->changeMode(MODE_LIVE);
 }
 
-void Animation::live(AnimationData &data) {
+void Animation::live(Stream &stream) {
   if (this->mode != MODE_DEFAULT) {
     return;
   }
 
-  this->liveStream = &data;
+  if (this->liveStream != nullptr) {
+    delete this->liveStream;
+  }
+
+  this->liveStream = new AnimationData(&stream);
   this->changeMode(MODE_LIVE);
 }
 
+void Animation::writeLiveStream(byte value) {
+  if (this->liveStream != nullptr) {
+    this->liveStream->writeByte(value);
+  }
+}
+
 byte Animation::getMode() {
   return this->mode;
 }
@@ -286,7 +300,6 @@ void Animation::handlePlayMode(unsigned long currentMicros) {
 
   if (!this->scene) {
     this->changeMode(MODE_DEFAULT);
-    return;
   }
 }
 
@@ -327,7 +340,7 @@ void Animation::changeMode(byte mode) {
   byte prevMode = this->mode;
   this->mode = mode;
 
-  if (prevMode == MODE_LIVE && this->isOneTimeLiveStream) {
+  if (prevMode == MODE_LIVE) {
     delete this->liveStream;
     this->liveStream = nullptr;
   }

images/arduino-nano-with-servo.png

@@ -39,8 +39,9 @@ class Animation {
   void loop();
   void pause();
   void stop();
+  void live();
   void live(Stream &stream);
-  void live(AnimationData &data);
+  void writeLiveStream(byte value);
   void setDefaultServoThreshold(byte value);
   void setServoThreshold(byte id, byte value);
   void setServoOffset(byte id, int offset);
@@ -60,7 +61,6 @@ class Animation {
 
   AnimationData *liveStream = nullptr;
 
-  bool isOneTimeLiveStream = false;
   bool *playedIndexes = nullptr;
 
   mcb modeCallback = nullptr;

images/esp32-with-servo.png

@@ -1,7 +1,7 @@
 #include "AnimationData.h"
 #include <Arduino.h>
 
-using namespace BlenderServoAnimation;
+using BlenderServoAnimation::AnimationData;
 
 AnimationData::AnimationData() {
 }

src/BlenderServoAnimation.h

@@ -1,7 +1,7 @@
 #include "Command.h"
 #include <Arduino.h>
 
-using namespace BlenderServoAnimation;
+using BlenderServoAnimation::Command;
 
 void Command::write(byte value) {
   if (value == START_MARKER) {

src/internal/Animation.cpp

@@ -3,7 +3,7 @@
 #include "Servo.h"
 #include <Arduino.h>
 
-using namespace BlenderServoAnimation;
+using BlenderServoAnimation::Scene;
 
 Scene::Scene(ServoManager *servoManager, AnimationData *data, byte fps,
              int frames) {

src/internal/Animation.h

@@ -2,7 +2,7 @@
 #include "typedefs.h"
 #include <Arduino.h>
 
-using namespace BlenderServoAnimation;
+using BlenderServoAnimation::Servo;
 
 Servo::Servo(byte id, pcb positionCallback, byte threshold) {
   this->id = id;

src/internal/AnimationData.cpp

@@ -2,7 +2,8 @@
 #include "Servo.h"
 #include <Arduino.h>
 
-using namespace BlenderServoAnimation;
+using BlenderServoAnimation::ServoManager;
+using BlenderServoAnimation::Servo;
 
 ServoManager::~ServoManager() {
   if (this->servos) {