image-js 0.0.0-next-e30968a2d8

package/lib-esm/roi/utils/constants.d.ts

@@ -0,0 +1,4 @@
+export declare const maxNumberRois: number;
+export declare const maxRoiId: number;
+export declare const colorMapCenter: number;
+//# sourceMappingURL=constants.d.ts.map

package/lib-esm/roi/utils/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/roi/utils/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,QAAU,CAAC;AACrC,eAAO,MAAM,QAAQ,QAAoB,CAAC;AAC1C,eAAO,MAAM,cAAc,QAAoB,CAAC"}

package/lib-esm/roi/utils/constants.js

@@ -0,0 +1,4 @@
+export const maxNumberRois = 2 ** 16;
+export const maxRoiId = maxNumberRois / 2;
+export const colorMapCenter = maxNumberRois / 2;
+//# sourceMappingURL=constants.js.map

package/lib-esm/roi/utils/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/roi/utils/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,CAAC;AACrC,MAAM,CAAC,MAAM,QAAQ,GAAG,aAAa,GAAG,CAAC,CAAC;AAC1C,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,GAAG,CAAC,CAAC"}

package/lib-esm/roi/utils/getColorMap.d.ts

@@ -0,0 +1,32 @@
+import { RoiKind } from '../RoiManager';
+import { RoisColorMode } from '../colorRois';
+export interface GetColorMapOptions {
+    /**
+     * Number of black ROIs
+     */
+    nbNegative: number;
+    /**
+     * Number of white ID ROIs
+     */
+    nbPositive: number;
+    /**
+     * Specify the mode: what colors to use in the color map
+     *
+     * @default ColorMode.BINARY
+     */
+    mode?: RoisColorMode;
+    /**
+     * Specify which ROIs to colour.
+     *
+     * @default RoiKind.BW
+     */
+    roiKind?: RoiKind;
+}
+/**
+ * Return a map of 32 bits integers corresponding to the colors of each ROI.
+ *
+ * @param options - Get color map options.
+ * @returns The color map.
+ */
+export declare function getColorMap(options: GetColorMapOptions): Uint32Array;
+//# sourceMappingURL=getColorMap.d.ts.map

package/lib-esm/roi/utils/getColorMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getColorMap.d.ts","sourceRoot":"","sources":["../../../src/roi/utils/getColorMap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAM7C,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,IAAI,CAAC,EAAE,aAAa,CAAC;IAErB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAapE"}

package/lib-esm/roi/utils/getColorMap.js

@@ -0,0 +1,24 @@
+import { RoisColorMode } from '../colorRois';
+import { getBinaryMap } from './colorMaps/getBinaryMap';
+import { getRainbowMap } from './colorMaps/getRainbowMap';
+import { getSaturationMap } from './colorMaps/getSaturationMap';
+/**
+ * Return a map of 32 bits integers corresponding to the colors of each ROI.
+ *
+ * @param options - Get color map options.
+ * @returns The color map.
+ */
+export function getColorMap(options) {
+    const { mode = RoisColorMode.BINARY } = options;
+    switch (mode) {
+        case RoisColorMode.BINARY:
+            return getBinaryMap(options);
+        case RoisColorMode.SATURATION:
+            return getSaturationMap(options);
+        case RoisColorMode.RAINBOW:
+            return getRainbowMap(options);
+        default:
+            throw new Error('getColorMap: unknown color mode');
+    }
+}
+//# sourceMappingURL=getColorMap.js.map

package/lib-esm/roi/utils/getColorMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getColorMap.js","sourceRoot":"","sources":["../../../src/roi/utils/getColorMap.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AA0BhE;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,OAA2B;IACrD,MAAM,EAAE,IAAI,GAAG,aAAa,CAAC,MAAM,EAAE,GAAG,OAAO,CAAC;IAEhD,QAAQ,IAAI,EAAE;QACZ,KAAK,aAAa,CAAC,MAAM;YACvB,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;QAC/B,KAAK,aAAa,CAAC,UAAU;YAC3B,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACnC,KAAK,aAAa,CAAC,OAAO;YACxB,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC;QAChC;YACE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;KACtD;AACH,CAAC"}

package/lib-esm/roi/utils/hsvToRgb.d.ts

@@ -0,0 +1,21 @@
+export interface HsvColor {
+    h: number;
+    s: number;
+    v: number;
+}
+export interface RgbColor {
+    r: number;
+    g: number;
+    b: number;
+}
+/**
+ * Convert HSV (hue, saturation, value) color code to RGB.
+ * - Hue: angle in the color wheel (from red to purple), in range 0->359
+ * - Saturation: how strong the color is (from white to bright color), in range 0-255
+ * - Value: basically the brightness (from black to intense color), in range 0-255
+ *
+ * @param hsv - The HSV color.
+ * @returns The RGB color.
+ */
+export declare function hsvToRgb(hsv: number[]): Uint8Array;
+//# sourceMappingURL=hsvToRgb.d.ts.map

package/lib-esm/roi/utils/hsvToRgb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hsvToRgb.d.ts","sourceRoot":"","sources":["../../../src/roi/utils/hsvToRgb.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AACD,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,UAAU,CAyClD"}

package/lib-esm/roi/utils/hsvToRgb.js

@@ -0,0 +1,54 @@
+/**
+ * Convert HSV (hue, saturation, value) color code to RGB.
+ * - Hue: angle in the color wheel (from red to purple), in range 0->359
+ * - Saturation: how strong the color is (from white to bright color), in range 0-255
+ * - Value: basically the brightness (from black to intense color), in range 0-255
+ *
+ * @param hsv - The HSV color.
+ * @returns The RGB color.
+ */
+export function hsvToRgb(hsv) {
+    const h = hsv[0];
+    const s = hsv[1] / 255;
+    const v = hsv[2] / 255;
+    const C = s * v;
+    const X = C * (1 - Math.abs(((h / 60) % 2) - 1));
+    const m = v - C;
+    let r, g, b;
+    if (h >= 0 && h < 60) {
+        r = C;
+        g = X;
+        b = 0;
+    }
+    else if (h >= 60 && h < 120) {
+        r = X;
+        g = C;
+        b = 0;
+    }
+    else if (h >= 120 && h < 180) {
+        r = 0;
+        g = C;
+        b = X;
+    }
+    else if (h >= 180 && h < 240) {
+        r = 0;
+        g = X;
+        b = C;
+    }
+    else if (h >= 240 && h < 300) {
+        r = X;
+        g = 0;
+        b = C;
+    }
+    else {
+        r = C;
+        g = 0;
+        b = X;
+    }
+    let rgb = new Uint8Array(3);
+    rgb[0] = (r + m) * 255;
+    rgb[1] = (g + m) * 255;
+    rgb[2] = (b + m) * 255;
+    return rgb;
+}
+//# sourceMappingURL=hsvToRgb.js.map

package/lib-esm/roi/utils/hsvToRgb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hsvToRgb.js","sourceRoot":"","sources":["../../../src/roi/utils/hsvToRgb.ts"],"names":[],"mappings":"AAWA;;;;;;;;GAQG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAa;IACpC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IACjB,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;IACvB,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;IACvB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACjD,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAEhB,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAEZ,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE;QACpB,CAAC,GAAG,CAAC,CAAC;QACN,CAAC,GAAG,CAAC,CAAC;QACN,CAAC,GAAG,CAAC,CAAC;KACP;SAAM,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,GAAG,EAAE;QAC7B,CAAC,GAAG,CAAC,CAAC;QACN,CAAC,GAAG,CAAC,CAAC;QACN,CAAC,GAAG,CAAC,CAAC;KACP;SAAM,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,GAAG,EAAE;QAC9B,CAAC,GAAG,CAAC,CAAC;QACN,CAAC,GAAG,CAAC,CAAC;QACN,CAAC,GAAG,CAAC,CAAC;KACP;SAAM,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,GAAG,EAAE;QAC9B,CAAC,GAAG,CAAC,CAAC;QACN,CAAC,GAAG,CAAC,CAAC;QACN,CAAC,GAAG,CAAC,CAAC;KACP;SAAM,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,GAAG,EAAE;QAC9B,CAAC,GAAG,CAAC,CAAC;QACN,CAAC,GAAG,CAAC,CAAC;QACN,CAAC,GAAG,CAAC,CAAC;KACP;SAAM;QACL,CAAC,GAAG,CAAC,CAAC;QACN,CAAC,GAAG,CAAC,CAAC;QACN,CAAC,GAAG,CAAC,CAAC;KACP;IAED,IAAI,GAAG,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IAC5B,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;IACvB,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;IACvB,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;IACvB,OAAO,GAAG,CAAC;AACb,CAAC"}

package/lib-esm/roi/utils/rgbToNumber.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Convert RGB array to 32 bits number where alpha is set to 255.
+ *
+ * @param rgb - The RGB color array
+ * @returns 32 bits number encoding RGBA color
+ */
+export declare function rgbToNumber(rgb: Uint8Array): number;
+//# sourceMappingURL=rgbToNumber.d.ts.map

package/lib-esm/roi/utils/rgbToNumber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rgbToNumber.d.ts","sourceRoot":"","sources":["../../../src/roi/utils/rgbToNumber.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAEnD"}

package/lib-esm/roi/utils/rgbToNumber.js

@@ -0,0 +1,10 @@
+/**
+ * Convert RGB array to 32 bits number where alpha is set to 255.
+ *
+ * @param rgb - The RGB color array
+ * @returns 32 bits number encoding RGBA color
+ */
+export function rgbToNumber(rgb) {
+    return 0xff000000 + (rgb[2] << 16) + (rgb[1] << 8) + rgb[0];
+}
+//# sourceMappingURL=rgbToNumber.js.map

package/lib-esm/roi/utils/rgbToNumber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rgbToNumber.js","sourceRoot":"","sources":["../../../src/roi/utils/rgbToNumber.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,GAAe;IACzC,OAAO,UAAU,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;AAC9D,CAAC"}

package/lib-esm/save/encode.d.ts

@@ -0,0 +1,38 @@
+import { IJS } from '../IJS';
+import { EncodeJpegOptions } from './encodeJpeg';
+import { EncodePngOptions } from './encodePng';
+export declare enum ImageFormat {
+    png = "png",
+    jpg = "jpg",
+    jpeg = "jpeg"
+}
+export interface EncodeOptionsPng {
+    format: ImageFormat.png;
+    encoderOptions?: EncodePngOptions;
+}
+export interface EncodeOptionsJpeg {
+    format: ImageFormat.jpg | ImageFormat.jpeg;
+    encoderOptions?: EncodeJpegOptions;
+}
+/**
+ * Encodes the image to an output format.
+ * Defaults to PNG.
+ *
+ * @param image - Image to encode.
+ */
+export declare function encode(image: IJS): Uint8Array;
+/**
+ * Encodes the image to PNG.
+ *
+ * @param image - Image to encode.
+ * @param options - Format and options passed to the PNG encoder.
+ */
+export declare function encode(image: IJS, options: EncodeOptionsPng): Uint8Array;
+/**
+ * Encodes the image to JPEG.
+ *
+ * @param image - Image to encode.
+ * @param options - Format and options passed to the JPEG encoder.
+ */
+export declare function encode(image: IJS, options: EncodeOptionsJpeg): Uint8Array;
+//# sourceMappingURL=encode.d.ts.map

package/lib-esm/save/encode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encode.d.ts","sourceRoot":"","sources":["../../src/save/encode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAE7B,OAAO,EAAc,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAa,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE1D,oBAAY,WAAW;IACrB,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,IAAI,SAAS;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC;IACxB,cAAc,CAAC,EAAE,gBAAgB,CAAC;CACnC;AACD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,WAAW,CAAC,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC;IAC3C,cAAc,CAAC,EAAE,iBAAiB,CAAC;CACpC;AAID;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,GAAG,GAAG,UAAU,CAAC;AAC/C;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,gBAAgB,GAAG,UAAU,CAAC;AAC1E;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAAC"}

package/lib-esm/save/encode.js

@@ -0,0 +1,29 @@
+import { encodeJpeg } from './encodeJpeg';
+import { encodePng } from './encodePng';
+export var ImageFormat;
+(function (ImageFormat) {
+    ImageFormat["png"] = "png";
+    ImageFormat["jpg"] = "jpg";
+    ImageFormat["jpeg"] = "jpeg";
+})(ImageFormat || (ImageFormat = {}));
+const defaultPng = { format: ImageFormat.png };
+/**
+ * Encode an image in JPEG or PNG format.
+ *
+ * @param image - Image to encode.
+ * @param options - Encoding options.
+ * @returns The encoded image.
+ */
+export function encode(image, options = defaultPng) {
+    if (options.format === ImageFormat.png) {
+        return encodePng(image, options.encoderOptions);
+    }
+    else if (options.format === ImageFormat.jpg ||
+        options.format === ImageFormat.jpeg) {
+        return encodeJpeg(image, options.encoderOptions);
+    }
+    else {
+        throw new RangeError(`unknown format: ${options.format}`);
+    }
+}
+//# sourceMappingURL=encode.js.map

package/lib-esm/save/encode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encode.js","sourceRoot":"","sources":["../../src/save/encode.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAqB,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAoB,MAAM,aAAa,CAAC;AAE1D,MAAM,CAAN,IAAY,WAIX;AAJD,WAAY,WAAW;IACrB,0BAAW,CAAA;IACX,0BAAW,CAAA;IACX,4BAAa,CAAA;AACf,CAAC,EAJW,WAAW,KAAX,WAAW,QAItB;AAWD,MAAM,UAAU,GAAqB,EAAE,MAAM,EAAE,WAAW,CAAC,GAAG,EAAE,CAAC;AAuBjE;;;;;;GAMG;AACH,MAAM,UAAU,MAAM,CACpB,KAAU,EACV,UAAgD,UAAU;IAE1D,IAAI,OAAO,CAAC,MAAM,KAAK,WAAW,CAAC,GAAG,EAAE;QACtC,OAAO,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;KACjD;SAAM,IACL,OAAO,CAAC,MAAM,KAAK,WAAW,CAAC,GAAG;QAClC,OAAO,CAAC,MAAM,KAAK,WAAW,CAAC,IAAI,EACnC;QACA,OAAO,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;KAClD;SAAM;QACL,MAAM,IAAI,UAAU,CAAC,mBAAmB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;KAC3D;AACH,CAAC"}

package/lib-esm/save/encodeJpeg.d.ts

@@ -0,0 +1,18 @@
+import { IJS } from '../IJS';
+export interface EncodeJpegOptions {
+    /**
+     * Defines jpeg quality. Integer value between 1 and 100%, 100% being the best quality.
+     *
+     * @default 50
+     */
+    quality?: number;
+}
+/**
+ * Creates a JPEG buffer from an image.
+ *
+ * @param image - The image instance.
+ * @param options - JPEG encoding options.
+ * @returns The buffer.
+ */
+export declare function encodeJpeg(image: IJS, options?: EncodeJpegOptions): Uint8Array;
+//# sourceMappingURL=encodeJpeg.d.ts.map

package/lib-esm/save/encodeJpeg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encodeJpeg.d.ts","sourceRoot":"","sources":["../../src/save/encodeJpeg.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,GAAG,EAA+B,MAAM,QAAQ,CAAC;AAE1D,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,GAAG,EACV,OAAO,GAAE,iBAAsB,GAC9B,UAAU,CAaZ"}

package/lib-esm/save/encodeJpeg.js

@@ -0,0 +1,22 @@
+import { encode } from 'jpeg-js';
+import { ImageColorModel, ColorDepth } from '../IJS';
+/**
+ * Creates a JPEG buffer from an image.
+ *
+ * @param image - The image instance.
+ * @param options - JPEG encoding options.
+ * @returns The buffer.
+ */
+export function encodeJpeg(image, options = {}) {
+    const { quality = 50 } = options;
+    if (image.colorModel !== ImageColorModel.RGBA) {
+        image = image.convertColor(ImageColorModel.RGBA);
+    }
+    if (image.depth !== ColorDepth.UINT8) {
+        image = image.convertDepth(ColorDepth.UINT8);
+    }
+    // Image data after depth conversion will always be UInt8Array
+    const buffer = encode(image.getRawImage(), quality).data;
+    return new Uint8Array(buffer, buffer.byteOffset, buffer.byteLength);
+}
+//# sourceMappingURL=encodeJpeg.js.map

package/lib-esm/save/encodeJpeg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encodeJpeg.js","sourceRoot":"","sources":["../../src/save/encodeJpeg.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,OAAO,EAAO,eAAe,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAW1D;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CACxB,KAAU,EACV,UAA6B,EAAE;IAE/B,MAAM,EAAE,OAAO,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAEjC,IAAI,KAAK,CAAC,UAAU,KAAK,eAAe,CAAC,IAAI,EAAE;QAC7C,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;KAClD;IACD,IAAI,KAAK,CAAC,KAAK,KAAK,UAAU,CAAC,KAAK,EAAE;QACpC,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;KAC9C;IAED,8DAA8D;IAC9D,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;IACzD,OAAO,IAAI,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;AACtE,CAAC"}

package/lib-esm/save/encodePng.d.ts

@@ -0,0 +1,12 @@
+import { PngEncoderOptions } from 'fast-png';
+import { IJS } from '../IJS';
+export declare type EncodePngOptions = PngEncoderOptions;
+/**
+ * Creates a PNG buffer from an image.
+ *
+ * @param image - The image instance.
+ * @param options - PNG encoding options.
+ * @returns The buffer.
+ */
+export declare function encodePng(image: IJS, options?: EncodePngOptions): Uint8Array;
+//# sourceMappingURL=encodePng.d.ts.map

package/lib-esm/save/encodePng.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encodePng.d.ts","sourceRoot":"","sources":["../../src/save/encodePng.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAErD,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAE7B,oBAAY,gBAAgB,GAAG,iBAAiB,CAAC;AAEjD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,UAAU,CAE5E"}

package/lib-esm/save/encodePng.js

@@ -0,0 +1,12 @@
+import { encode } from 'fast-png';
+/**
+ * Creates a PNG buffer from an image.
+ *
+ * @param image - The image instance.
+ * @param options - PNG encoding options.
+ * @returns The buffer.
+ */
+export function encodePng(image, options) {
+    return encode(image.getRawImage(), options);
+}
+//# sourceMappingURL=encodePng.js.map

package/lib-esm/save/encodePng.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encodePng.js","sourceRoot":"","sources":["../../src/save/encodePng.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAqB,MAAM,UAAU,CAAC;AAMrD;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,KAAU,EAAE,OAA0B;IAC9D,OAAO,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC,CAAC;AAC9C,CAAC"}

package/lib-esm/save/index.d.ts

@@ -0,0 +1,6 @@
+export * from './encode';
+export * from './encodePng';
+export * from './encodeJpeg';
+export * from './write';
+export * from './writeCanvas';
+//# sourceMappingURL=index.d.ts.map

package/lib-esm/save/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/save/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC"}

package/lib-esm/save/index.js

@@ -0,0 +1,6 @@
+export * from './encode';
+export * from './encodePng';
+export * from './encodeJpeg';
+export * from './write';
+export * from './writeCanvas';
+//# sourceMappingURL=index.js.map

package/lib-esm/save/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/save/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC"}

package/lib-esm/save/write.d.ts

@@ -0,0 +1,27 @@
+import { Mask, IJS } from '..';
+import { EncodeOptionsPng, EncodeOptionsJpeg } from './encode';
+/**
+ * Write an image to the disk.
+ * The file format is determined automatically from the file's extension.
+ * If the extension is not supported, an error will be thrown.
+ */
+export declare function write(path: string, image: IJS | Mask): Promise<void>;
+/**
+ * Write an image to the disk as PNG.
+ * When the `png` format is specified, the file's extension doesn't matter.
+ */
+export declare function write(path: string, image: IJS | Mask, options: EncodeOptionsPng): Promise<void>;
+/**
+ * Write an image to the disk as JPEG.
+ * When the `jpeg` format is specified, the file's extension doesn't matter.
+ */
+export declare function write(path: string, image: IJS | Mask, options: EncodeOptionsJpeg): Promise<void>;
+/**
+ * Synchronous version of @see {@link write}.
+ *
+ * @param path - Path where the image should be written.
+ * @param image - Image to save.
+ * @param options - Encode options.
+ */
+export declare function writeSync(path: string, image: IJS | Mask, options?: EncodeOptionsPng | EncodeOptionsJpeg): void;
+//# sourceMappingURL=write.d.ts.map

package/lib-esm/save/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/save/write.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,IAAI,EAAE,GAAG,EAAmB,MAAM,IAAI,CAAC;AAEhD,OAAO,EAGL,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAElB;;;;GAIG;AACH,wBAAsB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAC5E;;;GAGG;AACH,wBAAsB,KAAK,CACzB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,GAAG,GAAG,IAAI,EACjB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CAAC;AACjB;;;GAGG;AACH,wBAAsB,KAAK,CACzB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,GAAG,GAAG,IAAI,EACjB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAAC;AAoBjB;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,GAAG,GAAG,IAAI,EACjB,OAAO,CAAC,EAAE,gBAAgB,GAAG,iBAAiB,GAC7C,IAAI,CAMN"}

package/lib-esm/save/write.js

@@ -0,0 +1,65 @@
+import fs from 'fs';
+import path from 'path';
+import { Mask, ImageColorModel } from '..';
+import { encode, ImageFormat, } from './encode';
+/**
+ * Asynchronously write an image to the disk.
+ *
+ * @param path - Path where the image should be written.
+ * @param image - Image to save.
+ * @param options - Encode options.
+ */
+export async function write(path, image, options) {
+    if (image instanceof Mask) {
+        image = image.convertColor(ImageColorModel.GREY);
+    }
+    const toWrite = getDataToWrite(path, image, options);
+    await fs.promises.writeFile(path, toWrite);
+}
+/**
+ * Synchronous version of @see {@link write}.
+ *
+ * @param path - Path where the image should be written.
+ * @param image - Image to save.
+ * @param options - Encode options.
+ */
+export function writeSync(path, image, options) {
+    if (image instanceof Mask) {
+        image = image.convertColor(ImageColorModel.GREY);
+    }
+    const toWrite = getDataToWrite(path, image, options);
+    fs.writeFileSync(path, toWrite);
+}
+/**
+ * @param destinationPath
+ * @param image - Image to save.
+ * @param options - Encode options.
+ */
+function getDataToWrite(destinationPath, image, options) {
+    let format;
+    if (options === undefined) {
+        const extension = path.extname(destinationPath).slice(1).toLowerCase();
+        if (extension === 'png') {
+            format = ImageFormat.png;
+            return encode(image, { format });
+        }
+        else if (extension === 'jpg' || extension === 'jpeg') {
+            format = ImageFormat.jpg;
+            return encode(image, { format });
+        }
+        else {
+            throw new Error('image format could not be determined from file extension. Please use a supported extension or specify the format option');
+        }
+    }
+    else if (options.format === ImageFormat.png) {
+        return encode(image, options);
+    }
+    else if (options.format === ImageFormat.jpg ||
+        options.format === ImageFormat.jpeg) {
+        return encode(image, options);
+    }
+    else {
+        throw new RangeError(`unknown format: ${options.format}`);
+    }
+}
+//# sourceMappingURL=write.js.map

package/lib-esm/save/write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../../src/save/write.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,IAAI,EAAO,eAAe,EAAE,MAAM,IAAI,CAAC;AAEhD,OAAO,EACL,MAAM,EACN,WAAW,GAGZ,MAAM,UAAU,CAAC;AA0BlB;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,IAAY,EACZ,KAAiB,EACjB,OAA8C;IAE9C,IAAI,KAAK,YAAY,IAAI,EAAE;QACzB,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;KAClD;IACD,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACrD,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CACvB,IAAY,EACZ,KAAiB,EACjB,OAA8C;IAE9C,IAAI,KAAK,YAAY,IAAI,EAAE;QACzB,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;KAClD;IACD,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACrD,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAClC,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc,CACrB,eAAuB,EACvB,KAAU,EACV,OAA8C;IAE9C,IAAI,MAAmB,CAAC;IACxB,IAAI,OAAO,KAAK,SAAS,EAAE;QACzB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QACvE,IAAI,SAAS,KAAK,KAAK,EAAE;YACvB,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC;YACzB,OAAO,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;SAClC;aAAM,IAAI,SAAS,KAAK,KAAK,IAAI,SAAS,KAAK,MAAM,EAAE;YACtD,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC;YACzB,OAAO,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;SAClC;aAAM;YACL,MAAM,IAAI,KAAK,CACb,yHAAyH,CAC1H,CAAC;SACH;KACF;SAAM,IAAI,OAAO,CAAC,MAAM,KAAK,WAAW,CAAC,GAAG,EAAE;QAC7C,OAAO,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;KAC/B;SAAM,IACL,OAAO,CAAC,MAAM,KAAK,WAAW,CAAC,GAAG;QAClC,OAAO,CAAC,MAAM,KAAK,WAAW,CAAC,IAAI,EACnC;QACA,OAAO,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;KAC/B;SAAM;QACL,MAAM,IAAI,UAAU,CAAC,mBAAmB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;KAC3D;AACH,CAAC"}

package/lib-esm/save/writeCanvas.d.ts

@@ -0,0 +1,42 @@
+import { IJS } from '../IJS';
+export interface WriteCanvasOptions {
+    /**
+     * If set to `true`, the canvas element will be resized to fit the image.
+     *
+     * @default true
+     */
+    resizeCanvas?: boolean;
+    /**
+     * @default 0
+     */
+    dx?: number;
+    /**
+     * @default 0
+     */
+    dy?: number;
+    /**
+     * @default 0
+     */
+    dirtyX?: number;
+    /**
+     * @default 0
+     */
+    dirtyY?: number;
+    /**
+     * @default image.width
+     */
+    dirtyWidth?: number;
+    /**
+     * @default image.height
+     */
+    dirtyHeight?: number;
+}
+/**
+ * Draw the image in an HTML canvas.
+ *
+ * @param image - The image to draw.
+ * @param canvas - The HTML canvas.
+ * @param options - Write canvas options.
+ */
+export declare function writeCanvas(image: IJS, canvas: HTMLCanvasElement, options?: WriteCanvasOptions): void;
+//# sourceMappingURL=writeCanvas.d.ts.map

package/lib-esm/save/writeCanvas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeCanvas.d.ts","sourceRoot":"","sources":["../../src/save/writeCanvas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAmB,MAAM,QAAQ,CAAC;AAE9C,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,GAAG,EACV,MAAM,EAAE,iBAAiB,EACzB,OAAO,GAAE,kBAAuB,GAC/B,IAAI,CAmCN"}

package/lib-esm/save/writeCanvas.js

@@ -0,0 +1,25 @@
+import { ImageColorModel } from '../IJS';
+/**
+ * Draw the image in an HTML canvas.
+ *
+ * @param image - The image to draw.
+ * @param canvas - The HTML canvas.
+ * @param options - Write canvas options.
+ */
+export function writeCanvas(image, canvas, options = {}) {
+    if (image.colorModel !== ImageColorModel.RGBA) {
+        image = image.convertColor(ImageColorModel.RGBA);
+    }
+    const { resizeCanvas = true, dx = 0, dy = 0, dirtyX = 0, dirtyY = 0, dirtyWidth = image.width, dirtyHeight = image.height, } = options;
+    if (resizeCanvas) {
+        canvas.width = image.width;
+        canvas.height = image.height;
+    }
+    const ctx = canvas.getContext('2d');
+    if (ctx === null) {
+        throw new Error('could not get context from canvas element');
+    }
+    const data = image.getRawImage().data;
+    ctx.putImageData(new ImageData(new Uint8ClampedArray(data.buffer, data.byteOffset, data.byteLength), image.width, image.height), dx, dy, dirtyX, dirtyY, dirtyWidth, dirtyHeight);
+}
+//# sourceMappingURL=writeCanvas.js.map

package/lib-esm/save/writeCanvas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeCanvas.js","sourceRoot":"","sources":["../../src/save/writeCanvas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,eAAe,EAAE,MAAM,QAAQ,CAAC;AAmC9C;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CACzB,KAAU,EACV,MAAyB,EACzB,UAA8B,EAAE;IAEhC,IAAI,KAAK,CAAC,UAAU,KAAK,eAAe,CAAC,IAAI,EAAE;QAC7C,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;KAClD;IACD,MAAM,EACJ,YAAY,GAAG,IAAI,EACnB,EAAE,GAAG,CAAC,EACN,EAAE,GAAG,CAAC,EACN,MAAM,GAAG,CAAC,EACV,MAAM,GAAG,CAAC,EACV,UAAU,GAAG,KAAK,CAAC,KAAK,EACxB,WAAW,GAAG,KAAK,CAAC,MAAM,GAC3B,GAAG,OAAO,CAAC;IACZ,IAAI,YAAY,EAAE;QAChB,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAC3B,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;KAC9B;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,GAAG,KAAK,IAAI,EAAE;QAChB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;KAC9D;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC;IACtC,GAAG,CAAC,YAAY,CACd,IAAI,SAAS,CACX,IAAI,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,EACpE,KAAK,CAAC,KAAK,EACX,KAAK,CAAC,MAAM,CACb,EACD,EAAE,EACF,EAAE,EACF,MAAM,EACN,MAAM,EACN,UAAU,EACV,WAAW,CACZ,CAAC;AACJ,CAAC"}

package/lib-esm/utils/boolToNumber.d.ts

@@ -0,0 +1,9 @@
+import { BitValue } from '../Mask';
+/**
+ * Converts a bit value to the corresponding number.
+ *
+ * @param value - The bit to convert.
+ * @returns The bit value as a number.
+ */
+export declare function boolToNumber(value: BitValue): number;
+//# sourceMappingURL=boolToNumber.d.ts.map

package/lib-esm/utils/boolToNumber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boolToNumber.d.ts","sourceRoot":"","sources":["../../src/utils/boolToNumber.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CASpD"}

package/lib-esm/utils/boolToNumber.js

@@ -0,0 +1,17 @@
+/**
+ * Converts a bit value to the corresponding number.
+ *
+ * @param value - The bit to convert.
+ * @returns The bit value as a number.
+ */
+export function boolToNumber(value) {
+    let result;
+    if (typeof value === 'boolean') {
+        result = value ? 1 : 0;
+    }
+    else {
+        result = value;
+    }
+    return result;
+}
+//# sourceMappingURL=boolToNumber.js.map

package/lib-esm/utils/boolToNumber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boolToNumber.js","sourceRoot":"","sources":["../../src/utils/boolToNumber.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,KAAe;IAC1C,IAAI,MAAM,CAAC;IACX,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE;QAC9B,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KACxB;SAAM;QACL,MAAM,GAAG,KAAK,CAAC;KAChB;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/lib-esm/utils/borderIterator.d.ts

@@ -0,0 +1,9 @@
+import { Mask, IJS } from '..';
+/**
+ * Create function that allows to iterate on the pixels of the border of an image.
+ *
+ * @param image - Image for which to create the border iterator.
+ * @yields - Index of the border pixel.
+ */
+export declare function borderIterator(image: IJS | Mask): Generator<number, void, unknown>;
+//# sourceMappingURL=borderIterator.d.ts.map

package/lib-esm/utils/borderIterator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"borderIterator.d.ts","sourceRoot":"","sources":["../../src/utils/borderIterator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,IAAI,CAAC;AAE/B;;;;;GAKG;AACH,wBAAiB,cAAc,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI,oCAahD"}