image-js 1.0.0-alpha.3 → 1.0.0

package/lib/morphology/multipleFloodFill.js

@@ -0,0 +1,87 @@
+import { Mask } from '../Mask.js';
+import { maskToOutputMask } from '../utils/getOutputImage.js';
+import { assert } from '../utils/validators/assert.js';
+const MAX_ARRAY = 65536; // 65536 should be enough for most of the cases
+const toProcess = new Uint32Array(MAX_ARRAY);
+/**
+ * Set the pixels connected to the border of the mask to zero. You can chose to allow corner connection of not with the `allowCorners` option.
+ * @param mask - The mask to process.
+ * @param options - Clear border options.
+ * @returns The image with cleared borders.
+ */
+export function multipleFloodFill(mask, options = {}) {
+    const { startPixels = [0], startPixelValue = 0, newPixelValue = 1, allowCorners = false, } = options;
+    const newMask = maskToOutputMask(mask, options, { clone: true });
+    const alreadyConsidered = Mask.createFrom(mask);
+    let from = 0;
+    let to = 0;
+    // const startPixelValue = mask.getBitByIndex(startPixels[0]);
+    // find relevant border pixels
+    for (const pixelIndex of startPixels) {
+        if (newMask.getBitByIndex(pixelIndex) === startPixelValue) {
+            toProcess[to++ % MAX_ARRAY] = pixelIndex;
+            alreadyConsidered.setBitByIndex(pixelIndex, 1);
+            newMask.setBitByIndex(pixelIndex, newPixelValue);
+        }
+    }
+    // find pixels connected to the border pixels
+    while (from < to) {
+        assert(to - from <= MAX_ARRAY);
+        const currentPixel = toProcess[from++ % MAX_ARRAY];
+        newMask.setBitByIndex(currentPixel, newPixelValue);
+        // check if pixel is on a border
+        const topBorder = currentPixel < mask.width;
+        const leftBorder = currentPixel % mask.width === 0;
+        const rightBorder = currentPixel % mask.width === mask.width - 1;
+        const bottomBorder = currentPixel > mask.size - mask.width;
+        // check neighbors
+        if (!bottomBorder) {
+            const bottom = currentPixel + mask.width;
+            addToProcess(bottom);
+        }
+        if (!leftBorder) {
+            const left = currentPixel - 1;
+            addToProcess(left);
+        }
+        if (!topBorder) {
+            const top = currentPixel - mask.width;
+            addToProcess(top);
+        }
+        if (!rightBorder) {
+            const right = currentPixel + 1;
+            addToProcess(right);
+        }
+        if (allowCorners) {
+            if (!topBorder) {
+                if (!leftBorder) {
+                    const topLeft = currentPixel - mask.width - 1;
+                    addToProcess(topLeft);
+                }
+                if (!rightBorder) {
+                    const topRight = currentPixel - mask.width + 1;
+                    addToProcess(topRight);
+                }
+            }
+            if (!bottomBorder) {
+                if (!leftBorder) {
+                    const bottomLeft = currentPixel + mask.width - 1;
+                    addToProcess(bottomLeft);
+                }
+                if (!rightBorder) {
+                    const bottomRight = currentPixel + mask.width + 1;
+                    addToProcess(bottomRight);
+                }
+            }
+        }
+    }
+    function addToProcess(pixel) {
+        if (alreadyConsidered.getBitByIndex(pixel))
+            return;
+        if (newMask.getBitByIndex(pixel) === startPixelValue) {
+            toProcess[to++ % MAX_ARRAY] = pixel;
+            alreadyConsidered.setBitByIndex(pixel, 1);
+        }
+    }
+    return newMask;
+}
+//# sourceMappingURL=multipleFloodFill.js.map

package/lib/morphology/multipleFloodFill.js.map

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

package/lib/morphology/open.d.ts

@@ -0,0 +1,18 @@
+import { Image } from '../Image.js';
+import type { Mask } from '../Mask.js';
+export interface OpenOptions {
+    /**
+     * 3x3 matrix. The kernel can only have ones and zeros.
+     * Accessing a value: kernel[row][column].
+     * @default `[[1, 1, 1], [1, 1, 1], [1, 1, 1]]`
+     */
+    kernel?: number[][];
+    /**
+     * Number of iterations of the algorithm.
+     * @default `1`
+     */
+    iterations?: number;
+}
+export declare function open(image: Image, options?: OpenOptions): Image;
+export declare function open(image: Mask, options?: OpenOptions): Mask;
+//# sourceMappingURL=open.d.ts.map

package/lib/morphology/open.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open.d.ts","sourceRoot":"","sources":["../../src/morphology/open.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAIvC,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;IACpB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC;AACjE,wBAAgB,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC"}

package/lib/morphology/open.js

@@ -0,0 +1,35 @@
+import { Image } from '../Image.js';
+import { checkKernel } from '../utils/validators/checkKernel.js';
+import checkProcessable from '../utils/validators/checkProcessable.js';
+/**
+ * In mathematical morphology, opening is the dilation of the erosion of a set A by a structuring element B.
+ * Together with closing, the opening serves in computer vision and image processing as a basic workhorse of morphological noise removal.
+ * Opening removes small objects from the foreground (usually taken as the bright pixels) of an image,
+ * placing them in the background, while closing removes small holes in the foreground, changing small islands of background into foreground. (Wikipedia)
+ * @see {@link http://docs.opencv.org/2.4/doc/tutorials/imgproc/opening_closing_hats/opening_closing_hats.html}
+ * @param image - Image to process.
+ * @param options - Open options.
+ * @returns The opened image.
+ */
+export function open(image, options = {}) {
+    const { kernel = [
+        [1, 1, 1],
+        [1, 1, 1],
+        [1, 1, 1],
+    ], iterations = 1, } = options;
+    if (image instanceof Image) {
+        checkProcessable(image, {
+            bitDepth: [1, 8, 16],
+            components: 1,
+            alpha: false,
+        });
+    }
+    checkKernel(kernel);
+    let newImage = image;
+    for (let i = 0; i < iterations; i++) {
+        newImage = newImage.erode({ kernel });
+        newImage = newImage.dilate({ kernel });
+    }
+    return newImage;
+}
+//# sourceMappingURL=open.js.map

package/lib/morphology/open.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open.js","sourceRoot":"","sources":["../../src/morphology/open.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,gBAAgB,MAAM,yCAAyC,CAAC;AAkBvE;;;;;;;;;GASG;AACH,MAAM,UAAU,IAAI,CAClB,KAAmB,EACnB,UAAuB,EAAE;IAEzB,MAAM,EACJ,MAAM,GAAG;QACP,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACT,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACT,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;KACV,EACD,UAAU,GAAG,CAAC,GACf,GAAG,OAAO,CAAC;IAEZ,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,gBAAgB,CAAC,KAAK,EAAE;YACtB,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACpB,UAAU,EAAE,CAAC;YACb,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;IACL,CAAC;IAED,WAAW,CAAC,MAAM,CAAC,CAAC;IAEpB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QACtC,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/lib/morphology/solidFill.d.ts

@@ -0,0 +1,20 @@
+import type { Mask } from '../Mask.js';
+export interface SolidFillOptions {
+    /**
+     * Consider pixels connected by corners?
+     * @default `false`
+     */
+    allowCorners?: boolean;
+    /**
+     * Image to which the inverted image has to be put.
+     */
+    out?: Mask;
+}
+/**
+ * Fill holes in regions of interest.
+ * @param mask - Mask to process.
+ * @param options - Flood fill options.
+ * @returns The filled mask.
+ */
+export declare function solidFill(mask: Mask, options?: SolidFillOptions): Mask;
+//# sourceMappingURL=solidFill.d.ts.map

package/lib/morphology/solidFill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solidFill.d.ts","sourceRoot":"","sources":["../../src/morphology/solidFill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGvC,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;OAEG;IACH,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,gBAAqB,GAAG,IAAI,CAO1E"}

package/lib/morphology/solidFill.js

@@ -0,0 +1,15 @@
+import { maskToOutputMask } from '../utils/getOutputImage.js';
+/**
+ * Fill holes in regions of interest.
+ * @param mask - Mask to process.
+ * @param options - Flood fill options.
+ * @returns The filled mask.
+ */
+export function solidFill(mask, options = {}) {
+    const { allowCorners = false } = options;
+    const newImage = maskToOutputMask(mask, options, { clone: true });
+    const inverted = mask.invert();
+    const cleared = inverted.clearBorder({ allowCorners });
+    return newImage.or(cleared, { out: newImage });
+}
+//# sourceMappingURL=solidFill.js.map

package/lib/morphology/solidFill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"solidFill.js","sourceRoot":"","sources":["../../src/morphology/solidFill.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAc9D;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,IAAU,EAAE,UAA4B,EAAE;IAClE,MAAM,EAAE,YAAY,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAEzC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC/B,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC;IACvD,OAAO,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;AACjD,CAAC"}

package/lib/morphology/topHat.d.ts

@@ -0,0 +1,18 @@
+import { Image } from '../Image.js';
+import type { Mask } from '../Mask.js';
+export interface TopHatOptions {
+    /**
+     * 3x3 matrix. The kernel can only have ones and zeros.
+     * Accessing a value: kernel[row][column].
+     * @default `[[1, 1, 1], [1, 1, 1], [1, 1, 1]]`
+     */
+    kernel?: number[][];
+    /**
+     * Number of iterations of the algorithm.
+     * @default `1`
+     */
+    iterations?: number;
+}
+export declare function topHat(image: Image, options?: TopHatOptions): Image;
+export declare function topHat(image: Mask, options?: TopHatOptions): Mask;
+//# sourceMappingURL=topHat.d.ts.map

package/lib/morphology/topHat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topHat.d.ts","sourceRoot":"","sources":["../../src/morphology/topHat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAKvC,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;IACpB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,KAAK,CAAC;AACrE,wBAAgB,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC"}

package/lib/morphology/topHat.js

@@ -0,0 +1,36 @@
+import { Image } from '../Image.js';
+import { subtract } from '../compare/index.js';
+import { checkKernel } from '../utils/validators/checkKernel.js';
+import checkProcessable from '../utils/validators/checkProcessable.js';
+/**
+ * This function is the white top hat (also called top hat). In mathematical morphology and digital image processing,
+ * top-hat transform is an operation that extracts small elements and details from given images.
+ * The white top-hat transform is defined as the difference between the input image and its opening by some structuring element.
+ * Top-hat transforms are used for various image processing tasks, such as feature extraction, background equalization, image enhancement, and others. (Wikipedia)
+ * @see {@link http://docs.opencv.org/2.4/doc/tutorials/imgproc/opening_closing_hats/opening_closing_hats.html}
+ * @param image - Image to process.
+ * @param options - Top hat options.
+ * @returns The top-hatted image.
+ */
+export function topHat(image, options = {}) {
+    const { kernel = [
+        [1, 1, 1],
+        [1, 1, 1],
+        [1, 1, 1],
+    ], iterations = 1, } = options;
+    if (image instanceof Image) {
+        checkProcessable(image, {
+            bitDepth: [1, 8, 16],
+            components: 1,
+            alpha: false,
+        });
+    }
+    checkKernel(kernel);
+    let newImage = image;
+    for (let i = 0; i < iterations; i++) {
+        const openImage = newImage.open({ kernel });
+        newImage = subtract(openImage, newImage, { absolute: true });
+    }
+    return newImage;
+}
+//# sourceMappingURL=topHat.js.map

package/lib/morphology/topHat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topHat.js","sourceRoot":"","sources":["../../src/morphology/topHat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,gBAAgB,MAAM,yCAAyC,CAAC;AAkBvE;;;;;;;;;GASG;AACH,MAAM,UAAU,MAAM,CACpB,KAAmB,EACnB,UAAyB,EAAE;IAE3B,MAAM,EACJ,MAAM,GAAG;QACP,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACT,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACT,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;KACV,EACD,UAAU,GAAG,CAAC,GACf,GAAG,OAAO,CAAC;IAEZ,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,gBAAgB,CAAC,KAAK,EAAE;YACtB,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACpB,UAAU,EAAE,CAAC;YACb,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;IACL,CAAC;IAED,WAAW,CAAC,MAAM,CAAC,CAAC;IAEpB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAC5C,QAAQ,GAAG,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/lib/operations/convertBitDepth.d.ts

@@ -0,0 +1,16 @@
+import type { BitDepth, Image } from '../Image.js';
+export interface ConvertBitDepthOptions {
+    /**
+     * Image to which to output.
+     */
+    out?: Image;
+}
+/**
+ * Convert the bit depth of an image.
+ * @param image - Image to convert.
+ * @param newBitDepth - Bit depth to convert to.
+ * @param options - Convert bit depth options.
+ * @returns Converted image.
+ */
+export declare function convertBitDepth(image: Image, newBitDepth: BitDepth, options?: ConvertBitDepthOptions): Image;
+//# sourceMappingURL=convertBitDepth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"convertBitDepth.d.ts","sourceRoot":"","sources":["../../src/operations/convertBitDepth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGnD,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,GAAG,CAAC,EAAE,KAAK,CAAC;CACb;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,QAAQ,EACrB,OAAO,GAAE,sBAA2B,GACnC,KAAK,CAsBP"}

package/lib/operations/convertBitDepth.js

@@ -0,0 +1,56 @@
+import { getOutputImage } from '../utils/getOutputImage.js';
+/**
+ * Convert the bit depth of an image.
+ * @param image - Image to convert.
+ * @param newBitDepth - Bit depth to convert to.
+ * @param options - Convert bit depth options.
+ * @returns Converted image.
+ */
+export function convertBitDepth(image, newBitDepth, options = {}) {
+    if (image.bitDepth === newBitDepth) {
+        return getOutputImage(image, options, { clone: true });
+    }
+    if (newBitDepth !== 8 && newBitDepth !== 16) {
+        throw new RangeError(`This image bit depth is not supported: ${newBitDepth}`);
+    }
+    // Get the output image first - this handles the out option
+    const newImage = getOutputImage(image, options, {
+        clone: false,
+        newParameters: {
+            bitDepth: newBitDepth,
+            colorModel: image.colorModel,
+        },
+    });
+    return newBitDepth === 8
+        ? convertToUint8(image, newImage)
+        : convertToUint16(image, newImage);
+}
+/**
+ * Convert bit depth to 16 bits.
+ * @param image - Image to convert.
+ * @param targetImage - Target image to write to.
+ * @returns Converted image.
+ */
+function convertToUint16(image, targetImage) {
+    for (let i = 0; i < image.size; i++) {
+        for (let j = 0; j < targetImage.channels; j++) {
+            targetImage.setValueByIndex(i, j, image.getValueByIndex(i, j) << 8);
+        }
+    }
+    return targetImage;
+}
+/**
+ * Convert bit depth to 8 bits.
+ * @param image - Image to convert.
+ * @param targetImage - Target image to write to.
+ * @returns Converted image.
+ */
+function convertToUint8(image, targetImage) {
+    for (let i = 0; i < image.size; i++) {
+        for (let j = 0; j < targetImage.channels; j++) {
+            targetImage.setValueByIndex(i, j, image.getValueByIndex(i, j) >> 8);
+        }
+    }
+    return targetImage;
+}
+//# sourceMappingURL=convertBitDepth.js.map

package/lib/operations/convertBitDepth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertBitDepth.js","sourceRoot":"","sources":["../../src/operations/convertBitDepth.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAS5D;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAY,EACZ,WAAqB,EACrB,UAAkC,EAAE;IAEpC,IAAI,KAAK,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;QACnC,OAAO,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,WAAW,KAAK,CAAC,IAAI,WAAW,KAAK,EAAE,EAAE,CAAC;QAC5C,MAAM,IAAI,UAAU,CAClB,0CAA0C,WAAW,EAAE,CACxD,CAAC;IACJ,CAAC;IACD,2DAA2D;IAC3D,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE;QAC9C,KAAK,EAAE,KAAK;QACZ,aAAa,EAAE;YACb,QAAQ,EAAE,WAAW;YACrB,UAAU,EAAE,KAAK,CAAC,UAAU;SAC7B;KACF,CAAC,CAAC;IAEH,OAAO,WAAW,KAAK,CAAC;QACtB,CAAC,CAAC,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC;QACjC,CAAC,CAAC,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,SAAS,eAAe,CAAC,KAAY,EAAE,WAAkB;IACvD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9C,WAAW,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;;;;GAKG;AACH,SAAS,cAAc,CAAC,KAAY,EAAE,WAAkB;IACtD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9C,WAAW,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/lib/operations/convertColor.d.ts

@@ -1,6 +1,36 @@
-import { Image, ImageKind } from '../Image';
-export interface IConvertColorOptions {
-    out?: Image;
-}
-export declare function convertColor(image: Image, kind: ImageKind, options?: IConvertColorOptions): Image;
+import { Image } from '../Image.js';
+import type { Mask } from '../Mask.js';
+import type { ImageColorModel } from '../utils/constants/colorModels.js';
+export interface ConvertColorOptions {
+    /**
+     * Image to which to output.
+     */
+    out?: Image;
+}
+/**
+ * Convert image to a different color model.
+ * @param image - Image to convert.
+ * @param colorModel - New color model.
+ * @param options - Convert color options.
+ * @returns The converted image.
+ */
+export declare function convertColor(image: Image | Mask, colorModel: ImageColorModel, options?: ConvertColorOptions): Image;
+/**
+ * Copy alpha channel of source to dest.
+ * @param source - Source image.
+ * @param dest - Destination image.
+ */
+export declare function copyAlpha(source: Image, dest: Image): void;
+/**
+ * Convert Mask to GREY.
+ * @param mask - Mask to convert.
+ * @param newImage - Converted image.
+ */
+export declare function convertBinaryToGrey(mask: Mask, newImage: Image): void;
+/**
+ * Convert mask to RGB or RGBA.
+ * @param mask - Mask to convert.
+ * @param newImage - Converted image.
+ */
+export declare function convertBinaryToRgb(mask: Mask, newImage: Image): void;
 //# sourceMappingURL=convertColor.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"convertColor.d.ts","sourceRoot":"","sources":["../../src/operations/convertColor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAG5C,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,EAAE,KAAK,CAAC;CACb;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,SAAS,EACf,OAAO,GAAE,oBAAyB,GACjC,KAAK,CA2CP"}
+{"version":3,"file":"convertColor.d.ts","sourceRoot":"","sources":["../../src/operations/convertColor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAGzE,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,GAAG,CAAC,EAAE,KAAK,CAAC;CACb;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,KAAK,GAAG,IAAI,EACnB,UAAU,EAAE,eAAe,EAC3B,OAAO,GAAE,mBAAwB,GAChC,KAAK,CA6DP;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,CAkB1D;AA8CD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,GAAG,IAAI,CAQrE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,GAAG,IAAI,CAUpE"}

package/lib/operations/convertColor.js

@@ -1,76 +1,144 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const Image_1 = require("../Image");
-const getOutputImage_1 = require("../utils/getOutputImage");
-function convertColor(image, kind, options = {}) {
-    const canConvert = new Map([
-        [Image_1.ImageKind.GREY, [Image_1.ImageKind.GREYA, Image_1.ImageKind.RGB, Image_1.ImageKind.RGBA]],
-        [Image_1.ImageKind.GREYA, [Image_1.ImageKind.GREY, Image_1.ImageKind.RGB, Image_1.ImageKind.RGBA]],
-        [Image_1.ImageKind.RGB, [Image_1.ImageKind.GREYA, Image_1.ImageKind.GREY, Image_1.ImageKind.RGBA]],
-        [Image_1.ImageKind.RGBA, [Image_1.ImageKind.GREYA, Image_1.ImageKind.GREY, Image_1.ImageKind.RGB]]
-    ]);
-    if (image.kind === kind) {
-        throw new Error(`Cannot convert color, image is already ${kind}`);
-    }
-    const canConvertTo = canConvert.get(image.kind);
-    if (!canConvertTo || !canConvertTo.includes(kind)) {
-        throw new Error(`conversion from ${image.kind} to ${kind} not implemented`);
-    }
-    const output = getOutputImage_1.getOutputImage(image, options, {
-        newParameters: { kind }
-    });
-    if (image.kind === Image_1.ImageKind.GREY || image.kind === Image_1.ImageKind.GREYA) {
-        convertGreyToAny(image, output);
-    }
-    if (image.kind === Image_1.ImageKind.RGB || image.kind === Image_1.ImageKind.RGBA) {
-        if (kind === Image_1.ImageKind.RGB || kind === Image_1.ImageKind.RGBA) {
-            convertRgbToRgb(image, output);
-        }
-        else {
-            // GREYA or GREY
-            convertRgbToGrey(image, output);
-        }
-    }
-    if (!image.alpha && output.alpha) {
-        output.fillAlpha(output.maxValue);
-    }
-    if (image.alpha && output.alpha) {
-        copyAlpha(image, output);
-    }
-    return output;
-}
-exports.convertColor = convertColor;
-function copyAlpha(source, dest) {
-    if (!source.alpha) {
-        throw new Error('source image does not have alpha');
-    }
-    if (!dest.alpha) {
-        throw new Error('destination does not have alpha');
-    }
-    for (let i = dest.channels - 1, j = source.channels - 1; i < dest.data.length; i += dest.channels, j += source.channels) {
-        dest.data[i] = source.data[j];
-    }
-}
-function convertGreyToAny(image, newImage) {
-    for (let i = 0, iNew = 0; i < image.data.length; i += image.channels, iNew += newImage.channels) {
-        for (let j = 0; j < newImage.components; j++) {
-            newImage.data[iNew + j] = image.data[i];
-        }
-    }
-}
-function convertRgbToRgb(image, newImage) {
-    for (let i = 0, iNew = 0; i < image.data.length; i += image.channels, iNew += newImage.channels) {
-        for (let j = 0; j < 3; j++) {
-            newImage.data[iNew + j] = image.data[i + j];
-        }
-    }
-}
-function convertRgbToGrey(image, newImage) {
-    for (let i = 0, iNew = 0; i < image.data.length; i += image.channels, iNew += newImage.channels) {
-        const r = image.data[i];
-        const g = image.data[i + 1];
-        const b = image.data[i + 2];
-        newImage.data[iNew] = Math.round(0.299 * r + 0.587 * g + 0.114 * b);
-    }
-}
+import { Image } from '../Image.js';
+import { getOutputImage, maskToOutputImage } from '../utils/getOutputImage.js';
+/**
+ * Convert image to a different color model.
+ * @param image - Image to convert.
+ * @param colorModel - New color model.
+ * @param options - Convert color options.
+ * @returns The converted image.
+ */
+export function convertColor(image, colorModel, options = {}) {
+    const canConvert = new Map([
+        ['GREY', ['GREYA', 'RGB', 'RGBA']],
+        ['GREYA', ['GREY', 'RGB', 'RGBA']],
+        ['RGB', ['GREY', 'GREYA', 'RGBA']],
+        ['RGBA', ['GREY', 'GREYA', 'RGB']],
+        ['BINARY', ['GREY', 'RGB', 'RGBA']],
+    ]);
+    if (image.colorModel === colorModel && colorModel !== 'BINARY') {
+        return getOutputImage(image, { out: options.out }, { clone: true });
+    }
+    const canConvertTo = canConvert.get(image.colorModel);
+    if (!canConvertTo?.includes(colorModel)) {
+        throw new RangeError(`conversion from ${image.colorModel} to ${colorModel} not implemented`);
+    }
+    if (image instanceof Image) {
+        const output = getOutputImage(image, options, {
+            newParameters: { colorModel },
+        });
+        if (image.colorModel === 'GREY' || image.colorModel === 'GREYA') {
+            convertGreyToAny(image, output);
+        }
+        if (image.colorModel === 'RGB' || image.colorModel === 'RGBA') {
+            if (colorModel === 'RGB' || colorModel === 'RGBA') {
+                convertRgbToRgb(image, output);
+            }
+            else {
+                // GREYA or GREY
+                convertRgbToGrey(image, output);
+            }
+        }
+        if (!image.alpha && output.alpha) {
+            output.fillAlpha(output.maxValue);
+        }
+        if (image.alpha && output.alpha) {
+            copyAlpha(image, output);
+        }
+        return output;
+    }
+    else if (colorModel === 'GREY') {
+        const output = maskToOutputImage(image, options);
+        convertBinaryToGrey(image, output);
+        return output;
+    }
+    else {
+        const img = new Image(image.width, image.height, {
+            colorModel,
+        });
+        convertBinaryToRgb(image, img);
+        return img;
+    }
+}
+/**
+ * Copy alpha channel of source to dest.
+ * @param source - Source image.
+ * @param dest - Destination image.
+ */
+export function copyAlpha(source, dest) {
+    if (source.size !== dest.size) {
+        throw new RangeError('source and destination have different sizes');
+    }
+    if (!source.alpha) {
+        throw new RangeError('source image does not have alpha');
+    }
+    if (!dest.alpha) {
+        throw new RangeError('destination does not have alpha');
+    }
+    for (let i = 0; i < dest.size; i++) {
+        dest.setValueByIndex(i, dest.channels - 1, source.getValueByIndex(i, source.channels - 1));
+    }
+}
+/**
+ * Convert grey image to other color model.
+ * @param image - Image to convert.
+ * @param newImage - Converted image.
+ */
+function convertGreyToAny(image, newImage) {
+    for (let i = 0; i < image.size; i++) {
+        for (let j = 0; j < newImage.components; j++) {
+            newImage.setValueByIndex(i, j, image.getValueByIndex(i, 0));
+        }
+    }
+}
+/**
+ * Convert RGB image to RGB. Allows to use convert with an RGB target whatever the image color model is.
+ * @param image - Image to convert.
+ * @param newImage - Converted image.
+ */
+function convertRgbToRgb(image, newImage) {
+    for (let i = 0; i < image.size; i++) {
+        for (let j = 0; j < 3; j++) {
+            newImage.setValueByIndex(i, j, image.getValueByIndex(i, j));
+        }
+    }
+}
+/**
+ * Convert RGB image to GREY.
+ * @param image - Image to convert.
+ * @param newImage - Converted image.
+ */
+function convertRgbToGrey(image, newImage) {
+    for (let i = 0; i < image.size; i++) {
+        const r = image.getValueByIndex(i, 0);
+        const g = image.getValueByIndex(i, 1);
+        const b = image.getValueByIndex(i, 2);
+        newImage.setValueByIndex(i, 0, Math.round(0.299 * r + 0.587 * g + 0.114 * b));
+    }
+}
+/**
+ * Convert Mask to GREY.
+ * @param mask - Mask to convert.
+ * @param newImage - Converted image.
+ */
+export function convertBinaryToGrey(mask, newImage) {
+    for (let i = 0; i < mask.size; i++) {
+        newImage.setValueByIndex(i, 0, mask.getBitByIndex(i) ? newImage.maxValue : 0);
+    }
+}
+/**
+ * Convert mask to RGB or RGBA.
+ * @param mask - Mask to convert.
+ * @param newImage - Converted image.
+ */
+export function convertBinaryToRgb(mask, newImage) {
+    const black = new Array(newImage.components).fill(0);
+    const white = new Array(newImage.components).fill(newImage.maxValue);
+    if (newImage.alpha) {
+        black.push(newImage.maxValue);
+        white.push(newImage.maxValue);
+    }
+    for (let i = 0; i < mask.size; i++) {
+        newImage.setPixelByIndex(i, mask.getBitByIndex(i) ? white : black);
+    }
+}
 //# sourceMappingURL=convertColor.js.map