image-js 1.0.0-alpha.3 → 1.1.0

package/lib/geometry/getPerspectiveWarp.js

@@ -0,0 +1,131 @@
+import { Matrix, SingularValueDecomposition } from 'ml-matrix';
+// REFERENCES :
+// http://graphics.cs.cmu.edu/courses/15-463/2011_fall/Lectures/morphing.pdf
+/**
+ * Computes a perspective transformation matrix to rectify a quadrilateral region into a rectangle.
+ *
+ * This function takes four corner points of a quadrilateral (e.g., a document photographed at an angle) and calculates the transformation matrix needed to "unwarp" it into a rectangular image.
+ * The output dimensions can be specified or calculated automatically based on the input geometry.
+ * @param pts - 4 reference corners.
+ * @param options - PerspectiveWarpOptions.
+ * @returns - Matrix from 4 points.
+ */
+export function getPerspectiveWarp(pts, options = {}) {
+    if (pts.length !== 4) {
+        throw new Error(`The array pts must have four elements, which are the four corners. Currently, pts have ${pts.length} elements`);
+    }
+    const { width, height } = options;
+    const [tl, tr, br, bl] = order4Points(pts);
+    let widthRect;
+    let heightRect;
+    if (height && width) {
+        widthRect = width;
+        heightRect = height;
+    }
+    else if (!height && !width) {
+        widthRect = Math.ceil(Math.max(distance2Points(tl, tr), distance2Points(bl, br)));
+        heightRect = Math.ceil(Math.max(distance2Points(tl, bl), distance2Points(tr, br)));
+    }
+    else {
+        throw new Error(`Invalid dimensions: ${width ? '`height`' : '`width`'} is missing. ` +
+            `Either provide both width and height, or omit both to auto-calculate dimensions.`);
+    }
+    const [x1, y1] = [0, 0];
+    const [x2, y2] = [widthRect - 1, 0];
+    const [x3, y3] = [widthRect - 1, heightRect - 1];
+    const [x4, y4] = [0, heightRect - 1];
+    const S = new Matrix([
+        [x1, y1, 1, 0, 0, 0, -x1 * tl.column, -y1 * tl.column],
+        [x2, y2, 1, 0, 0, 0, -x2 * tr.column, -y2 * tr.column],
+        [x3, y3, 1, 0, 0, 0, -x3 * br.column, -y3 * br.column],
+        [x4, y4, 1, 0, 0, 0, -x4 * bl.column, -y4 * bl.column],
+        [0, 0, 0, x1, y1, 1, -x1 * tl.row, -y1 * tl.row],
+        [0, 0, 0, x2, y2, 1, -x2 * tr.row, -y2 * tr.row],
+        [0, 0, 0, x3, y3, 1, -x3 * br.row, -y3 * br.row],
+        [0, 0, 0, x4, y4, 1, -x4 * bl.row, -y4 * bl.row],
+    ]);
+    const D = Matrix.columnVector([
+        tl.column,
+        tr.column,
+        br.column,
+        bl.column,
+        tl.row,
+        tr.row,
+        br.row,
+        bl.row,
+    ]);
+    const svd = new SingularValueDecomposition(S);
+    const T = svd.solve(D).to1DArray(); // solve S*T = D
+    T.push(1);
+    const M = [];
+    for (let i = 0; i < 3; i++) {
+        const row = [];
+        for (let j = 0; j < 3; j++) {
+            row.push(T[i * 3 + j]);
+        }
+        M.push(row);
+    }
+    return { matrix: M, width: widthRect, height: heightRect };
+}
+/**
+ * Sorts 4 points in order =>[top-left,top-right,bottom-right,bottom-left]. Input points must be in clockwise or counter-clockwise order.
+ * @param pts - Array of 4 points.
+ * @returns Sorted array of 4 points.
+ */
+export function order4Points(pts) {
+    let tl;
+    let tr;
+    let br;
+    let bl;
+    let minX = pts[0].column;
+    let indexMinX = 0;
+    for (let i = 1; i < pts.length; i++) {
+        if (pts[i].column < minX) {
+            minX = pts[i].column;
+            indexMinX = i;
+        }
+    }
+    let minX2 = pts[(indexMinX + 1) % pts.length].column;
+    let indexMinX2 = (indexMinX + 1) % pts.length;
+    for (let i = 0; i < pts.length; i++) {
+        if (pts[i].column < minX2 && i !== indexMinX) {
+            minX2 = pts[i].column;
+            indexMinX2 = i;
+        }
+    }
+    if (pts[indexMinX2].row < pts[indexMinX].row) {
+        tl = pts[indexMinX2];
+        bl = pts[indexMinX];
+        if (indexMinX !== (indexMinX2 + 1) % 4) {
+            tr = pts[(indexMinX2 + 1) % 4];
+            br = pts[(indexMinX2 + 2) % 4];
+        }
+        else {
+            tr = pts[(indexMinX2 + 2) % 4];
+            br = pts[(indexMinX2 + 3) % 4];
+        }
+    }
+    else {
+        bl = pts[indexMinX2];
+        tl = pts[indexMinX];
+        if (indexMinX2 !== (indexMinX + 1) % 4) {
+            tr = pts[(indexMinX + 1) % 4];
+            br = pts[(indexMinX + 2) % 4];
+        }
+        else {
+            tr = pts[(indexMinX + 2) % 4];
+            br = pts[(indexMinX + 3) % 4];
+        }
+    }
+    return [tl, tr, br, bl];
+}
+/**
+ *  Calculates distance between points.
+ * @param p1 - Point1
+ * @param p2 - Point2
+ * @returns distance between points.
+ */
+function distance2Points(p1, p2) {
+    return Math.hypot(p1.column - p2.column, p1.row - p2.row);
+}
+//# sourceMappingURL=getPerspectiveWarp.js.map

package/lib/geometry/getPerspectiveWarp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPerspectiveWarp.js","sourceRoot":"","sources":["../../src/geometry/getPerspectiveWarp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAC;AAwB/D,eAAe;AACf,4EAA4E;AAC5E;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAChC,GAAY,EACZ,UAAqC,EAAE;IAEvC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,0FAA0F,GAAG,CAAC,MAAM,WAAW,CAChH,CAAC;IACJ,CAAC;IACD,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAClC,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAE3C,IAAI,SAAS,CAAC;IACd,IAAI,UAAU,CAAC;IACf,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;QACpB,SAAS,GAAG,KAAK,CAAC;QAClB,UAAU,GAAG,MAAM,CAAC;IACtB,CAAC;SAAM,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QAC7B,SAAS,GAAG,IAAI,CAAC,IAAI,CACnB,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,eAAe,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAC3D,CAAC;QACF,UAAU,GAAG,IAAI,CAAC,IAAI,CACpB,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,eAAe,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAC3D,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CACb,uBAAuB,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,eAAe;YAClE,kFAAkF,CACrF,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACxB,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,GAAG,CAAC,EAAE,UAAU,GAAG,CAAC,CAAC,CAAC;IACjD,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,CAAC,CAAC,CAAC;IAErC,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC;QACnB,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC;QACtD,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC;QACtD,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC;QACtD,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC;QACtD,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC;QAChD,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC;QAChD,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC;QAChD,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC;KACjD,CAAC,CAAC;IACH,MAAM,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC;QAC5B,EAAE,CAAC,MAAM;QACT,EAAE,CAAC,MAAM;QACT,EAAE,CAAC,MAAM;QACT,EAAE,CAAC,MAAM;QACT,EAAE,CAAC,GAAG;QACN,EAAE,CAAC,GAAG;QACN,EAAE,CAAC,GAAG;QACN,EAAE,CAAC,GAAG;KACP,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,IAAI,0BAA0B,CAAC,CAAC,CAAC,CAAC;IAC9C,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,gBAAgB;IACpD,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAEV,MAAM,CAAC,GAAG,EAAE,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,EAAE,CAAC;QACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACzB,CAAC;QACD,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACd,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,IAAI,EAAS,CAAC;IACd,IAAI,EAAS,CAAC;IACd,IAAI,EAAS,CAAC;IACd,IAAI,EAAS,CAAC;IAEd,IAAI,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACzB,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;YACzB,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YACrB,SAAS,GAAG,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;IAED,IAAI,KAAK,GAAG,GAAG,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;IACrD,IAAI,UAAU,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC;IAE9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,KAAK,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YAC7C,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YACtB,UAAU,GAAG,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IACD,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,CAAC;QAC7C,EAAE,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC;QACrB,EAAE,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC;QACpB,IAAI,SAAS,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YACvC,EAAE,GAAG,GAAG,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC/B,EAAE,GAAG,GAAG,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,EAAE,GAAG,GAAG,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC/B,EAAE,GAAG,GAAG,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;SAAM,CAAC;QACN,EAAE,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC;QACrB,EAAE,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC;QACpB,IAAI,UAAU,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YACvC,EAAE,GAAG,GAAG,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC9B,EAAE,GAAG,GAAG,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,EAAE,GAAG,GAAG,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC9B,EAAE,GAAG,GAAG,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IACD,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;AAC1B,CAAC;AACD;;;;;GAKG;AACH,SAAS,eAAe,CAAC,EAAS,EAAE,EAAS;IAC3C,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;AAC5D,CAAC"}

package/lib/geometry/index.d.ts

@@ -1,4 +1,7 @@
-export * from './transform';
-export * from './resize';
-export * from './rotate';
+export * from './resize.js';
+export * from './rotate.js';
+export * from './transform.js';
+export * from './transformRotate.js';
+export * from './getPerspectiveWarp.js';
+export type { Point } from '../utils/geometry/points.js';
 //# sourceMappingURL=index.d.ts.map

package/lib/geometry/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/geometry/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/geometry/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,YAAY,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC"}

package/lib/geometry/index.js

@@ -1,9 +1,6 @@
-"use strict";
-function __export(m) {
-    for (var p in m) if (!exports.hasOwnProperty(p)) exports[p] = m[p];
-}
-Object.defineProperty(exports, "__esModule", { value: true });
-__export(require("./transform"));
-__export(require("./resize"));
-__export(require("./rotate"));
+export * from './resize.js';
+export * from './rotate.js';
+export * from './transform.js';
+export * from './transformRotate.js';
+export * from './getPerspectiveWarp.js';
 //# sourceMappingURL=index.js.map

package/lib/geometry/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/geometry/index.ts"],"names":[],"mappings":";;;;;AAAA,iCAA4B;AAC5B,8BAAyB;AACzB,8BAAyB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/geometry/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC"}

package/lib/geometry/resize.d.ts

@@ -1,14 +1,49 @@
-import { Image } from '../Image';
-import { InterpolationType, BorderType } from '../types';
-export interface IResizeOptions {
-    width?: number;
-    height?: number;
-    xFactor?: number;
-    yFactor?: number;
-    preserveAspectRatio?: boolean;
-    interpolationType?: InterpolationType;
-    borderType?: BorderType;
-    borderValue?: number;
-}
-export declare function resize(image: Image, options: IResizeOptions): Image;
+import type { Image } from '../Image.js';
+import type { BorderType } from '../utils/interpolateBorder.js';
+import type { InterpolationType } from '../utils/interpolatePixel.js';
+export interface ResizeOptions {
+    /**
+     * Width of the output image.
+     */
+    width?: number;
+    /**
+     * Height of the output image.
+     */
+    height?: number;
+    /**
+     * Factor by which to scale the width.
+     */
+    xFactor?: number;
+    /**
+     * Factor by which to scale the width.
+     */
+    yFactor?: number;
+    /**
+     * Whether the aspect ratio of the image should be preserved.
+     * @default `true`
+     */
+    preserveAspectRatio?: boolean;
+    /**
+     * Method to use to interpolate the new pixels.
+     * @default `'bilinear'`
+     */
+    interpolationType?: InterpolationType;
+    /**
+     * Specify how the borders should be handled.
+     * @default `'constant'`
+     */
+    borderType?: BorderType;
+    /**
+     * Value of the border if BorderType is 'constant'.
+     * @default `0`
+     */
+    borderValue?: number;
+}
+/**
+ * Returns a resized copy of an image.
+ * @param image - Original image.
+ * @param options - Resize options.
+ * @returns The new image.
+ */
+export declare function resize(image: Image, options: ResizeOptions): Image;
 //# sourceMappingURL=resize.d.ts.map

package/lib/geometry/resize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resize.d.ts","sourceRoot":"","sources":["../../src/geometry/resize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAKzD,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,GAAG,KAAK,CAkCnE"}
+{"version":3,"file":"resize.d.ts","sourceRoot":"","sources":["../../src/geometry/resize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAKtE,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC;;;OAGG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,GAAG,KAAK,CAsBlE"}

package/lib/geometry/resize.js

@@ -1,91 +1,87 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const Image_1 = require("../Image");
-const types_1 = require("../types");
-const interpolatePixel_1 = require("../utils/interpolatePixel");
-const interpolateBorder_1 = require("../utils/interpolateBorder");
-const clamp_1 = require("../utils/clamp");
-function resize(image, options) {
-    const { interpolationType = types_1.InterpolationType.BILINEAR, borderType = types_1.BorderType.CONSTANT, borderValue = 0 } = options;
-    const { width, height } = checkOptions(image, options);
-    const newImage = Image_1.Image.createFrom(image, { width, height });
-    const interpolate = interpolatePixel_1.getInterpolationFunction(interpolationType);
-    const interpolateBorder = interpolateBorder_1.getBorderInterpolation(borderType, borderValue);
-    const clamp = clamp_1.getClamp(newImage);
-    const hFactor = newImage.width * newImage.channels;
-    const intervalX = (image.width - 1) / (width - 1);
-    const intervalY = (image.height - 1) / (height - 1);
-    for (let y = 0; y < newImage.height; y++) {
-        const hOffset = hFactor * y;
-        for (let x = 0; x < newImage.width; x++) {
-            const wOffset = hOffset + x * image.channels;
-            const nx = x * intervalX;
-            const ny = y * intervalY;
-            for (let c = 0; c < newImage.channels; c++) {
-                const newValue = interpolate(image, nx, ny, c, interpolateBorder, clamp);
-                newImage.data[wOffset + c] = newValue;
-            }
-        }
-    }
-    return newImage;
-}
-exports.resize = resize;
-function checkOptions(image, options) {
-    const { width, height, xFactor, yFactor, preserveAspectRatio = true } = options;
-    if (width === undefined &&
-        height === undefined &&
-        xFactor === undefined &&
-        yFactor === undefined) {
-        throw new Error('At least one of the width, height, xFactor or yFactor options must be passed');
-    }
-    let newWidth;
-    let newHeight;
-    const maybeWidth = getSize(width, xFactor, image.width, preserveAspectRatio);
-    const maybeHeight = getSize(height, yFactor, image.height, preserveAspectRatio);
-    if (maybeWidth === undefined) {
-        if (maybeHeight !== undefined) {
-            newWidth = Math.round(maybeHeight * (image.width / image.height));
-        }
-        else {
-            throw new Error('UNREACHABLE');
-        }
-    }
-    else {
-        newWidth = maybeWidth;
-    }
-    if (maybeHeight === undefined) {
-        if (maybeWidth !== undefined) {
-            newHeight = Math.round(maybeWidth * (image.height / image.width));
-        }
-        else {
-            throw new Error('UNREACHABLE');
-        }
-    }
-    else {
-        newHeight = maybeHeight;
-    }
-    return {
-        width: newWidth,
-        height: newHeight,
-        xFactor: xFactor ? xFactor : newWidth / image.width,
-        yFactor: yFactor ? yFactor : newHeight / image.height
-    };
-}
-function getSize(sizeOpt, factor, sizeImg, preserveAspectRatio) {
-    if (sizeOpt === undefined) {
-        if (factor !== undefined) {
-            return Math.round(sizeImg * factor);
-        }
-        else if (!preserveAspectRatio) {
-            return sizeImg;
-        }
-    }
-    else if (factor !== undefined) {
-        throw new Error('factor must not be passed with size');
-    }
-    else {
-        return sizeOpt;
-    }
-    return undefined;
-}
+import { assert } from '../utils/validators/assert.js';
+import { transform } from './transform.js';
+/**
+ * Returns a resized copy of an image.
+ * @param image - Original image.
+ * @param options - Resize options.
+ * @returns The new image.
+ */
+export function resize(image, options) {
+    const { interpolationType = 'bilinear', borderType = 'replicate', borderValue = 0, } = options;
+    const { width, height, xFactor, yFactor } = checkOptions(image, options);
+    return transform(image, [
+        [xFactor, 0, xFactor / 2],
+        [0, yFactor, yFactor / 2],
+    ], {
+        interpolationType,
+        borderType,
+        borderValue,
+        height,
+        width,
+    });
+}
+/**
+ * Verify that the resize options are valid.
+ * @param image - Image.
+ * @param options - Resize options.
+ * @returns Resize options.
+ */
+function checkOptions(image, options) {
+    const { width, height, xFactor, yFactor, preserveAspectRatio = true, } = options;
+    if (width === undefined &&
+        height === undefined &&
+        xFactor === undefined &&
+        yFactor === undefined) {
+        throw new TypeError('at least one of the width, height, xFactor or yFactor options must be passed');
+    }
+    let newWidth;
+    let newHeight;
+    const maybeWidth = getSize(width, xFactor, image.width, preserveAspectRatio);
+    const maybeHeight = getSize(height, yFactor, image.height, preserveAspectRatio);
+    if (maybeWidth === undefined) {
+        assert(maybeHeight !== undefined);
+        newWidth = Math.round(maybeHeight * (image.width / image.height));
+    }
+    else {
+        newWidth = maybeWidth;
+    }
+    if (maybeHeight === undefined) {
+        assert(maybeWidth !== undefined);
+        newHeight = Math.round(maybeWidth * (image.height / image.width));
+    }
+    else {
+        newHeight = maybeHeight;
+    }
+    return {
+        width: newWidth,
+        height: newHeight,
+        xFactor: xFactor ?? newWidth / image.width,
+        yFactor: yFactor ?? newHeight / image.height,
+    };
+}
+/**
+ * Compute automatic new size.
+ * @param sizeOpt - Size option.
+ * @param factor - Factor option.
+ * @param sizeImg - Size of the image.
+ * @param preserveAspectRatio - Whether to preserve the aspect ratio.
+ * @returns New size.
+ */
+function getSize(sizeOpt, factor, sizeImg, preserveAspectRatio) {
+    if (sizeOpt === undefined) {
+        if (factor !== undefined) {
+            return Math.round(sizeImg * factor);
+        }
+        else if (!preserveAspectRatio) {
+            return sizeImg;
+        }
+    }
+    else if (factor !== undefined) {
+        throw new TypeError('factor and size cannot be passed together');
+    }
+    else {
+        return sizeOpt;
+    }
+    return undefined;
+}
 //# sourceMappingURL=resize.js.map

package/lib/geometry/resize.js.map

@@ -1 +1 @@
-{"version":3,"file":"resize.js","sourceRoot":"","sources":["../../src/geometry/resize.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"resize.js","sourceRoot":"","sources":["../../src/geometry/resize.ts"],"names":[],"mappings":"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"}

package/lib/geometry/rotate.d.ts

@@ -1,14 +1,10 @@
-import { Image, ImageCoordinates } from '../Image';
-import { InterpolationType, BorderType } from '../types';
-export interface IRotateOptions {
-    center?: ImageCoordinates | [number, number];
-    scale?: number;
-    width?: number;
-    height?: number;
-    fullImage?: boolean;
-    interpolationType?: InterpolationType;
-    borderType?: BorderType;
-    borderValue?: number;
-}
-export declare function rotate(image: Image, angle: number, options?: IRotateOptions): Image;
+import { Image } from '../Image.js';
+export type RotateAngle = 90 | 180 | 270 | -90 | -180 | -270;
+/**
+ * Rotates an image in multiples of 90 degrees.
+ * @param image - The image to rotate.
+ * @param angle - The angle to rotate the image by. Positive values rotate clockwise, negative values rotate counter-clockwise.
+ * @returns - The rotated image.
+ */
+export declare function rotate(image: Image, angle: RotateAngle): Image;
 //# sourceMappingURL=rotate.d.ts.map

package/lib/geometry/rotate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rotate.d.ts","sourceRoot":"","sources":["../../src/geometry/rotate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAIzD,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAKhB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,MAAM,CACpB,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,cAAmB,GAC3B,KAAK,CAYP"}
+{"version":3,"file":"rotate.d.ts","sourceRoot":"","sources":["../../src/geometry/rotate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,MAAM,MAAM,WAAW,GAAG,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC;AAE7D;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,GAAG,KAAK,CAoD9D"}

package/lib/geometry/rotate.js

@@ -1,27 +1,47 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const Image_1 = require("../Image");
-const transform_1 = require("./transform");
-function rotate(image, angle, options = {}) {
-    const { center = Image_1.ImageCoordinates.CENTER, scale = 1 } = options;
-    let centerCoordinates;
-    if (typeof center === 'string') {
-        centerCoordinates = image.getCoordinates(center);
-    }
-    else {
-        centerCoordinates = center;
-    }
-    const transformMatrix = getRotationMatrix(angle, centerCoordinates, scale);
-    return transform_1.transform(image, transformMatrix, options);
-}
-exports.rotate = rotate;
-function getRotationMatrix(angle, center, scale) {
-    const angleRadians = (angle * Math.PI) / 180;
-    const alpha = scale * Math.cos(angleRadians);
-    const beta = scale * Math.sin(angleRadians);
-    return [
-        [alpha, beta, (1 - alpha) * center[0] - beta * center[1]],
-        [-beta, alpha, beta * center[0] + (1 - alpha) * center[1]]
-    ];
-}
+import { Image } from '../Image.js';
+/**
+ * Rotates an image in multiples of 90 degrees.
+ * @param image - The image to rotate.
+ * @param angle - The angle to rotate the image by. Positive values rotate clockwise, negative values rotate counter-clockwise.
+ * @returns - The rotated image.
+ */
+export function rotate(image, angle) {
+    const newWidth = angle % 180 === 0 ? image.width : image.height;
+    const newHeight = angle % 180 === 0 ? image.height : image.width;
+    const newImage = Image.createFrom(image, {
+        width: newWidth,
+        height: newHeight,
+    });
+    if (angle === 90 || angle === -270) {
+        for (let column = 0; column < image.width; column++) {
+            for (let row = 0; row < image.height; row++) {
+                for (let channel = 0; channel < image.channels; channel++) {
+                    newImage.setValue(newImage.width - row - 1, column, channel, image.getValue(column, row, channel));
+                }
+            }
+        }
+    }
+    else if (angle === 180 || angle === -180) {
+        for (let column = 0; column < image.width; column++) {
+            for (let row = 0; row < image.height; row++) {
+                for (let channel = 0; channel < image.channels; channel++) {
+                    newImage.setValue(newImage.width - column - 1, newImage.height - row - 1, channel, image.getValue(column, row, channel));
+                }
+            }
+        }
+    }
+    else if (angle === 270 || angle === -90) {
+        for (let column = 0; column < image.width; column++) {
+            for (let row = 0; row < image.height; row++) {
+                for (let channel = 0; channel < image.channels; channel++) {
+                    newImage.setValue(row, newImage.height - column - 1, channel, image.getValue(column, row, channel));
+                }
+            }
+        }
+    }
+    else {
+        throw new RangeError(`invalid angle: ${angle}`);
+    }
+    return newImage;
+}
 //# sourceMappingURL=rotate.js.map

package/lib/geometry/rotate.js.map

@@ -1 +1 @@
-{"version":3,"file":"rotate.js","sourceRoot":"","sources":["../../src/geometry/rotate.ts"],"names":[],"mappings":";;AAAA,oCAAmD;AAGnD,2CAAwC;AAiBxC,SAAgB,MAAM,CACpB,KAAY,EACZ,KAAa,EACb,UAA0B,EAAE;IAE5B,MAAM,EAAE,MAAM,GAAG,wBAAgB,CAAC,MAAM,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC;IAEhE,IAAI,iBAAiB,CAAC;IACtB,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;QAC9B,iBAAiB,GAAG,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;KAClD;SAAM;QACL,iBAAiB,GAAG,MAAM,CAAC;KAC5B;IACD,MAAM,eAAe,GAAG,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,EAAE,KAAK,CAAC,CAAC;IAE3E,OAAO,qBAAS,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;AACpD,CAAC;AAhBD,wBAgBC;AAED,SAAS,iBAAiB,CACxB,KAAa,EACb,MAAwB,EACxB,KAAa;IAEb,MAAM,YAAY,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;IAC7C,MAAM,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC5C,OAAO;QACL,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACzD,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;KAC3D,CAAC;AACJ,CAAC"}
+{"version":3,"file":"rotate.js","sourceRoot":"","sources":["../../src/geometry/rotate.ts"],"names":[],"mappings":"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"}

package/lib/geometry/transform.d.ts

@@ -1,13 +1,46 @@
-import { Image } from '../Image';
-import { InterpolationType, BorderType } from '../types';
-export interface ITransformOptions {
-    width?: number;
-    height?: number;
-    interpolationType?: InterpolationType;
-    borderType?: BorderType;
-    inverse?: boolean;
-    borderValue?: number;
-    fullImage?: boolean;
-}
-export declare function transform(image: Image, transformMatrix: number[][], options?: ITransformOptions): Image;
+import { Image } from '../Image.js';
+import type { BorderType } from '../utils/interpolateBorder.js';
+import type { InterpolationType } from '../utils/interpolatePixel.js';
+export interface TransformOptions {
+    /**
+     * Width of the output image.
+     */
+    width?: number;
+    /**
+     * Height of the output image.
+     */
+    height?: number;
+    /**
+     * Method to use to interpolate the new pixels.
+     * @default `'bilinear'`
+     */
+    interpolationType?: InterpolationType;
+    /**
+     * Specify how the borders should be handled.
+     * @default `'constant'`
+     */
+    borderType?: BorderType;
+    /**
+     * Value of the border if BorderType is 'constant'.
+     *  @default `0`
+     */
+    borderValue?: number;
+    /**
+     * Whether the transform matrix should be inverted.
+     */
+    inverse?: boolean;
+    /**
+     * Bypasses width and height options to include
+     * every pixel of the original image inside the transformed image.
+     */
+    fullImage?: boolean;
+}
+/**
+ * Transforms an image using a matrix.
+ * @param image - Original image.
+ * @param transformMatrix - 2×3 transform matrix.
+ * @param options - Transform options.
+ * @returns The new image.
+ */
+export declare function transform(image: Image, transformMatrix: number[][], options?: TransformOptions): Image;
 //# sourceMappingURL=transform.d.ts.map