✨ Added optional onDraw method to run after the _render call.

spec/unit/movie/movie.spec.ts

@@ -130,6 +130,24 @@ describe('Unit Tests ->', function () {
         expect(layer.stop).toHaveBeenCalledTimes(0)
       })
 
+      it('should call user provided `onDraw` after drawing', async function () {
+        // 1a. Force currentTime to 0
+        mockTime(0)
+
+        // 1b. Layer must be inactive to start
+        const layer = movie.layers[0]
+        layer.active = false
+
+        // 2a. Prepare options object with onDraw callback
+        const options = jasmine.createSpyObj('options', ['onDraw'])
+
+        // 2. Play one frame at the beginning of the movie with the spy options
+        await movie.play(options)
+
+        // 3. Make sure onDraw was called
+        expect(options.onDraw).toHaveBeenCalledTimes(1)
+      })
+
       it('should be able to operate after a layer has been deleted', async function () {
         mockTime()
 

src/movie/movie.ts

@@ -130,6 +130,7 @@ export class Movie {
    * @return Fulfilled when the movie is done playing, never fails
    */
   async play (options: {
+    onDraw?: () => void,
     onStart?: () => void,
     duration?: number,
   } = {}): Promise<void> {
@@ -152,7 +153,11 @@ export class Movie {
     await new Promise<void>(resolve => {
       if (!this.renderingFrame) {
         // Not rendering (and not playing), so play.
-        this._render(undefined, resolve)
+        this._render(undefined, () => {
+          // Call optional onDraw callback when render is complete
+          options.onDraw?.()
+          return resolve()
+        })
       }
 
       // Stop rendering frame if currently doing so, because playing has higher