image-js 0.0.0-next-e30968a2d8

package/lib/Mask.d.ts

@@ -0,0 +1,257 @@
+import { AndOptions, InvertOptions, OrOptions, SubtractImageOptions } from './filters';
+import { BottomHatOptions, ClearBorderOptions, CloseOptions, DilateOptions, ErodeOptions, FloodFillOptions, MorphologicalGradientOptions, OpenOptions, TopHatOptions } from './morphology';
+import { ImageColorModel, ColorDepth, IJS } from '.';
+export declare type BitValue = 1 | 0 | boolean;
+export interface MaskOptions {
+    /**
+     * Typed array holding the mask data.
+     */
+    data?: Uint8Array;
+}
+export interface MaskCreateFromOptions extends MaskOptions {
+    width?: number;
+    height?: number;
+}
+export declare class Mask {
+    /**
+     * The number of columns of the mask.
+     */
+    readonly width: number;
+    /**
+     * The number of rows of the mask.
+     */
+    readonly height: number;
+    /**
+     * The total number of bits in the mask (width × height).
+     */
+    readonly size: number;
+    /**
+     * The number of bits per value in each channel (always 1).
+     */
+    readonly depth: ColorDepth;
+    /**
+     * The color model of the mask (always BINARY).
+     */
+    readonly colorModel: ImageColorModel;
+    /**
+     * The number of color channels in the image, excluding the alpha channel.
+     * (always 1)
+     */
+    readonly components: number;
+    /**
+     * The number of channels in the mask, including the alpha channel.
+     * (always 1)
+     */
+    readonly channels: number;
+    /**
+     * Specifying that the mask has no an alpha channel.
+     */
+    readonly alpha: boolean;
+    /**
+     * The maximum value that a pixel channel can have.
+     */
+    readonly maxValue: number;
+    /**
+     * Typed array holding the mask data.
+     */
+    private readonly data;
+    /**
+     * Construct a new Mask knowing its dimensions.
+     *
+     * @param width - Image width.
+     * @param height - Image height.
+     * @param options - Image options.
+     */
+    constructor(width: number, height: number, options?: MaskOptions);
+    /**
+     * Create a new Mask based on the properties of an existing one.
+     *
+     * @param other - Reference Mask.
+     * @param options - Mask options.
+     * @returns New mask.
+     */
+    static createFrom(other: Mask | IJS, options?: MaskCreateFromOptions): Mask;
+    /**
+     * Create a copy of this mask.
+     *
+     * @returns The mask clone.
+     */
+    clone(): Mask;
+    /**
+     * Get the value of a bit.
+     *
+     * @param row - Row index.
+     * @param column - Column index.
+     * @returns The bit value.
+     */
+    getBit(row: number, column: number): number;
+    /**
+     * Set the value of a bit.
+     *
+     * @param row - Row index.
+     * @param column - Column index.
+     * @param value - New bit value.
+     */
+    setBit(row: number, column: number, value: BitValue): void;
+    /**
+     * Get the value of a bit using index.
+     *
+     * @param index - Index of the pixel.
+     * @returns Value of the bit.
+     */
+    getBitByIndex(index: number): number;
+    /**
+     * Set the value of a bit using index.
+     *
+     * @param index - Index of the pixel.
+     * @param value - Value to set.
+     */
+    setBitByIndex(index: number, value: BitValue): void;
+    /**
+     * Get the value of a bit. Function exists for compatibility with IJS.
+     *
+     * @param row - Row index.
+     * @param column - Column index.
+     * @param channel - Index of the channel, must be zero.
+     * @returns The bit value.
+     */
+    getValue(row: number, column: number, channel: number): number;
+    /**
+     * Set the value of a bit. Function exists for compatibility with IJS.
+     *
+     * @param row - Row index.
+     * @param column - Column index.
+     * @param channel - Index of the channel, must be zero.
+     * @param value - New bit value.
+     */
+    setValue(row: number, column: number, channel: number, value: BitValue): void;
+    /**
+     * Get the value of a bit using index. Function exists for compatibility with IJS.
+     *
+     * @param index - Index of the pixel.
+     * @param channel - Index of the channel, must be zero.
+     * @returns Value of the bit.
+     */
+    getValueByIndex(index: number, channel: number): number;
+    /**
+     * Set the value of a bit using index. Function exists for compatibility with IJS.
+     *
+     * @param index - Index of the pixel.
+     * @param channel - Index of the channel, must be zero.
+     * @param value - Value to set.
+     */
+    setValueByIndex(index: number, channel: number, value: BitValue): void;
+    /**
+     * Return the raw mask data.
+     *
+     * @returns The raw data.
+     */
+    getRawImage(): {
+        width: number;
+        height: number;
+        data: Uint8Array;
+    };
+    /**
+     * Fill the mask with a value.
+     *
+     * @param value - Value of the bit.
+     * @returns The mask instance.
+     */
+    fill(value: BitValue): this;
+    convertColor(colorModel: ImageColorModel): IJS;
+    /**
+     * Invert the colors of the mask.
+     *
+     * @param options - Inversion options
+     * @returns The inverted mask.
+     */
+    invert(options?: InvertOptions): Mask;
+    /**
+     * Subtract other from a mask.
+     *
+     * @param other - Image to subtract
+     * @param options - Inversion options
+     * @returns The subtracted mask.
+     */
+    subtractImage(other: Mask, options?: SubtractImageOptions): Mask;
+    /**
+     * Perform an AND operation on two masks.
+     *
+     * @param other - Second mask.
+     * @param options - And options.
+     * @returns AND of the two masks.
+     */
+    and(other: Mask, options?: AndOptions): Mask;
+    /**
+     * Perform an OR operation on two masks.
+     *
+     * @param other - Second mask.
+     * @param options - And options.
+     * @returns OR of the two masks.
+     */
+    or(other: Mask, options?: OrOptions): Mask;
+    /**
+     * Erode a Mask.
+     *
+     * @param options - Erode options
+     * @returns The eroded mask.
+     */
+    erode(options?: ErodeOptions): Mask;
+    /**
+     * Dilate an image.
+     *
+     * @param options - Dilate options.
+     * @returns The dilated image.
+     */
+    dilate(options?: DilateOptions): Mask;
+    /**
+     * Open an image.
+     *
+     * @param options - Open options.
+     * @returns The opened image.
+     */
+    open(options?: OpenOptions): Mask;
+    /**
+     * Close an image.
+     *
+     * @param options - Close options.
+     * @returns The closed image.
+     */
+    close(options?: CloseOptions): Mask;
+    /**
+     * Top hat of an image.
+     *
+     * @param options - Top hat options.
+     * @returns The top-hatted image.
+     */
+    topHat(options?: TopHatOptions): Mask;
+    /**
+     * Bottom hat of an image.
+     *
+     * @param options - Bottom hat options.
+     * @returns The bottom-hatted image.
+     */
+    bottomHat(options?: BottomHatOptions): Mask;
+    /**
+     * Apply morphological gradient to an image.
+     *
+     * @param options - Morphological gradient options.
+     * @returns The processed image.
+     */
+    morphologicalGradient(options?: MorphologicalGradientOptions): Mask;
+    /**
+     * Remove elements connected to the borders of an image.
+     *
+     * @param options - Clear border options.
+     * @returns The processed image.
+     */
+    clearBorder(options?: ClearBorderOptions): Mask;
+    /**
+     * Fill holes in regions of interest.
+     *
+     * @param options - Flood fill options.
+     * @returns The filled mask.
+     */
+    floodFill(options?: FloodFillOptions): Mask;
+}
+//# sourceMappingURL=Mask.d.ts.map

package/lib/Mask.d.ts.map

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

package/lib/Mask.js

@@ -0,0 +1,338 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Mask = void 0;
+const filters_1 = require("./filters");
+const morphology_1 = require("./morphology");
+const erode_1 = require("./morphology/erode");
+const boolToNumber_1 = require("./utils/boolToNumber");
+const _1 = require(".");
+class Mask {
+    /**
+     * Construct a new Mask knowing its dimensions.
+     *
+     * @param width - Image width.
+     * @param height - Image height.
+     * @param options - Image options.
+     */
+    constructor(width, height, options = {}) {
+        const { data } = options;
+        if (width < 1 || !Number.isInteger(width)) {
+            throw new RangeError(`width must be an integer and at least 1. Received ${width}`);
+        }
+        if (height < 1 || !Number.isInteger(height)) {
+            throw new RangeError(`height must be an integer and at least 1. Received ${height}`);
+        }
+        this.width = width;
+        this.height = height;
+        this.size = width * height;
+        this.depth = _1.ColorDepth.UINT1;
+        this.colorModel = _1.ImageColorModel.BINARY;
+        const colorModelDef = _1.colorModels[this.colorModel];
+        this.components = colorModelDef.components;
+        this.alpha = colorModelDef.alpha;
+        this.channels = colorModelDef.channels;
+        this.maxValue = 1;
+        if (data === undefined) {
+            this.data = new Uint8Array(this.size);
+        }
+        else {
+            const expectedLength = this.size * this.channels;
+            if (data.length !== expectedLength) {
+                throw new RangeError(`incorrect data size: ${data.length}. Expected ${expectedLength}`);
+            }
+            this.data = data;
+        }
+    }
+    /**
+     * Create a new Mask based on the properties of an existing one.
+     *
+     * @param other - Reference Mask.
+     * @param options - Mask options.
+     * @returns New mask.
+     */
+    static createFrom(other, options = {}) {
+        const { width = other.width, height = other.height } = options;
+        return new Mask(width, height, options);
+    }
+    /**
+     * Create a copy of this mask.
+     *
+     * @returns The mask clone.
+     */
+    clone() {
+        return Mask.createFrom(this, { data: this.data.slice() });
+    }
+    /**
+     * Get the value of a bit.
+     *
+     * @param row - Row index.
+     * @param column - Column index.
+     * @returns The bit value.
+     */
+    getBit(row, column) {
+        const index = row * this.width + column;
+        return this.data[index];
+    }
+    /**
+     * Set the value of a bit.
+     *
+     * @param row - Row index.
+     * @param column - Column index.
+     * @param value - New bit value.
+     */
+    setBit(row, column, value) {
+        const index = row * this.width + column;
+        // @ts-expect-error: we know that value is a boolean
+        this.data[index] = value;
+    }
+    /**
+     * Get the value of a bit using index.
+     *
+     * @param index - Index of the pixel.
+     * @returns Value of the bit.
+     */
+    getBitByIndex(index) {
+        return this.data[index * this.channels];
+    }
+    /**
+     * Set the value of a bit using index.
+     *
+     * @param index - Index of the pixel.
+     * @param value - Value to set.
+     */
+    setBitByIndex(index, value) {
+        let result = (0, boolToNumber_1.boolToNumber)(value);
+        this.data[index * this.channels] = result;
+    }
+    /**
+     * Get the value of a bit. Function exists for compatibility with IJS.
+     *
+     * @param row - Row index.
+     * @param column - Column index.
+     * @param channel - Index of the channel, must be zero.
+     * @returns The bit value.
+     */
+    getValue(row, column, channel) {
+        checkChannel(channel);
+        return this.getBit(row, column);
+    }
+    /**
+     * Set the value of a bit. Function exists for compatibility with IJS.
+     *
+     * @param row - Row index.
+     * @param column - Column index.
+     * @param channel - Index of the channel, must be zero.
+     * @param value - New bit value.
+     */
+    setValue(row, column, channel, value) {
+        checkChannel(channel);
+        this.setBit(row, column, value);
+    }
+    /**
+     * Get the value of a bit using index. Function exists for compatibility with IJS.
+     *
+     * @param index - Index of the pixel.
+     * @param channel - Index of the channel, must be zero.
+     * @returns Value of the bit.
+     */
+    getValueByIndex(index, channel) {
+        checkChannel(channel);
+        return this.getBitByIndex(index);
+    }
+    /**
+     * Set the value of a bit using index. Function exists for compatibility with IJS.
+     *
+     * @param index - Index of the pixel.
+     * @param channel - Index of the channel, must be zero.
+     * @param value - Value to set.
+     */
+    setValueByIndex(index, channel, value) {
+        checkChannel(channel);
+        this.setBitByIndex(index, value);
+    }
+    /**
+     * Return the raw mask data.
+     *
+     * @returns The raw data.
+     */
+    getRawImage() {
+        return {
+            width: this.width,
+            height: this.height,
+            data: this.data,
+        };
+    }
+    [Symbol.for('nodejs.util.inspect.custom')]() {
+        return `Mask {
+  width: ${this.width}
+  height: ${this.height}
+  data: ${printData(this)}
+}`;
+    }
+    /**
+     * Fill the mask with a value.
+     *
+     * @param value - Value of the bit.
+     * @returns The mask instance.
+     */
+    fill(value) {
+        let result = (0, boolToNumber_1.boolToNumber)(value);
+        this.data.fill(result);
+        return this;
+    }
+    convertColor(colorModel) {
+        return (0, _1.convertColor)(this, colorModel);
+    }
+    // FILTERS
+    /**
+     * Invert the colors of the mask.
+     *
+     * @param options - Inversion options
+     * @returns The inverted mask.
+     */
+    invert(options) {
+        return (0, filters_1.invert)(this, options);
+    }
+    /**
+     * Subtract other from a mask.
+     *
+     * @param other - Image to subtract
+     * @param options - Inversion options
+     * @returns The subtracted mask.
+     */
+    subtractImage(other, options) {
+        return (0, filters_1.subtractImage)(this, other, options);
+    }
+    /**
+     * Perform an AND operation on two masks.
+     *
+     * @param other - Second mask.
+     * @param options - And options.
+     * @returns AND of the two masks.
+     */
+    and(other, options) {
+        return (0, filters_1.and)(this, other, options);
+    }
+    /**
+     * Perform an OR operation on two masks.
+     *
+     * @param other - Second mask.
+     * @param options - And options.
+     * @returns OR of the two masks.
+     */
+    or(other, options) {
+        return (0, filters_1.or)(this, other, options);
+    }
+    // MORPHOLOGY
+    /**
+     * Erode a Mask.
+     *
+     * @param options - Erode options
+     * @returns The eroded mask.
+     */
+    erode(options) {
+        return (0, erode_1.erode)(this, options);
+    }
+    /**
+     * Dilate an image.
+     *
+     * @param options - Dilate options.
+     * @returns The dilated image.
+     */
+    dilate(options) {
+        return (0, morphology_1.dilate)(this, options);
+    }
+    /**
+     * Open an image.
+     *
+     * @param options - Open options.
+     * @returns The opened image.
+     */
+    open(options) {
+        return (0, morphology_1.open)(this, options);
+    }
+    /**
+     * Close an image.
+     *
+     * @param options - Close options.
+     * @returns The closed image.
+     */
+    close(options) {
+        return (0, morphology_1.close)(this, options);
+    }
+    /**
+     * Top hat of an image.
+     *
+     * @param options - Top hat options.
+     * @returns The top-hatted image.
+     */
+    topHat(options) {
+        return (0, morphology_1.topHat)(this, options);
+    }
+    /**
+     * Bottom hat of an image.
+     *
+     * @param options - Bottom hat options.
+     * @returns The bottom-hatted image.
+     */
+    bottomHat(options) {
+        return (0, morphology_1.bottomHat)(this, options);
+    }
+    /**
+     * Apply morphological gradient to an image.
+     *
+     * @param options - Morphological gradient options.
+     * @returns The processed image.
+     */
+    morphologicalGradient(options) {
+        return (0, morphology_1.morphologicalGradient)(this, options);
+    }
+    /**
+     * Remove elements connected to the borders of an image.
+     *
+     * @param options - Clear border options.
+     * @returns The processed image.
+     */
+    clearBorder(options) {
+        return (0, morphology_1.clearBorder)(this, options);
+    }
+    /**
+     * Fill holes in regions of interest.
+     *
+     * @param options - Flood fill options.
+     * @returns The filled mask.
+     */
+    floodFill(options) {
+        return (0, morphology_1.floodFill)(this, options);
+    }
+}
+exports.Mask = Mask;
+/**
+ * Returns all values of a mask as a string.
+ *
+ * @param mask - Input mask.
+ * @returns Formatted string with all values of a mask.
+ */
+function printData(mask) {
+    const result = [];
+    const padding = 2;
+    for (let i = 0; i < mask.height; i++) {
+        const line = [];
+        for (let j = 0; j < mask.width; j++) {
+            line.push(String(mask.getBit(i, j)).padStart(padding, ' '));
+        }
+        result.push(`[${line.join(' ')}]`);
+    }
+    return result.join('\n     ');
+}
+/**
+ * Verify the channel value of a mask
+ *
+ * @param channel - The channel value
+ */
+function checkChannel(channel) {
+    if (channel !== 0) {
+        throw new Error(`Channel value must be 0 on type Mask, got ${channel}.`);
+    }
+}
+//# sourceMappingURL=Mask.js.map

package/lib/Mask.js.map

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

package/lib/compute/histogram.d.ts

@@ -0,0 +1,20 @@
+import { IJS } from '../IJS';
+export interface HistogramOptions {
+    /**
+     * The channel for which to compute the histogram.
+     * If it is unspecified, the image must have one channel or the method will
+     * throw an error.
+     *
+     * @default 0
+     */
+    channel?: number;
+}
+/**
+ * Returns a histogram of pixel intensities.
+ *
+ * @param image - The original image.
+ * @param options - Histogram options.
+ * @returns - The histogram.
+ */
+export declare function histogram(image: IJS, options?: HistogramOptions): Uint32Array;
+//# sourceMappingURL=histogram.d.ts.map

package/lib/compute/histogram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"histogram.d.ts","sourceRoot":"","sources":["../../src/compute/histogram.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAG7B,MAAM,WAAW,gBAAgB;IAC/B;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,GAAG,EACV,OAAO,GAAE,gBAAqB,GAC7B,WAAW,CAcb"}

package/lib/compute/histogram.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.histogram = void 0;
+const validators_1 = require("../utils/validators");
+/**
+ * Returns a histogram of pixel intensities.
+ *
+ * @param image - The original image.
+ * @param options - Histogram options.
+ * @returns - The histogram.
+ */
+function histogram(image, options = {}) {
+    let { channel } = options;
+    if (typeof channel !== 'number') {
+        if (image.channels !== 1) {
+            throw new Error('channel option is mandatory for multi-channel images');
+        }
+        channel = 0;
+    }
+    (0, validators_1.validateChannel)(channel, image);
+    const hist = new Uint32Array(image.maxValue + 1);
+    for (let i = 0; i < image.size; i++) {
+        hist[image.getValueByIndex(i, channel)]++;
+    }
+    return hist;
+}
+exports.histogram = histogram;
+//# sourceMappingURL=histogram.js.map

package/lib/compute/histogram.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"histogram.js","sourceRoot":"","sources":["../../src/compute/histogram.ts"],"names":[],"mappings":";;;AACA,oDAAsD;AAatD;;;;;;GAMG;AACH,SAAgB,SAAS,CACvB,KAAU,EACV,UAA4B,EAAE;IAE9B,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAC1B,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE;QAC/B,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC,EAAE;YACxB,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;SACzE;QACD,OAAO,GAAG,CAAC,CAAC;KACb;IACD,IAAA,4BAAe,EAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,IAAI,WAAW,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IACjD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QACnC,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;KAC3C;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAjBD,8BAiBC"}

package/lib/compute/index.d.ts

@@ -0,0 +1,2 @@
+export * from './histogram';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/compute/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/lib/compute/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./histogram"), exports);
+//# sourceMappingURL=index.js.map