feat: 🎸 add a method to check if the animation is completed

dotlottie-ffi/emscripten_bindings.cpp

@@ -97,5 +97,6 @@ EMSCRIPTEN_BINDINGS(DotLottiePlayer)
         .function("setConfig", &DotLottiePlayer::set_config)
         .function("setFrame", &DotLottiePlayer::set_frame)
         .function("stop", &DotLottiePlayer::stop)
-        .function("totalFrames", &DotLottiePlayer::total_frames);
+        .function("totalFrames", &DotLottiePlayer::total_frames)
+        .function("isComplete", &DotLottiePlayer::is_complete);
 }

dotlottie-ffi/src/dotlottie_player.udl

@@ -82,4 +82,5 @@ interface DotLottiePlayer {
     boolean render();
     boolean resize(u32 width, u32 height);
     void clear();
+    boolean is_complete();
 };

dotlottie-rs/src/dotlottie_player.rs

@@ -505,6 +505,13 @@ impl DotLottieRuntime {
     pub fn config(&self) -> Config {
         self.config.clone()
     }
+
+    pub fn is_complete(&self) -> bool {
+        match self.config.mode {
+            Mode::Forward | Mode::ReverseBounce => self.current_frame() >= self.end_frame(),
+            Mode::Reverse | Mode::Bounce => self.current_frame() <= self.start_frame(),
+        }
+    }
 }
 
 pub struct DotLottiePlayer {
@@ -647,6 +654,10 @@ impl DotLottiePlayer {
             None => "{}".to_string(),
         }
     }
+
+    pub fn is_complete(&self) -> bool {
+        self.runtime.read().unwrap().is_complete()
+    }
 }
 
 unsafe impl Send for DotLottiePlayer {}

web-example.html

@@ -102,7 +102,6 @@
 
       function animationLoop() {
         const nextFrameNumber = dotLottiePlayer.requestFrame();
-        // console.log(nextFrameNumber);
 
         const updated = dotLottiePlayer.setFrame(nextFrameNumber);
 
@@ -118,6 +117,14 @@
             imageData.data.set(frameBuffer);
             ctx.putImageData(imageData, 0, 0);
           }
+
+          if (dotLottiePlayer.isComplete()) {
+            if (dotLottiePlayer.config().loopAnimation) {
+              console.log("Loop Completed", dotLottiePlayer.loopCount());
+            } else {
+              console.log("Completed");
+            }
+          }
         }
 
         animationFrameId = requestAnimationFrame(animationLoop);