image-js 1.0.0-alpha.3 → 1.0.0

package/lib/operations/index.js

@@ -1,11 +1,17 @@
-"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("./convertColor"));
-__export(require("./convertDepth"));
-__export(require("./merge"));
-__export(require("./split"));
-__export(require("./threshold"));
+export * from './convertColor.js';
+export * from './convertBitDepth.js';
+export * from './extract.js';
+export * from './merge.js';
+export * from './split.js';
+export * from './threshold.js';
+export * from './grey.js';
+export * from './copyTo.js';
+export * from './crop.js';
+export * from './cropAlpha.js';
+export * from './cropRectangle.js';
+export * from './operations.types.js';
+export * from './paintMaskOnImage.js';
+export * from './paintMaskOnMask.js';
+export * from './correctBackground.js';
+export * from './extendBorders.js';
 //# sourceMappingURL=index.js.map

package/lib/operations/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/operations/index.ts"],"names":[],"mappings":";;;;;AAAA,oCAA+B;AAC/B,oCAA+B;AAC/B,6BAAwB;AACxB,6BAAwB;AACxB,iCAA4B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/operations/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC"}

package/lib/operations/merge.d.ts

@@ -1,7 +1,8 @@
-import { Image } from '../Image';
-/**
- * Inverse of split. Merges multiple single-channel images into one.
- * @param images An array of single-channel images
- */
-export declare function merge(images: Image[]): Image;
+import { Image } from '../Image.js';
+/**
+ * Inverse of split. Merges multiple single-channel images into one.
+ * @param images - An array of single-channel images.
+ * @returns The merged image.
+ */
+export declare function merge(images: Image[]): Image;
 //# sourceMappingURL=merge.d.ts.map

package/lib/operations/merge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../src/operations/merge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAa,MAAM,UAAU,CAAC;AAE5C;;;GAGG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CA2C5C"}
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../src/operations/merge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAyD5C"}

package/lib/operations/merge.js

@@ -1,48 +1,51 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const Image_1 = require("../Image");
-/**
- * Inverse of split. Merges multiple single-channel images into one.
- * @param images An array of single-channel images
- */
-function merge(images) {
-    const channels = images.length;
-    let kind;
-    if (channels === 2) {
-        kind = Image_1.ImageKind.GREYA;
-    }
-    else if (channels === 3) {
-        kind = Image_1.ImageKind.RGB;
-    }
-    else if (channels === 4) {
-        kind = Image_1.ImageKind.RGBA;
-    }
-    else {
-        throw new RangeError(`merge expects an array of two to four images. Got ${channels}`);
-    }
-    const first = images[0];
-    if (first.channels !== 1) {
-        throw new Error(`each image must have one channel. Got ${first.channels}`);
-    }
-    for (let i = 1; i < channels; i++) {
-        const img = images[i];
-        if (img.channels !== 1) {
-            throw new Error(`each image must have one channel. Got ${img.channels}`);
-        }
-        if (img.width !== first.width ||
-            img.height !== first.height ||
-            img.depth !== first.depth) {
-            throw new Error('all images must have the same width, height and depth');
-        }
-    }
-    const newImage = Image_1.Image.createFrom(first, { kind });
-    for (let c = 0; c < channels; c++) {
-        const img = images[c];
-        for (let i = 0; i < newImage.data.length; i += channels) {
-            newImage.data[i + c] = img.data[i / channels];
-        }
-    }
-    return newImage;
-}
-exports.merge = merge;
+import { Image } from '../Image.js';
+/**
+ * Inverse of split. Merges multiple single-channel images into one.
+ * @param images - An array of single-channel images.
+ * @returns The merged image.
+ */
+export function merge(images) {
+    const channels = images.length;
+    let colorModel;
+    switch (channels) {
+        case 2: {
+            colorModel = 'GREYA';
+            break;
+        }
+        case 3: {
+            colorModel = 'RGB';
+            break;
+        }
+        case 4: {
+            colorModel = 'RGBA';
+            break;
+        }
+        default: {
+            throw new RangeError(`merge expects an array of two to four images. Received ${channels}`);
+        }
+    }
+    const first = images[0];
+    if (first.channels !== 1) {
+        throw new RangeError(`each image must have one channel. Received ${first.channels}`);
+    }
+    for (let i = 1; i < channels; i++) {
+        const img = images[i];
+        if (img.channels !== 1) {
+            throw new RangeError(`each image must have one channel. Received ${img.channels}`);
+        }
+        if (img.width !== first.width ||
+            img.height !== first.height ||
+            img.bitDepth !== first.bitDepth) {
+            throw new RangeError('all images must have the same width, height and bitDepth');
+        }
+    }
+    const newImage = Image.createFrom(first, { colorModel });
+    for (let c = 0; c < channels; c++) {
+        const img = images[c];
+        for (let i = 0; i < newImage.size; i++) {
+            newImage.setValueByIndex(i, c, img.getValueByIndex(i, 0));
+        }
+    }
+    return newImage;
+}
 //# sourceMappingURL=merge.js.map

package/lib/operations/merge.js.map

@@ -1 +1 @@
-{"version":3,"file":"merge.js","sourceRoot":"","sources":["../../src/operations/merge.ts"],"names":[],"mappings":";;AAAA,oCAA4C;AAE5C;;;GAGG;AACH,SAAgB,KAAK,CAAC,MAAe;IACnC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC;IAE/B,IAAI,IAAe,CAAC;IACpB,IAAI,QAAQ,KAAK,CAAC,EAAE;QAClB,IAAI,GAAG,iBAAS,CAAC,KAAK,CAAC;KACxB;SAAM,IAAI,QAAQ,KAAK,CAAC,EAAE;QACzB,IAAI,GAAG,iBAAS,CAAC,GAAG,CAAC;KACtB;SAAM,IAAI,QAAQ,KAAK,CAAC,EAAE;QACzB,IAAI,GAAG,iBAAS,CAAC,IAAI,CAAC;KACvB;SAAM;QACL,MAAM,IAAI,UAAU,CAClB,qDAAqD,QAAQ,EAAE,CAChE,CAAC;KACH;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC,EAAE;QACxB,MAAM,IAAI,KAAK,CAAC,yCAAyC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;KAC5E;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE;QACjC,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,GAAG,CAAC,QAAQ,KAAK,CAAC,EAAE;YACtB,MAAM,IAAI,KAAK,CAAC,yCAAyC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;SAC1E;QACD,IACE,GAAG,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK;YACzB,GAAG,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;YAC3B,GAAG,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,EACzB;YACA,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;SAC1E;KACF;IAED,MAAM,QAAQ,GAAG,aAAK,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE;QACjC,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,QAAQ,EAAE;YACvD,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC;SAC/C;KACF;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AA3CD,sBA2CC"}
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../../src/operations/merge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC;;;;GAIG;AACH,MAAM,UAAU,KAAK,CAAC,MAAe;IACnC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC;IAE/B,IAAI,UAA2B,CAAC;IAChC,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,CAAC,CAAC,CAAC,CAAC;YACP,UAAU,GAAG,OAAO,CAAC;YACrB,MAAM;QACR,CAAC;QACD,KAAK,CAAC,CAAC,CAAC,CAAC;YACP,UAAU,GAAG,KAAK,CAAC;YACnB,MAAM;QACR,CAAC;QACD,KAAK,CAAC,CAAC,CAAC,CAAC;YACP,UAAU,GAAG,MAAM,CAAC;YACpB,MAAM;QACR,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,IAAI,UAAU,CAClB,0DAA0D,QAAQ,EAAE,CACrE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,UAAU,CAClB,8CAA8C,KAAK,CAAC,QAAQ,EAAE,CAC/D,CAAC;IACJ,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,GAAG,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,UAAU,CAClB,8CAA8C,GAAG,CAAC,QAAQ,EAAE,CAC7D,CAAC;QACJ,CAAC;QACD,IACE,GAAG,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK;YACzB,GAAG,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;YAC3B,GAAG,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,EAC/B,CAAC;YACD,MAAM,IAAI,UAAU,CAClB,0DAA0D,CAC3D,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;IACzD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,QAAQ,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/lib/operations/operations.types.d.ts

@@ -0,0 +1,7 @@
+export interface CropAlphaOptions {
+    /**
+     * Threshold from which rows and columns should be kept.
+     */
+    threshold?: number;
+}
+//# sourceMappingURL=operations.types.d.ts.map

package/lib/operations/operations.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.types.d.ts","sourceRoot":"","sources":["../../src/operations/operations.types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/lib/operations/operations.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=operations.types.js.map

package/lib/operations/operations.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.types.js","sourceRoot":"","sources":["../../src/operations/operations.types.ts"],"names":[],"mappings":""}

package/lib/operations/paintMaskOnImage.d.ts

@@ -0,0 +1,33 @@
+import type { Image } from '../Image.js';
+import type { Mask } from '../Mask.js';
+import type { Point } from '../utils/geometry/points.js';
+export interface PaintMaskOnImageOptions {
+    /**
+     * Top-left corner of the mask relative to a parent image.
+     * @default `{row: 0, column: 0}`
+     */
+    origin?: Point;
+    /**
+     * Color with which to blend the image pixel.
+     * @default Opaque black.
+     */
+    color?: Array<number | null>;
+    /**
+     * Whether the given color should be blended with the original pixel.
+     * @default `true`
+     */
+    blend?: boolean;
+    /**
+     * Image to which to output.
+     */
+    out?: Image;
+}
+/**
+ * Paint a mask onto an image and the given position and with the given color.
+ * @param image - Image on which to paint the mask.
+ * @param mask - Mask to paint on the image.
+ * @param options - Paint mask options.
+ * @returns The painted image.
+ */
+export declare function paintMaskOnImage(image: Image, mask: Mask, options?: PaintMaskOnImageOptions): Image;
+//# sourceMappingURL=paintMaskOnImage.d.ts.map

package/lib/operations/paintMaskOnImage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paintMaskOnImage.d.ts","sourceRoot":"","sources":["../../src/operations/paintMaskOnImage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAMzD,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC;IACf;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7B;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;OAEG;IACH,GAAG,CAAC,EAAE,KAAK,CAAC;CACb;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,IAAI,EACV,OAAO,GAAE,uBAA4B,GACpC,KAAK,CAyDP"}

package/lib/operations/paintMaskOnImage.js

@@ -0,0 +1,53 @@
+import { getDefaultColor } from '../utils/getDefaultColor.js';
+import { getOutputImage } from '../utils/getOutputImage.js';
+import { setBlendedPixel } from '../utils/setBlendedPixel.js';
+import { checkPointIsInteger } from '../utils/validators/checkPointIsInteger.js';
+/**
+ * Paint a mask onto an image and the given position and with the given color.
+ * @param image - Image on which to paint the mask.
+ * @param mask - Mask to paint on the image.
+ * @param options - Paint mask options.
+ * @returns The painted image.
+ */
+export function paintMaskOnImage(image, mask, options = {}) {
+    const { origin = { row: 0, column: 0 }, color = getDefaultColor(image), blend = true, } = options;
+    const { column, row } = origin;
+    if (color.length !== image.channels) {
+        throw new RangeError('the given color is not compatible with the image');
+    }
+    checkPointIsInteger(origin, 'Origin');
+    const result = getOutputImage(image, options, { clone: true });
+    if (blend) {
+        checkColorIsNumberArray(color);
+        for (let currentRow = Math.max(row, 0); currentRow < Math.min(mask.height + row, image.height); currentRow++) {
+            for (let currentColumn = Math.max(column, 0); currentColumn < Math.min(mask.width + column, image.width); currentColumn++) {
+                if (mask.getBit(currentColumn - column, currentRow - row)) {
+                    setBlendedPixel(result, currentColumn, currentRow, color);
+                }
+            }
+        }
+    }
+    else {
+        for (let currentRow = Math.max(row, 0); currentRow < Math.min(mask.height + row, image.height); currentRow++) {
+            for (let currentColumn = Math.max(column, 0); currentColumn < Math.min(mask.width + column, image.width); currentColumn++) {
+                if (mask.getBit(currentColumn - column, currentRow - row)) {
+                    for (let channel = 0; channel < image.channels; channel++) {
+                        const currentValue = color[channel];
+                        if (typeof currentValue === 'number') {
+                            result.setValue(currentColumn, currentRow, channel, currentValue);
+                        }
+                    }
+                }
+            }
+        }
+    }
+    return result;
+}
+function checkColorIsNumberArray(color) {
+    for (const channel of color) {
+        if (typeof channel !== 'number') {
+            throw new TypeError('cannot have null channels in color if blend is true');
+        }
+    }
+}
+//# sourceMappingURL=paintMaskOnImage.js.map

package/lib/operations/paintMaskOnImage.js.map

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

package/lib/operations/paintMaskOnMask.d.ts

@@ -0,0 +1,27 @@
+import type { BitValue, Mask } from '../Mask.js';
+import type { Point } from '../utils/geometry/points.js';
+export interface PaintMaskOnMaskOptions {
+    /**
+     * Top-left corner of the mask relative to a parent image.
+     * @default `{row: 0, column: 0}`
+     */
+    origin?: Point;
+    /**
+     * Value with which to set the pixel.
+     * @default `1`
+     */
+    value?: BitValue;
+    /**
+     * Mask to which to output.
+     */
+    out?: Mask;
+}
+/**
+ * Paint a mask onto an image and the given position and with the given color.
+ * @param image - Image on which to paint the mask.
+ * @param mask - Mask to paint on the image.
+ * @param options - Paint mask options.
+ * @returns The painted image.
+ */
+export declare function paintMaskOnMask(image: Mask, mask: Mask, options?: PaintMaskOnMaskOptions): Mask;
+//# sourceMappingURL=paintMaskOnMask.d.ts.map

package/lib/operations/paintMaskOnMask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paintMaskOnMask.d.ts","sourceRoot":"","sources":["../../src/operations/paintMaskOnMask.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAIzD,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC;IACf;;;OAGG;IACH,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB;;OAEG;IACH,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,IAAI,EACX,IAAI,EAAE,IAAI,EACV,OAAO,GAAE,sBAA2B,GACnC,IAAI,CAyBN"}

package/lib/operations/paintMaskOnMask.js

@@ -0,0 +1,24 @@
+import { maskToOutputMask } from '../utils/getOutputImage.js';
+import { checkPointIsInteger } from '../utils/validators/checkPointIsInteger.js';
+/**
+ * Paint a mask onto an image and the given position and with the given color.
+ * @param image - Image on which to paint the mask.
+ * @param mask - Mask to paint on the image.
+ * @param options - Paint mask options.
+ * @returns The painted image.
+ */
+export function paintMaskOnMask(image, mask, options = {}) {
+    const { origin = { row: 0, column: 0 }, value = 1 } = options;
+    const { column, row } = origin;
+    checkPointIsInteger(origin, 'Origin');
+    const result = maskToOutputMask(image, options, { clone: true });
+    for (let currentRow = Math.max(row, 0); currentRow < Math.min(mask.height + row, image.height); currentRow++) {
+        for (let currentColumn = Math.max(column, 0); currentColumn < Math.min(mask.width + column, image.width); currentColumn++) {
+            if (mask.getBit(currentColumn - column, currentRow - row)) {
+                result.setBit(currentColumn, currentRow, value);
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=paintMaskOnMask.js.map

package/lib/operations/paintMaskOnMask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paintMaskOnMask.js","sourceRoot":"","sources":["../../src/operations/paintMaskOnMask.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AAmBjF;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAW,EACX,IAAU,EACV,UAAkC,EAAE;IAEpC,MAAM,EAAE,MAAM,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC;IAC9D,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC;IAE/B,mBAAmB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAEtC,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAEjE,KACE,IAAI,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,EACjC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,EACtD,UAAU,EAAE,EACZ,CAAC;QACD,KACE,IAAI,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,EACvC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,EAC1D,aAAa,EAAE,EACf,CAAC;YACD,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,GAAG,MAAM,EAAE,UAAU,GAAG,GAAG,CAAC,EAAE,CAAC;gBAC1D,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/lib/operations/split.d.ts

@@ -1,3 +1,8 @@
-import { Image } from '../Image';
-export declare function split(image: Image): Image[];
+import { Image } from '../Image.js';
+/**
+ * Create an array of single-channel images based on a multi-channel image.
+ * @param image - The image with many channels.
+ * @returns Array of single-channel images.
+ */
+export declare function split(image: Image): Image[];
 //# sourceMappingURL=split.d.ts.map

package/lib/operations/split.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"split.d.ts","sourceRoot":"","sources":["../../src/operations/split.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAa,MAAM,UAAU,CAAC;AAE5C,wBAAgB,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,EAAE,CAU3C"}
+{"version":3,"file":"split.d.ts","sourceRoot":"","sources":["../../src/operations/split.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,EAAE,CAY3C"}

package/lib/operations/split.js

@@ -1,16 +1,20 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const Image_1 = require("../Image");
-function split(image) {
-    const result = [];
-    for (let c = 0; c < image.channels; c++) {
-        const channel = Image_1.Image.createFrom(image, { kind: Image_1.ImageKind.GREY });
-        for (let i = 0; i < channel.data.length; i++) {
-            channel.data[i] = image.data[i * image.channels + c];
-        }
-        result.push(channel);
-    }
-    return result;
-}
-exports.split = split;
+import { Image } from '../Image.js';
+/**
+ * Create an array of single-channel images based on a multi-channel image.
+ * @param image - The image with many channels.
+ * @returns Array of single-channel images.
+ */
+export function split(image) {
+    const result = [];
+    for (let c = 0; c < image.channels; c++) {
+        const channel = Image.createFrom(image, {
+            colorModel: 'GREY',
+        });
+        for (let i = 0; i < channel.size; i++) {
+            channel.setValueByIndex(i, 0, image.getValueByIndex(i, c));
+        }
+        result.push(channel);
+    }
+    return result;
+}
 //# sourceMappingURL=split.js.map

package/lib/operations/split.js.map

@@ -1 +1 @@
-{"version":3,"file":"split.js","sourceRoot":"","sources":["../../src/operations/split.ts"],"names":[],"mappings":";;AAAA,oCAA4C;AAE5C,SAAgB,KAAK,CAAC,KAAY;IAChC,MAAM,MAAM,GAAG,EAAE,CAAC;IAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE;QACvC,MAAM,OAAO,GAAG,aAAK,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,iBAAS,CAAC,IAAI,EAAE,CAAC,CAAC;QAClE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;SACtD;QACD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;KACtB;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAVD,sBAUC"}
+{"version":3,"file":"split.js","sourceRoot":"","sources":["../../src/operations/split.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC;;;;GAIG;AACH,MAAM,UAAU,KAAK,CAAC,KAAY;IAChC,MAAM,MAAM,GAAG,EAAE,CAAC;IAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE;YACtC,UAAU,EAAE,MAAM;SACnB,CAAC,CAAC;QACH,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,OAAO,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7D,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/lib/operations/threshold.d.ts

@@ -1,19 +1,61 @@
-import { Image } from '../Image';
-export declare enum ThresholdAlgorithm {
-    OTSU = "OTSU",
-    TRIANGLE = "TRIANGLE"
-}
-interface IThresholdOptionsBase {
-    out?: Image;
-}
-export interface IThresholdOptionsThreshold extends IThresholdOptionsBase {
-    threshold: number;
-}
-export interface IThresholdOptionsAlgorithm extends IThresholdOptionsBase {
-    algorithm: ThresholdAlgorithm;
-}
-export declare type ThresholdOptions = IThresholdOptionsThreshold | IThresholdOptionsAlgorithm;
-export declare function computeThreshold(image: Image, algorithm: ThresholdAlgorithm): number;
-export declare function threshold(image: Image, options: ThresholdOptions): Image;
-export {};
+import type { Image } from '../Image.js';
+import type { Mask } from '../Mask.js';
+export declare const ThresholdAlgorithm: {
+    readonly HUANG: "huang";
+    readonly INTERMODES: "intermodes";
+    readonly ISODATA: "isodata";
+    readonly LI: "li";
+    readonly MAX_ENTROPY: "maxEntropy";
+    readonly MEAN: "mean";
+    readonly MIN_ERROR: "minError";
+    readonly MINIMUM: "minimum";
+    readonly MOMENTS: "moments";
+    readonly OTSU: "otsu";
+    readonly PERCENTILE: "percentile";
+    readonly RENYI_ENTROPY: "renyiEntropy";
+    readonly SHANBHAG: "shanbhag";
+    readonly TRIANGLE: "triangle";
+    readonly YEN: "yen";
+};
+export type ThresholdAlgorithm = (typeof ThresholdAlgorithm)[keyof typeof ThresholdAlgorithm];
+interface ThresholdOptionsBase {
+    /**
+     * Number of slots that histogram can have. Slots must be a power of 2.
+     */
+    slots?: number;
+    /**
+     * Image to use as the output.
+     */
+    out?: Mask;
+}
+export interface ThresholdOptionsThreshold extends ThresholdOptionsBase {
+    /**
+     * Threshold value that should be used. Threshold is a value in range [0,1],
+     * which will be interpreted as a percentage of image.maxValue.
+     */
+    threshold: number;
+}
+export interface ThresholdOptionsAlgorithm extends ThresholdOptionsBase {
+    /**
+     * Specify a function to computes the threshold value.
+     *   @default `'otsu'`
+     */
+    algorithm?: ThresholdAlgorithm;
+}
+export type ThresholdOptions = ThresholdOptionsThreshold | ThresholdOptionsAlgorithm;
+/**
+ * Compute threshold value for an image using the specified algorithm.
+ * @param image - The grey image.
+ * @param options - Threshold options.
+ * @returns The threshold value for the image.
+ */
+export declare function computeThreshold(image: Image, options?: ThresholdOptionsAlgorithm): number;
+/**
+ * Create a black and white image based on a threshold value.
+ * @param image - The grey image to convert.
+ * @param options - Threshold options.
+ * @returns The resulting mask.
+ */
+export declare function threshold(image: Image, options?: ThresholdOptions): Mask;
+export {};
 //# sourceMappingURL=threshold.d.ts.map

package/lib/operations/threshold.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"threshold.d.ts","sourceRoot":"","sources":["../../src/operations/threshold.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAQjC,oBAAY,kBAAkB;IAU5B,IAAI,SAAS;IAIb,QAAQ,aAAa;CAEtB;AAED,UAAU,qBAAqB;IAC7B,GAAG,CAAC,EAAE,KAAK,CAAC;CACb;AAED,MAAM,WAAW,0BAA2B,SAAQ,qBAAqB;IACvE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,0BAA2B,SAAQ,qBAAqB;IACvE,SAAS,EAAE,kBAAkB,CAAC;CAC/B;AAED,oBAAY,gBAAgB,GACxB,0BAA0B,GAC1B,0BAA0B,CAAC;AAE/B,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,kBAAkB,GAC5B,MAAM,CAgBR;AAID,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,gBAAgB,GAAG,KAAK,CAexE"}
+{"version":3,"file":"threshold.d.ts","sourceRoot":"","sources":["../../src/operations/threshold.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAmBvC,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;CAgBrB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAC5B,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE/D,UAAU,oBAAoB;IAC5B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,yBAA0B,SAAQ,oBAAoB;IACrE;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,yBAA0B,SAAQ,oBAAoB;IACrE;;;OAGG;IACH,SAAS,CAAC,EAAE,kBAAkB,CAAC;CAChC;AAED,MAAM,MAAM,gBAAgB,GACxB,yBAAyB,GACzB,yBAAyB,CAAC;AAE9B;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,KAAK,EACZ,OAAO,GAAE,yBAA8B,GACtC,MAAM,CA2BR;AAGD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,GAAE,gBAAqB,GAAG,IAAI,CAoB5E"}