@babylonjs/addons 8.22.2 → 8.23.0

package/lottie/maths/boundingBox.js

@@ -0,0 +1,155 @@
+/**
+ * Calculates the bounding box for a group shape in a Lottie animation.
+ * @param rawGroup The raw group shape to calculate the bounding box for
+ * @returns The bounding box for the group shape
+ */
+export function GetBoundingBox(rawGroup) {
+    const boxCorners = {
+        minX: Infinity,
+        minY: Infinity,
+        maxX: -Infinity,
+        maxY: -Infinity,
+    };
+    if (rawGroup.it !== undefined) {
+        for (let i = 0; i < rawGroup.it.length; i++) {
+            if (rawGroup.it[i].ty === "rc") {
+                GetRectangleVertices(boxCorners, rawGroup.it[i]);
+            }
+            else if (rawGroup.it[i].ty === "sh") {
+                GetPathVertices(boxCorners, rawGroup.it[i]);
+            }
+        }
+    }
+    return {
+        width: Math.ceil(boxCorners.maxX - boxCorners.minX),
+        height: Math.ceil(boxCorners.maxY - boxCorners.minY),
+        centerX: Math.ceil((boxCorners.maxX + boxCorners.minX) / 2),
+        centerY: Math.ceil((boxCorners.maxY + boxCorners.minY) / 2),
+    };
+}
+function GetRectangleVertices(boxCorners, rect) {
+    const size = rect.s.k;
+    const position = rect.p.k;
+    // Calculate the four corners of the rectangle
+    UpdateBoxCorners(boxCorners, position[0] - size[0] / 2, position[1] - size[1] / 2);
+    UpdateBoxCorners(boxCorners, position[0] + size[0] / 2, position[1] - size[1] / 2);
+    UpdateBoxCorners(boxCorners, position[0] + size[0] / 2, position[1] + size[1] / 2);
+    UpdateBoxCorners(boxCorners, position[0] - size[0] / 2, position[1] + size[1] / 2);
+}
+function GetPathVertices(boxCorners, path) {
+    const bezier = path.ks.k;
+    const vertices = bezier.v;
+    const inTangents = bezier.i;
+    const outTangents = bezier.o;
+    // Check the control points of the path
+    for (let i = 0; i < vertices.length; i++) {
+        UpdateBoxCorners(boxCorners, vertices[i][0], vertices[i][1]);
+    }
+    for (let i = 0; i < vertices.length; i++) {
+        // Skip last point if the path is not closed
+        if (!bezier.c && i === vertices.length - 1) {
+            continue;
+        }
+        const start = vertices[i];
+        const end = i === vertices.length - 1 ? vertices[0] : vertices[i + 1];
+        const outTangent = outTangents[i];
+        const inTangent = i === vertices.length - 1 ? inTangents[0] : inTangents[i + 1];
+        // Calculate the points where the tangent is zero
+        CalculatePointsWithTangentZero(boxCorners, start[0], start[1], end[0], end[1], start[0] + outTangent[0], start[1] + outTangent[1], end[0] + inTangent[0], end[1] + inTangent[1]);
+    }
+}
+function CalculatePointsWithTangentZero(boxCorners, startX, startY, endX, endY, controlPoint1X, controlPoint1Y, controlPoint2X, controlPoint2Y) {
+    // Calculate the derivative of the bezier formula for X and Y components
+    // For X component:
+    const ax = 3 * (endX - 3 * controlPoint2X + 3 * controlPoint1X - startX);
+    const bx = 6 * (controlPoint2X - 2 * controlPoint1X + startX);
+    const cx = 3 * (controlPoint1X - startX);
+    // For Y component:
+    const ay = 3 * (endY - 3 * controlPoint2Y + 3 * controlPoint1Y - startY);
+    const by = 6 * (controlPoint2Y - 2 * controlPoint1Y + startY);
+    const cy = 3 * (controlPoint1Y - startY);
+    // Solve the quadratic equation where dt/dt = 0 (tangent is zero)
+    const rootsX = SolveQuadratic(ax, bx, cx);
+    const rootsY = SolveQuadratic(ay, by, cy);
+    // Merge + dedupe (roots arrays are tiny: <=2 each)
+    const candidateTs = rootsX.slice(); // copy
+    for (let i = 0; i < rootsY.length; i++) {
+        const ty = rootsY[i];
+        let exists = false;
+        for (let j = 0; j < candidateTs.length; j++) {
+            if (candidateTs[j] === ty) {
+                exists = true;
+                break;
+            }
+        }
+        if (!exists) {
+            candidateTs.push(ty);
+        }
+    }
+    // Evaluate the bezier at the calculated t values to find the points of the curve where the tangent is zero
+    for (let i = 0; i < candidateTs.length; i++) {
+        const t = candidateTs[i];
+        if (t >= 0 && t <= 1) {
+            const x = BezierPoint(t, startX, controlPoint1X, controlPoint2X, endX);
+            const y = BezierPoint(t, startY, controlPoint1Y, controlPoint2Y, endY);
+            UpdateBoxCorners(boxCorners, x, y);
+        }
+    }
+}
+// Alternative implementation for bounding box calculation using sampling of the bezier curve instead of finding points where the tangent is zero.
+// function bezierBoundingBoxSampled(boxCorners: Corners, start:IVector2Like, outTangent:IVector2Like, inTangent:IVector2Like, end:IVector2Like) {
+//     for (let i = 0; i <= SamplingSteps; i++) {
+//         const t = i / SamplingSteps;
+//         const x = bezierPoint(t, start.x, outTangent.x, inTangent.x, end.x);
+//         const y = bezierPoint(t, start.y, outTangent.y, inTangent.y, end.y);
+//         updateBoxCorners(boxCorners, x, y);
+//     }
+// }
+function SolveQuadratic(a, b, c) {
+    const roots = [];
+    // Handle the case where a is zero (linear equation)
+    // Linear equation: bx + c = 0 => x = -c / b
+    if (Math.abs(a) < 1e-10) {
+        if (Math.abs(b) > 1e-10) {
+            const root = -c / b;
+            roots.push(root);
+        }
+        return roots;
+    }
+    // Solve the quadratic equation ax^2 + bx + c = 0
+    const discriminant = b * b - 4 * a * c;
+    if (discriminant < 0) {
+        return roots; // No real roots
+    }
+    if (Math.abs(discriminant) < 1e-10) {
+        const root = -b / (2 * a);
+        roots.push(root);
+    }
+    else {
+        const sqrtD = Math.sqrt(discriminant);
+        const root1 = (-b + sqrtD) / (2 * a);
+        const root2 = (-b - sqrtD) / (2 * a);
+        roots.push(root1);
+        roots.push(root2);
+    }
+    return roots;
+}
+function BezierPoint(t, p0, p1, p2, p3) {
+    const mt = 1 - t;
+    return mt * mt * mt * p0 + 3 * mt * mt * t * p1 + 3 * mt * t * t * p2 + t * t * t * p3;
+}
+function UpdateBoxCorners(boxCorners, x, y) {
+    if (x < boxCorners.minX) {
+        boxCorners.minX = x;
+    }
+    if (x > boxCorners.maxX) {
+        boxCorners.maxX = x;
+    }
+    if (y < boxCorners.minY) {
+        boxCorners.minY = y;
+    }
+    if (y > boxCorners.maxY) {
+        boxCorners.maxY = y;
+    }
+}
+//# sourceMappingURL=boundingBox.js.map

package/lottie/maths/boundingBox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundingBox.js","sourceRoot":"","sources":["../../../../../dev/addons/src/lottie/maths/boundingBox.ts"],"names":[],"mappings":"AAgCA;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,QAAuB;IAClD,MAAM,UAAU,GAAY;QACxB,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,CAAC,QAAQ;QACf,IAAI,EAAE,CAAC,QAAQ;KAClB,CAAC;IAEF,IAAI,QAAQ,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;QAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,IAAI,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;gBAC7B,oBAAoB,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAsB,CAAC,CAAC;YAC1E,CAAC;iBAAM,IAAI,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;gBACpC,eAAe,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAiB,CAAC,CAAC;YAChE,CAAC;QACL,CAAC;IACL,CAAC;IAED,OAAO;QACH,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;QACnD,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;QACpD,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3D,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;KAC9D,CAAC;AACN,CAAC;AAED,SAAS,oBAAoB,CAAC,UAAmB,EAAE,IAAuB;IACtE,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAa,CAAC;IAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAa,CAAC;IAEtC,8CAA8C;IAC9C,gBAAgB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACnF,gBAAgB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACnF,gBAAgB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACnF,gBAAgB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACvF,CAAC;AAED,SAAS,eAAe,CAAC,UAAmB,EAAE,IAAkB;IAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,CAAc,CAAC;IACtC,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC;IAC1B,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC;IAC5B,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC;IAE7B,uCAAuC;IACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,gBAAgB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,4CAA4C;QAC5C,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzC,SAAS;QACb,CAAC;QAED,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,GAAG,GAAG,CAAC,KAAK,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACtE,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,SAAS,GAAG,CAAC,KAAK,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAEhF,iDAAiD;QACjD,8BAA8B,CAC1B,UAAU,EACV,KAAK,CAAC,CAAC,CAAC,EACR,KAAK,CAAC,CAAC,CAAC,EACR,GAAG,CAAC,CAAC,CAAC,EACN,GAAG,CAAC,CAAC,CAAC,EACN,KAAK,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,EACxB,KAAK,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,EACxB,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,EACrB,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CACxB,CAAC;IACN,CAAC;AACL,CAAC;AAED,SAAS,8BAA8B,CACnC,UAAmB,EACnB,MAAc,EACd,MAAc,EACd,IAAY,EACZ,IAAY,EACZ,cAAsB,EACtB,cAAsB,EACtB,cAAsB,EACtB,cAAsB;IAEtB,wEAAwE;IACxE,mBAAmB;IACnB,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,GAAG,cAAc,GAAG,CAAC,GAAG,cAAc,GAAG,MAAM,CAAC,CAAC;IACzE,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,cAAc,GAAG,CAAC,GAAG,cAAc,GAAG,MAAM,CAAC,CAAC;IAC9D,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,cAAc,GAAG,MAAM,CAAC,CAAC;IAEzC,mBAAmB;IACnB,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,GAAG,cAAc,GAAG,CAAC,GAAG,cAAc,GAAG,MAAM,CAAC,CAAC;IACzE,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,cAAc,GAAG,CAAC,GAAG,cAAc,GAAG,MAAM,CAAC,CAAC;IAC9D,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,cAAc,GAAG,MAAM,CAAC,CAAC;IAEzC,iEAAiE;IACjE,MAAM,MAAM,GAAG,cAAc,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,cAAc,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAE1C,mDAAmD;IACnD,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,OAAO;IAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACrB,IAAI,MAAM,GAAG,KAAK,CAAC;QACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,IAAI,WAAW,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;gBACxB,MAAM,GAAG,IAAI,CAAC;gBACd,MAAM;YACV,CAAC;QACL,CAAC;QACD,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzB,CAAC;IACL,CAAC;IAED,2GAA2G;IAC3G,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACnB,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;YACvE,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;YACvE,gBAAgB,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACvC,CAAC;IACL,CAAC;AACL,CAAC;AAED,kJAAkJ;AAClJ,kJAAkJ;AAClJ,iDAAiD;AACjD,uCAAuC;AAEvC,+EAA+E;AAC/E,+EAA+E;AAC/E,8CAA8C;AAC9C,QAAQ;AACR,IAAI;AAEJ,SAAS,cAAc,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS;IACnD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,oDAAoD;IACpD,4CAA4C;IAC5C,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC;QACtB,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC;YACtB,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;QAED,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,iDAAiD;IACjD,MAAM,YAAY,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;QACnB,OAAO,KAAK,CAAC,CAAC,gBAAgB;IAClC,CAAC;IAED,IAAI,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,KAAK,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;SAAM,CAAC;QACJ,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACtC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACrC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,SAAS,WAAW,CAAC,CAAS,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU;IAC1E,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IACjB,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;AAC3F,CAAC;AAED,SAAS,gBAAgB,CAAC,UAAmB,EAAE,CAAS,EAAE,CAAS;IAC/D,IAAI,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;QACtB,UAAU,CAAC,IAAI,GAAG,CAAC,CAAC;IACxB,CAAC;IACD,IAAI,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;QACtB,UAAU,CAAC,IAAI,GAAG,CAAC,CAAC;IACxB,CAAC;IACD,IAAI,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;QACtB,UAAU,CAAC,IAAI,GAAG,CAAC,CAAC;IACxB,CAAC;IACD,IAAI,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;QACtB,UAAU,CAAC,IAAI,GAAG,CAAC,CAAC;IACxB,CAAC;AACL,CAAC","sourcesContent":["import type { RawBezier, RawGroupShape, RawPathShape, RawRectangleShape } from \"../lottie/rawTypes\";\r\n\r\n/**\r\n * Represents a bounding box for a shape in the animation.\r\n */\r\nexport type BoundingBox = {\r\n    /**\r\n     * Height of the bounding box\r\n     */\r\n    height: number;\r\n    /**\r\n     * Width of the bounding box\r\n     */\r\n    width: number;\r\n    /**\r\n     * X coordinate of the center of the bounding box\r\n     */\r\n    centerX: number;\r\n    /**\r\n     * Y coordinate of the center of the bounding box\r\n     */\r\n    centerY: number;\r\n};\r\n\r\n// Corners of the bounding box\r\ntype Corners = {\r\n    minX: number;\r\n    minY: number;\r\n    maxX: number;\r\n    maxY: number;\r\n};\r\n\r\n/**\r\n * Calculates the bounding box for a group shape in a Lottie animation.\r\n * @param rawGroup The raw group shape to calculate the bounding box for\r\n * @returns The bounding box for the group shape\r\n */\r\nexport function GetBoundingBox(rawGroup: RawGroupShape): BoundingBox {\r\n    const boxCorners: Corners = {\r\n        minX: Infinity,\r\n        minY: Infinity,\r\n        maxX: -Infinity,\r\n        maxY: -Infinity,\r\n    };\r\n\r\n    if (rawGroup.it !== undefined) {\r\n        for (let i = 0; i < rawGroup.it.length; i++) {\r\n            if (rawGroup.it[i].ty === \"rc\") {\r\n                GetRectangleVertices(boxCorners, rawGroup.it[i] as RawRectangleShape);\r\n            } else if (rawGroup.it[i].ty === \"sh\") {\r\n                GetPathVertices(boxCorners, rawGroup.it[i] as RawPathShape);\r\n            }\r\n        }\r\n    }\r\n\r\n    return {\r\n        width: Math.ceil(boxCorners.maxX - boxCorners.minX),\r\n        height: Math.ceil(boxCorners.maxY - boxCorners.minY),\r\n        centerX: Math.ceil((boxCorners.maxX + boxCorners.minX) / 2),\r\n        centerY: Math.ceil((boxCorners.maxY + boxCorners.minY) / 2),\r\n    };\r\n}\r\n\r\nfunction GetRectangleVertices(boxCorners: Corners, rect: RawRectangleShape): void {\r\n    const size = rect.s.k as number[];\r\n    const position = rect.p.k as number[];\r\n\r\n    // Calculate the four corners of the rectangle\r\n    UpdateBoxCorners(boxCorners, position[0] - size[0] / 2, position[1] - size[1] / 2);\r\n    UpdateBoxCorners(boxCorners, position[0] + size[0] / 2, position[1] - size[1] / 2);\r\n    UpdateBoxCorners(boxCorners, position[0] + size[0] / 2, position[1] + size[1] / 2);\r\n    UpdateBoxCorners(boxCorners, position[0] - size[0] / 2, position[1] + size[1] / 2);\r\n}\r\n\r\nfunction GetPathVertices(boxCorners: Corners, path: RawPathShape): void {\r\n    const bezier = path.ks.k as RawBezier;\r\n    const vertices = bezier.v;\r\n    const inTangents = bezier.i;\r\n    const outTangents = bezier.o;\r\n\r\n    // Check the control points of the path\r\n    for (let i = 0; i < vertices.length; i++) {\r\n        UpdateBoxCorners(boxCorners, vertices[i][0], vertices[i][1]);\r\n    }\r\n\r\n    for (let i = 0; i < vertices.length; i++) {\r\n        // Skip last point if the path is not closed\r\n        if (!bezier.c && i === vertices.length - 1) {\r\n            continue;\r\n        }\r\n\r\n        const start = vertices[i];\r\n        const end = i === vertices.length - 1 ? vertices[0] : vertices[i + 1];\r\n        const outTangent = outTangents[i];\r\n        const inTangent = i === vertices.length - 1 ? inTangents[0] : inTangents[i + 1];\r\n\r\n        // Calculate the points where the tangent is zero\r\n        CalculatePointsWithTangentZero(\r\n            boxCorners,\r\n            start[0],\r\n            start[1],\r\n            end[0],\r\n            end[1],\r\n            start[0] + outTangent[0],\r\n            start[1] + outTangent[1],\r\n            end[0] + inTangent[0],\r\n            end[1] + inTangent[1]\r\n        );\r\n    }\r\n}\r\n\r\nfunction CalculatePointsWithTangentZero(\r\n    boxCorners: Corners,\r\n    startX: number,\r\n    startY: number,\r\n    endX: number,\r\n    endY: number,\r\n    controlPoint1X: number,\r\n    controlPoint1Y: number,\r\n    controlPoint2X: number,\r\n    controlPoint2Y: number\r\n): void {\r\n    // Calculate the derivative of the bezier formula for X and Y components\r\n    // For X component:\r\n    const ax = 3 * (endX - 3 * controlPoint2X + 3 * controlPoint1X - startX);\r\n    const bx = 6 * (controlPoint2X - 2 * controlPoint1X + startX);\r\n    const cx = 3 * (controlPoint1X - startX);\r\n\r\n    // For Y component:\r\n    const ay = 3 * (endY - 3 * controlPoint2Y + 3 * controlPoint1Y - startY);\r\n    const by = 6 * (controlPoint2Y - 2 * controlPoint1Y + startY);\r\n    const cy = 3 * (controlPoint1Y - startY);\r\n\r\n    // Solve the quadratic equation where dt/dt = 0 (tangent is zero)\r\n    const rootsX = SolveQuadratic(ax, bx, cx);\r\n    const rootsY = SolveQuadratic(ay, by, cy);\r\n\r\n    // Merge + dedupe (roots arrays are tiny: <=2 each)\r\n    const candidateTs = rootsX.slice(); // copy\r\n    for (let i = 0; i < rootsY.length; i++) {\r\n        const ty = rootsY[i];\r\n        let exists = false;\r\n        for (let j = 0; j < candidateTs.length; j++) {\r\n            if (candidateTs[j] === ty) {\r\n                exists = true;\r\n                break;\r\n            }\r\n        }\r\n        if (!exists) {\r\n            candidateTs.push(ty);\r\n        }\r\n    }\r\n\r\n    // Evaluate the bezier at the calculated t values to find the points of the curve where the tangent is zero\r\n    for (let i = 0; i < candidateTs.length; i++) {\r\n        const t = candidateTs[i];\r\n        if (t >= 0 && t <= 1) {\r\n            const x = BezierPoint(t, startX, controlPoint1X, controlPoint2X, endX);\r\n            const y = BezierPoint(t, startY, controlPoint1Y, controlPoint2Y, endY);\r\n            UpdateBoxCorners(boxCorners, x, y);\r\n        }\r\n    }\r\n}\r\n\r\n// Alternative implementation for bounding box calculation using sampling of the bezier curve instead of finding points where the tangent is zero.\r\n// function bezierBoundingBoxSampled(boxCorners: Corners, start:IVector2Like, outTangent:IVector2Like, inTangent:IVector2Like, end:IVector2Like) {\r\n//     for (let i = 0; i <= SamplingSteps; i++) {\r\n//         const t = i / SamplingSteps;\r\n\r\n//         const x = bezierPoint(t, start.x, outTangent.x, inTangent.x, end.x);\r\n//         const y = bezierPoint(t, start.y, outTangent.y, inTangent.y, end.y);\r\n//         updateBoxCorners(boxCorners, x, y);\r\n//     }\r\n// }\r\n\r\nfunction SolveQuadratic(a: number, b: number, c: number): number[] {\r\n    const roots: number[] = [];\r\n\r\n    // Handle the case where a is zero (linear equation)\r\n    // Linear equation: bx + c = 0 => x = -c / b\r\n    if (Math.abs(a) < 1e-10) {\r\n        if (Math.abs(b) > 1e-10) {\r\n            const root = -c / b;\r\n            roots.push(root);\r\n        }\r\n\r\n        return roots;\r\n    }\r\n\r\n    // Solve the quadratic equation ax^2 + bx + c = 0\r\n    const discriminant = b * b - 4 * a * c;\r\n    if (discriminant < 0) {\r\n        return roots; // No real roots\r\n    }\r\n\r\n    if (Math.abs(discriminant) < 1e-10) {\r\n        const root = -b / (2 * a);\r\n        roots.push(root);\r\n    } else {\r\n        const sqrtD = Math.sqrt(discriminant);\r\n        const root1 = (-b + sqrtD) / (2 * a);\r\n        const root2 = (-b - sqrtD) / (2 * a);\r\n        roots.push(root1);\r\n        roots.push(root2);\r\n    }\r\n\r\n    return roots;\r\n}\r\n\r\nfunction BezierPoint(t: number, p0: number, p1: number, p2: number, p3: number): number {\r\n    const mt = 1 - t;\r\n    return mt * mt * mt * p0 + 3 * mt * mt * t * p1 + 3 * mt * t * t * p2 + t * t * t * p3;\r\n}\r\n\r\nfunction UpdateBoxCorners(boxCorners: Corners, x: number, y: number): void {\r\n    if (x < boxCorners.minX) {\r\n        boxCorners.minX = x;\r\n    }\r\n    if (x > boxCorners.maxX) {\r\n        boxCorners.maxX = x;\r\n    }\r\n    if (y < boxCorners.minY) {\r\n        boxCorners.minY = y;\r\n    }\r\n    if (y > boxCorners.maxY) {\r\n        boxCorners.maxY = y;\r\n    }\r\n}\r\n"]}

package/lottie/maths/matrix.d.ts

@@ -0,0 +1,91 @@
+import type { IMatrixLike, IVector2Like } from "@babylonjs/core/Maths/math.like.js";
+import type { Tuple } from "@babylonjs/core/types.js";
+/**
+ * Represents a Babylon.js thin version of a Matrix
+ * We are only exposing what we truly need in the scope of
+ * the Lottie Renderer project preventing the dependency on the full
+ * Babylon.js math system.
+ */
+export declare class ThinMatrix implements IMatrixLike {
+    /**
+     * Prevents global conflicts on update as shader programs are shared.
+     */
+    private static _UPDATE_FLAG_SEED;
+    /**
+     * Current update flag used to know whether a Matrix has changed since previous render or not.
+     * This helps identifying if a Matrix needs to be
+     * uploaded to a shader program.
+     */
+    updateFlag: number;
+    private readonly _data;
+    /**
+     * Creates a new ThinMatrix instance.
+     */
+    constructor();
+    /**
+     * Set the matrix values.
+     * @param m11 Value for row 1, column 1
+     * @param m12 Value for row 1, column 2
+     * @param m13 Value for row 1, column 3
+     * @param m14 Value for row 1, column 4
+     * @param m21 Value for row 2, column 1
+     * @param m22 Value for row 2, column 2
+     * @param m23 Value for row 2, column 3
+     * @param m24 Value for row 2, column 4
+     * @param m31 Value for row 3, column 1
+     * @param m32 Value for row 3, column 2
+     * @param m33 Value for row 3, column 3
+     * @param m34 Value for row 3, column 4
+     * @param m41 Value for row 4, column 1
+     * @param m42 Value for row 4, column 2
+     * @param m43 Value for row 4, column 3
+     * @param m44 Value for row 4, column 4
+     * @returns The updated ThinMatrix instance
+     */
+    setValues(m11: number, m12: number, m13: number, m14: number, m21: number, m22: number, m23: number, m24: number, m31: number, m32: number, m33: number, m34: number, m41: number, m42: number, m43: number, m44: number): ThinMatrix;
+    /**
+     * Set the matrix to an identity matrix.
+     * @returns The updated ThinMatrix instance
+     */
+    identity(): ThinMatrix;
+    /**
+     * Stores a left-handed orthographic projection into a given matrix
+     * @param left defines the viewport left coordinate
+     * @param right defines the viewport right coordinate
+     * @param bottom defines the viewport bottom coordinate
+     * @param top defines the viewport top coordinate
+     * @param znear defines the near clip plane
+     * @param zfar defines the far clip plane
+     * @returns The updated ThinMatrix instance
+     */
+    orthoOffCenterLeftHanded(left: number, right: number, bottom: number, top: number, znear: number, zfar: number): ThinMatrix;
+    /**
+     * Sets a matrix to a value composed by merging scale (vector2), rotation (roll around z) and translation (vector2)
+     * This only updates the parts of the matrix that are used for 2D transformations.
+     * @param scale defines the scale vector
+     * @param roll defines the rotation around z
+     * @param translation defines the translation vector
+     * @returns the updated ThinMatrix instance
+     */
+    compose(scale: IVector2Like, roll: number, translation: IVector2Like): ThinMatrix;
+    /**
+     * Sets the current matrix with the multiplication result of the current Matrix and the given one
+     * This only updates the parts of the matrix that are used for 2D transformations.
+     * @param other defines the second operand
+     * @param output the matrix to store the result in
+     * @returns the current matrix
+     */
+    multiplyToRef(other: ThinMatrix, output: ThinMatrix): ThinMatrix;
+    /**
+     * Returns the matrix data array.
+     * @returns The matrix data
+     */
+    asArray(): Tuple<number, 16>;
+    /**
+     * Decomposes the matrix into scale, rotation, and translation.
+     * @param scale Scale vector to store the scale values
+     * @param translation Translation vector to store the translation values
+     * @returns The rotation in radians
+     */
+    decompose(scale: IVector2Like, translation: IVector2Like): number;
+}

package/lottie/maths/matrix.js

@@ -0,0 +1,174 @@
+/**
+ * Represents a Babylon.js thin version of a Matrix
+ * We are only exposing what we truly need in the scope of
+ * the Lottie Renderer project preventing the dependency on the full
+ * Babylon.js math system.
+ */
+export class ThinMatrix {
+    /**
+     * Creates a new ThinMatrix instance.
+     */
+    constructor() {
+        /**
+         * Current update flag used to know whether a Matrix has changed since previous render or not.
+         * This helps identifying if a Matrix needs to be
+         * uploaded to a shader program.
+         */
+        this.updateFlag = -1;
+        this._data = new Float32Array(16);
+    }
+    /**
+     * Set the matrix values.
+     * @param m11 Value for row 1, column 1
+     * @param m12 Value for row 1, column 2
+     * @param m13 Value for row 1, column 3
+     * @param m14 Value for row 1, column 4
+     * @param m21 Value for row 2, column 1
+     * @param m22 Value for row 2, column 2
+     * @param m23 Value for row 2, column 3
+     * @param m24 Value for row 2, column 4
+     * @param m31 Value for row 3, column 1
+     * @param m32 Value for row 3, column 2
+     * @param m33 Value for row 3, column 3
+     * @param m34 Value for row 3, column 4
+     * @param m41 Value for row 4, column 1
+     * @param m42 Value for row 4, column 2
+     * @param m43 Value for row 4, column 3
+     * @param m44 Value for row 4, column 4
+     * @returns The updated ThinMatrix instance
+     */
+    setValues(m11, m12, m13, m14, m21, m22, m23, m24, m31, m32, m33, m34, m41, m42, m43, m44) {
+        const m = this._data;
+        m[0] = m11;
+        m[1] = m12;
+        m[2] = m13;
+        m[3] = m14;
+        m[4] = m21;
+        m[5] = m22;
+        m[6] = m23;
+        m[7] = m24;
+        m[8] = m31;
+        m[9] = m32;
+        m[10] = m33;
+        m[11] = m34;
+        m[12] = m41;
+        m[13] = m42;
+        m[14] = m43;
+        m[15] = m44;
+        this.updateFlag = ThinMatrix._UPDATE_FLAG_SEED++;
+        return this;
+    }
+    /**
+     * Set the matrix to an identity matrix.
+     * @returns The updated ThinMatrix instance
+     */
+    identity() {
+        this.setValues(1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1);
+        return this;
+    }
+    /**
+     * Stores a left-handed orthographic projection into a given matrix
+     * @param left defines the viewport left coordinate
+     * @param right defines the viewport right coordinate
+     * @param bottom defines the viewport bottom coordinate
+     * @param top defines the viewport top coordinate
+     * @param znear defines the near clip plane
+     * @param zfar defines the far clip plane
+     * @returns The updated ThinMatrix instance
+     */
+    orthoOffCenterLeftHanded(left, right, bottom, top, znear, zfar) {
+        const n = znear;
+        const f = zfar;
+        const a = 2.0 / (right - left);
+        const b = 2.0 / (top - bottom);
+        const c = 2.0 / (f - n);
+        const d = -(f + n) / (f - n);
+        const i0 = (left + right) / (left - right);
+        const i1 = (top + bottom) / (bottom - top);
+        this.setValues(a, 0.0, 0.0, 0.0, 0.0, b, 0.0, 0.0, 0.0, 0.0, c, 0.0, i0, i1, d, 1.0);
+        return this;
+    }
+    /**
+     * Sets a matrix to a value composed by merging scale (vector2), rotation (roll around z) and translation (vector2)
+     * This only updates the parts of the matrix that are used for 2D transformations.
+     * @param scale defines the scale vector
+     * @param roll defines the rotation around z
+     * @param translation defines the translation vector
+     * @returns the updated ThinMatrix instance
+     */
+    compose(scale, roll, translation) {
+        // Produces a quaternion from Euler angles in the z-y-x orientation (Tait-Bryan angles)
+        const halfRoll = roll * 0.5;
+        const z = Math.sin(halfRoll), w = Math.cos(halfRoll);
+        const z2 = z + z;
+        const zz = z * z2;
+        const wz = w * z2;
+        const sx = scale.x, sy = scale.y;
+        const m = this._data;
+        m[0] = (1 - zz) * sx;
+        m[1] = wz * sx;
+        m[4] = -wz * sy;
+        m[5] = (1 - zz) * sy;
+        m[12] = translation.x;
+        m[13] = translation.y;
+        return this;
+    }
+    /**
+     * Sets the current matrix with the multiplication result of the current Matrix and the given one
+     * This only updates the parts of the matrix that are used for 2D transformations.
+     * @param other defines the second operand
+     * @param output the matrix to store the result in
+     * @returns the current matrix
+     */
+    multiplyToRef(other, output) {
+        const m = this._data;
+        const otherM = other._data;
+        // Only calculate the values we actually use (2D transform)
+        const tm0 = m[0], tm1 = m[1], tm4 = m[4], tm5 = m[5];
+        const tm12 = m[12], tm13 = m[13];
+        const om0 = otherM[0], om1 = otherM[1];
+        const om4 = otherM[4], om5 = otherM[5];
+        const om12 = otherM[12], om13 = otherM[13];
+        // Only update the 2D transformation parts
+        output._data[0] = tm0 * om0 + tm1 * om4;
+        output._data[1] = tm0 * om1 + tm1 * om5;
+        output._data[4] = tm4 * om0 + tm5 * om4;
+        output._data[5] = tm4 * om1 + tm5 * om5;
+        output._data[12] = tm12 * om0 + tm13 * om4 + om12;
+        output._data[13] = tm12 * om1 + tm13 * om5 + om13;
+        return this;
+    }
+    /**
+     * Returns the matrix data array.
+     * @returns The matrix data
+     */
+    asArray() {
+        return this._data;
+    }
+    /**
+     * Decomposes the matrix into scale, rotation, and translation.
+     * @param scale Scale vector to store the scale values
+     * @param translation Translation vector to store the translation values
+     * @returns The rotation in radians
+     */
+    decompose(scale, translation) {
+        const m00 = this._data[0]; // scaleX * cos(θ)
+        const m01 = this._data[1]; // -scaleY * sin(θ)
+        const m10 = this._data[4]; // scaleX * sin(θ)
+        const m11 = this._data[5]; // scaleY * cos(θ)
+        // Extract scale
+        scale.x = Math.hypot(m00, m10); // sqrt(m00² + m10²)
+        scale.y = Math.hypot(m01, m11); // sqrt(m01² + m11²)
+        // Extract rotation (assumes uniform scaling or affine 2D)
+        const rotation = Math.atan2(m10, m00); // θ from the first column
+        // Extract the translation
+        translation.x = this._data[12];
+        translation.y = this._data[13];
+        return rotation;
+    }
+}
+/**
+ * Prevents global conflicts on update as shader programs are shared.
+ */
+ThinMatrix._UPDATE_FLAG_SEED = 0;
+//# sourceMappingURL=matrix.js.map

package/lottie/maths/matrix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matrix.js","sourceRoot":"","sources":["../../../../../dev/addons/src/lottie/maths/matrix.ts"],"names":[],"mappings":"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","sourcesContent":["import type { IMatrixLike, IVector2Like } from \"core/Maths/math.like\";\r\nimport type { Tuple } from \"core/types\";\r\n\r\n/**\r\n * Represents a Babylon.js thin version of a Matrix\r\n * We are only exposing what we truly need in the scope of\r\n * the Lottie Renderer project preventing the dependency on the full\r\n * Babylon.js math system.\r\n */\r\nexport class ThinMatrix implements IMatrixLike {\r\n    /**\r\n     * Prevents global conflicts on update as shader programs are shared.\r\n     */\r\n    private static _UPDATE_FLAG_SEED = 0;\r\n\r\n    /**\r\n     * Current update flag used to know whether a Matrix has changed since previous render or not.\r\n     * This helps identifying if a Matrix needs to be\r\n     * uploaded to a shader program.\r\n     */\r\n    public updateFlag = -1;\r\n\r\n    private readonly _data: Float32Array;\r\n\r\n    /**\r\n     * Creates a new ThinMatrix instance.\r\n     */\r\n    public constructor() {\r\n        this._data = new Float32Array(16);\r\n    }\r\n\r\n    /**\r\n     * Set the matrix values.\r\n     * @param m11 Value for row 1, column 1\r\n     * @param m12 Value for row 1, column 2\r\n     * @param m13 Value for row 1, column 3\r\n     * @param m14 Value for row 1, column 4\r\n     * @param m21 Value for row 2, column 1\r\n     * @param m22 Value for row 2, column 2\r\n     * @param m23 Value for row 2, column 3\r\n     * @param m24 Value for row 2, column 4\r\n     * @param m31 Value for row 3, column 1\r\n     * @param m32 Value for row 3, column 2\r\n     * @param m33 Value for row 3, column 3\r\n     * @param m34 Value for row 3, column 4\r\n     * @param m41 Value for row 4, column 1\r\n     * @param m42 Value for row 4, column 2\r\n     * @param m43 Value for row 4, column 3\r\n     * @param m44 Value for row 4, column 4\r\n     * @returns The updated ThinMatrix instance\r\n     */\r\n    public setValues(\r\n        m11: number,\r\n        m12: number,\r\n        m13: number,\r\n        m14: number,\r\n        m21: number,\r\n        m22: number,\r\n        m23: number,\r\n        m24: number,\r\n        m31: number,\r\n        m32: number,\r\n        m33: number,\r\n        m34: number,\r\n        m41: number,\r\n        m42: number,\r\n        m43: number,\r\n        m44: number\r\n    ): ThinMatrix {\r\n        const m = this._data;\r\n        m[0] = m11;\r\n        m[1] = m12;\r\n        m[2] = m13;\r\n        m[3] = m14;\r\n        m[4] = m21;\r\n        m[5] = m22;\r\n        m[6] = m23;\r\n        m[7] = m24;\r\n        m[8] = m31;\r\n        m[9] = m32;\r\n        m[10] = m33;\r\n        m[11] = m34;\r\n        m[12] = m41;\r\n        m[13] = m42;\r\n        m[14] = m43;\r\n        m[15] = m44;\r\n\r\n        this.updateFlag = ThinMatrix._UPDATE_FLAG_SEED++;\r\n\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * Set the matrix to an identity matrix.\r\n     * @returns The updated ThinMatrix instance\r\n     */\r\n    public identity(): ThinMatrix {\r\n        this.setValues(1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1);\r\n\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * Stores a left-handed orthographic projection into a given matrix\r\n     * @param left defines the viewport left coordinate\r\n     * @param right defines the viewport right coordinate\r\n     * @param bottom defines the viewport bottom coordinate\r\n     * @param top defines the viewport top coordinate\r\n     * @param znear defines the near clip plane\r\n     * @param zfar defines the far clip plane\r\n     * @returns The updated ThinMatrix instance\r\n     */\r\n    public orthoOffCenterLeftHanded(left: number, right: number, bottom: number, top: number, znear: number, zfar: number): ThinMatrix {\r\n        const n = znear;\r\n        const f = zfar;\r\n\r\n        const a = 2.0 / (right - left);\r\n        const b = 2.0 / (top - bottom);\r\n        const c = 2.0 / (f - n);\r\n        const d = -(f + n) / (f - n);\r\n        const i0 = (left + right) / (left - right);\r\n        const i1 = (top + bottom) / (bottom - top);\r\n\r\n        this.setValues(a, 0.0, 0.0, 0.0, 0.0, b, 0.0, 0.0, 0.0, 0.0, c, 0.0, i0, i1, d, 1.0);\r\n\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * Sets a matrix to a value composed by merging scale (vector2), rotation (roll around z) and translation (vector2)\r\n     * This only updates the parts of the matrix that are used for 2D transformations.\r\n     * @param scale defines the scale vector\r\n     * @param roll defines the rotation around z\r\n     * @param translation defines the translation vector\r\n     * @returns the updated ThinMatrix instance\r\n     */\r\n    public compose(scale: IVector2Like, roll: number, translation: IVector2Like): ThinMatrix {\r\n        // Produces a quaternion from Euler angles in the z-y-x orientation (Tait-Bryan angles)\r\n        const halfRoll = roll * 0.5;\r\n        const z = Math.sin(halfRoll),\r\n            w = Math.cos(halfRoll);\r\n\r\n        const z2 = z + z;\r\n        const zz = z * z2;\r\n        const wz = w * z2;\r\n\r\n        const sx = scale.x,\r\n            sy = scale.y;\r\n\r\n        const m = this._data;\r\n        m[0] = (1 - zz) * sx;\r\n        m[1] = wz * sx;\r\n\r\n        m[4] = -wz * sy;\r\n        m[5] = (1 - zz) * sy;\r\n\r\n        m[12] = translation.x;\r\n        m[13] = translation.y;\r\n\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * Sets the current matrix with the multiplication result of the current Matrix and the given one\r\n     * This only updates the parts of the matrix that are used for 2D transformations.\r\n     * @param other defines the second operand\r\n     * @param output the matrix to store the result in\r\n     * @returns the current matrix\r\n     */\r\n    public multiplyToRef(other: ThinMatrix, output: ThinMatrix): ThinMatrix {\r\n        const m = this._data;\r\n        const otherM = other._data;\r\n\r\n        // Only calculate the values we actually use (2D transform)\r\n        const tm0 = m[0],\r\n            tm1 = m[1],\r\n            tm4 = m[4],\r\n            tm5 = m[5];\r\n        const tm12 = m[12],\r\n            tm13 = m[13];\r\n\r\n        const om0 = otherM[0],\r\n            om1 = otherM[1];\r\n        const om4 = otherM[4],\r\n            om5 = otherM[5];\r\n        const om12 = otherM[12],\r\n            om13 = otherM[13];\r\n\r\n        // Only update the 2D transformation parts\r\n        output._data[0] = tm0 * om0 + tm1 * om4;\r\n        output._data[1] = tm0 * om1 + tm1 * om5;\r\n        output._data[4] = tm4 * om0 + tm5 * om4;\r\n        output._data[5] = tm4 * om1 + tm5 * om5;\r\n        output._data[12] = tm12 * om0 + tm13 * om4 + om12;\r\n        output._data[13] = tm12 * om1 + tm13 * om5 + om13;\r\n\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * Returns the matrix data array.\r\n     * @returns The matrix data\r\n     */\r\n    public asArray(): Tuple<number, 16> {\r\n        return this._data as any as Tuple<number, 16>;\r\n    }\r\n\r\n    /**\r\n     * Decomposes the matrix into scale, rotation, and translation.\r\n     * @param scale Scale vector to store the scale values\r\n     * @param translation Translation vector to store the translation values\r\n     * @returns The rotation in radians\r\n     */\r\n    public decompose(scale: IVector2Like, translation: IVector2Like): number {\r\n        const m00 = this._data[0]; // scaleX * cos(θ)\r\n        const m01 = this._data[1]; // -scaleY * sin(θ)\r\n        const m10 = this._data[4]; // scaleX * sin(θ)\r\n        const m11 = this._data[5]; // scaleY * cos(θ)\r\n\r\n        // Extract scale\r\n        scale.x = Math.hypot(m00, m10); // sqrt(m00² + m10²)\r\n        scale.y = Math.hypot(m01, m11); // sqrt(m01² + m11²)\r\n\r\n        // Extract rotation (assumes uniform scaling or affine 2D)\r\n        const rotation = Math.atan2(m10, m00); // θ from the first column\r\n\r\n        // Extract the translation\r\n        translation.x = this._data[12];\r\n        translation.y = this._data[13];\r\n\r\n        return rotation;\r\n    }\r\n}\r\n"]}

package/lottie/rendering/animationController.d.ts

@@ -0,0 +1,72 @@
+import "@babylonjs/core/Engines/Extensions/engine.alpha.js";
+import "@babylonjs/core/Shaders/sprites.vertex.js";
+import "@babylonjs/core/Shaders/sprites.fragment.js";
+import type { AnimationConfiguration } from "../lottiePlayer.js";
+/**
+ * Class that controls the playing of lottie animations using Babylon.js
+ */
+export declare class AnimationController {
+    private _isReady;
+    private readonly _canvas;
+    private readonly _configuration;
+    private readonly _engine;
+    private readonly _spritePacker;
+    private _animation?;
+    private readonly _viewport;
+    private readonly _projectionMatrix;
+    private readonly _worldMatrix;
+    private _frameDuration;
+    private _currentFrame;
+    private _isPlaying;
+    private _animationFrameId;
+    private _lastFrameTime;
+    private _deltaTime;
+    private _loop;
+    private _accumulatedTime;
+    private _framesToAdvance;
+    private readonly _renderingManager;
+    /**
+     * Gets the canvas used for rendering the animation.
+     * @returns The canvas element used for rendering.
+     */
+    get view(): HTMLCanvasElement;
+    /**
+     * Gets the height of the animation in pixels.
+     * @returns The height of the animation in pixels.
+     */
+    get animationHeight(): number;
+    /**
+     * Gets the width of the animation in pixels.
+     * @returns The width of the animation in pixels.
+     */
+    get animationWidth(): number;
+    /**
+     * Creates a new instance of the Player.
+     * @param canvas The canvas element to render the animation on.
+     * @param animationJson The JSON string of the Lottie animation to be played.
+     * @param configuration The configuration for the animation player.
+     */
+    constructor(canvas: HTMLCanvasElement, animationJson: string, configuration: AnimationConfiguration);
+    /**
+     * Plays the animation.
+     * @param loop If true, the animation will loop when it reaches the end.
+     */
+    playAnimation(loop?: boolean): void;
+    /**
+     * Stops the animation playback.
+     */
+    stopAnimation(): void;
+    /**
+     * Sets the rendering size for the engine
+     * @param width Width of the rendering canvas
+     * @param height Height of the rendering canvas
+     */
+    setSize(width: number, height: number): void;
+    /**
+     * Disposes the player and releases all resources.
+     */
+    dispose(): void;
+    private _cleanTree;
+    private _startRenderLoop;
+    private _render;
+}