[feat] animation modes and repeat support in library

Author: 12alkry45

library/private/animationManager.h

@@ -212,6 +212,16 @@ class animationManager
    */
   void SetCheatSheetConfigured(bool configured);
 
+  /**
+   * Internal setter for Mode.
+   */
+  void SetAnimationMode(const std::string& mode);
+
+  /**
+   * Internal setter for repeats.
+   */
+  void SetAnimationRepeat(int repeat);
+
   options& Options;
   window_impl& Window;
   vtkF3DMetaImporter* Importer = nullptr;
@@ -231,6 +241,19 @@ class animationManager
   // Dynamic options
   bool Autoplay = false;
   double SpeedFactor = 1.0;
+
+  /**
+   * Enum listing possible blending modes.
+   */
+  enum class AnimationModeType : unsigned char
+  {
+    FORWARD,
+    BACKWARD,
+    PINGPONG
+  };
+  AnimationModeType AnimationMode = AnimationModeType::FORWARD;
+  int AnimationMaxRepeat = -1;
+  int AnimationCurrentRepeat = 0;
 };
 }
 }

library/src/animationManager.cxx

@@ -165,15 +165,46 @@ void animationManager::Tick()
         const double remainder = fmod(val, mod);
         return remainder < 0 ? remainder + mod : remainder;
       };
-      this->CurrentTime = this->TimeRange[0] +
-        modulo(this->CurrentTime - this->TimeRange[0], this->TimeRange[1] - this->TimeRange[0]);
+
+      // Switching between animation modes, forward is default
+      switch (this->AnimationMode)
+      {
+        case AnimationModeType::PINGPONG:
+          this->AnimationDirection *= -1;
+          if (this->CurrentTime < this->TimeRange[0])
+          {
+            this->CurrentTime = this->TimeRange[0] + (this->TimeRange[0] - this->CurrentTime);
+          }
+          else if (this->CurrentTime > this->TimeRange[1])
+          {
+            this->CurrentTime = this->TimeRange[1] - (this->CurrentTime - this->TimeRange[1]);
+          }
+          break;
+        case AnimationModeType::BACKWARD:
+          this->AnimationDirection = -1;
+          this->CurrentTime = this->TimeRange[0] +
+            modulo(this->CurrentTime - this->TimeRange[0], this->TimeRange[1] - this->TimeRange[0]);
+        default:
+          this->AnimationDirection = 1;
+          this->CurrentTime = this->TimeRange[0] +
+            modulo(this->CurrentTime - this->TimeRange[0], this->TimeRange[1] - this->TimeRange[0]);
+          break;
+      }
+      if (this->AnimationMaxRepeat != -1)
+      {
+        this->AnimationCurrentRepeat++;
+      }
     }
 
     if (this->LoadAtTime(this->CurrentTime))
     {
       this->Window.render();
     }
   }
+  if (this->AnimationMaxRepeat != -1 && this->AnimationCurrentRepeat == this->AnimationMaxRepeat)
+  {
+    this->Playing = false;
+  }
 }
 
 //----------------------------------------------------------------------------
@@ -692,10 +723,39 @@ void animationManager::SetAnimationDirection(int direction)
   this->AnimationDirection = direction;
 }
 
+//----------------------------------------------------------------------------
+void animationManager::SetAnimationMode(const std::string& mode)
+{
+  if (mode == "backward")
+  {
+    this->AnimationMode = AnimationModeType::BACKWARD;
+    this->AnimationDirection = -1;
+  }
+  else if (mode == "pingpong")
+  {
+    this->AnimationMode = AnimationModeType::PINGPONG;
+    this->AnimationDirection = 1;
+  }
+  else
+  {
+    this->AnimationMode = AnimationModeType::FORWARD;
+    this->AnimationDirection = 1;
+  }
+}
+
+//----------------------------------------------------------------------------
+void animationManager::SetAnimationRepeat(int repeat)
+{
+  assert(repeat >= -1);
+  this->AnimationMaxRepeat = repeat;
+}
+
 //----------------------------------------------------------------------------
 void animationManager::UpdateDynamicOptions()
 {
   this->SetAutoplay(this->Options.scene.animation.autoplay);
   this->SetSpeedFactor(this->Options.scene.animation.speed_factor);
+  this->SetAnimationMode(this->Options.scene.animation.mode);
+  this->SetAnimationRepeat(this->Options.scene.animation.repeat);
 }
 }