image-js 0.33.1 → 0.34.1

package/index.d.ts

@@ -32,7 +32,7 @@ export declare class Image {
   static createFrom(other: Image, options: ImageConstructorOptions): Image;
   static load(
     image: string | ArrayBuffer | Uint8Array,
-    options?: RequestInit,
+    options?: RequestInit & { ignorePalette: boolean },
   ): Promise<Image>;
 
   getRoiManager(): RoiManager;
@@ -145,11 +145,31 @@ export declare class Image {
   // extract
   // floodFill
   // paintLabels
-  // paintMasks
+  paintMasks(
+    masks: Image | Array<Image>,
+    options?: {
+      color?: Array<number> | string;
+      colors?: Array<Array<number>> | Array<string>;
+      randomColors?: boolean;
+      distinctColors?: boolean;
+      alpha?: number;
+      labels?: Array<string>;
+      labelsPosition?: Array<Array<number>>;
+      labelColor?: string;
+      labelFont?: string;
+    },
+  ): Image;
   // paintPoints
   // paintPolyline
   // paintPolylines
-  // paintPolygon
+  paintPolygon(
+    points: Array<Array<number>>,
+    options?: {
+      color?: Array<number>;
+      filled?: boolean;
+    },
+  ): Image;
+
   // paintPolygons
 
   // countAlphaPixels

package/lib/image/core/load.js

@@ -34,7 +34,10 @@ const isDataURL = /^data:[a-z]+\/(?:[a-z]+);base64,/;
  * @static
  * @param {string|ArrayBuffer|Buffer|Uint8Array} image - URL of the image (browser, can be a dataURL) or path (Node.js)
  * or buffer containing the binary data
- * @param {object} [options] - In the browser, the options object is passed to the underlying `fetch` call.
+ * @param {object} [options] - In the browser, the options object is passed to the underlying `fetch` call, along with
+ * the data URL. For binary data, the option specify decoding options.
+ * @param {boolean} [options.ignorePalette] - When set to true and loading a tiff from binary data, if the tiff is of
+ * type 3 (palette), load as single channel greyscale rather than as a pseudo-colored RGB.
  * @return {Promise<Image>}
  * @example
  * const image = await Image.load('https://example.com/image.png');
@@ -44,15 +47,15 @@ function load(image, options) {
   if (typeof image === 'string') {
     return loadURL(image, options);
   } else if (image instanceof ArrayBuffer) {
-    return Promise.resolve(loadBinary(new Uint8Array(image)));
+    return Promise.resolve(loadBinary(new Uint8Array(image), undefined, options && options.ignorePalette));
   } else if (image.buffer) {
-    return Promise.resolve(loadBinary(image));
+    return Promise.resolve(loadBinary(image, undefined, options && options.ignorePalette));
   } else {
     throw new Error('argument to "load" must be a string or buffer.');
   }
 }
 
-function loadBinary(image, base64Url) {
+function loadBinary(image, base64Url, ignorePalette) {
   const type = (0, _imageType.default)(image);
 
   if (type) {
@@ -64,7 +67,7 @@ function loadBinary(image, base64Url) {
         return loadJPEG(image);
 
       case 'image/tiff':
-        return loadTIFF(image);
+        return loadTIFF(image, ignorePalette);
 
       default:
         return loadGeneric(getBase64(type.mime));
@@ -94,7 +97,7 @@ function loadURL(url, options) {
 
   return binaryDataP.then(binaryData => {
     const uint8 = new Uint8Array(binaryData);
-    return loadBinary(uint8, dataURL ? url : undefined);
+    return loadBinary(uint8, dataURL ? url : undefined, options && options.ignorePalette);
   });
 }
 
@@ -195,13 +198,15 @@ function loadJPEG(data) {
   return image;
 }
 
-function loadTIFF(data) {
+function loadTIFF(data, ignorePalette) {
   let result = (0, _tiff.decode)(data);
 
   if (result.length === 1) {
-    return getImageFromIFD(result[0]);
+    return getImageFromIFD(result[0], ignorePalette);
   } else {
-    return new _Stack.default(result.map(getImageFromIFD));
+    return new _Stack.default(result.map(function (image) {
+      return getImageFromIFD(image, ignorePalette);
+    }));
   }
 }
 
@@ -224,8 +229,8 @@ function getMetadata(image) {
   return metadata;
 }
 
-function getImageFromIFD(image) {
-  if (image.type === 3) {
+function getImageFromIFD(image, ignorePalette) {
+  if (!ignorePalette && image.type === 3) {
     // Palette
     const data = new Uint16Array(3 * image.width * image.height);
     const palette = image.palette;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "image-js",
-  "version": "0.33.1",
+  "version": "0.34.1",
   "description": "Image processing and manipulation in JavaScript",
   "keywords": [
     "image",

package/src/browser/worker/worker.js

@@ -26,6 +26,7 @@ class Worker {
     let manager;
     let url;
     let runner = {};
+
     function run(...args) {
       if (!manager) {
         this.checkUrl();
@@ -35,6 +36,7 @@ class Worker {
       }
       return method.run.call(runner, ...args);
     }
+
     run.reset = function () {
       if (manager) {
         manager.terminate();

package/src/image/core/export.js

@@ -125,10 +125,12 @@ const exportMethods = {
     }
     const { useCanvas = false, encoder: encoderOptions = undefined } = options;
     type = getType(type);
+
     function dataUrl(encoder, ctx) {
       const u8 = encoder(ctx, encoderOptions);
       return toBase64URL(u8, type);
     }
+
     if (type === 'image/bmp') {
       return dataUrl(encodeBmp, this);
     } else if (type === 'image/png' && !useCanvas) {

package/src/image/core/load.js

@@ -19,7 +19,10 @@ const isDataURL = /^data:[a-z]+\/(?:[a-z]+);base64,/;
  * @static
  * @param {string|ArrayBuffer|Buffer|Uint8Array} image - URL of the image (browser, can be a dataURL) or path (Node.js)
  * or buffer containing the binary data
- * @param {object} [options] - In the browser, the options object is passed to the underlying `fetch` call.
+ * @param {object} [options] - In the browser, the options object is passed to the underlying `fetch` call, along with
+ * the data URL. For binary data, the option specify decoding options.
+ * @param {boolean} [options.ignorePalette] - When set to true and loading a tiff from binary data, if the tiff is of
+ * type 3 (palette), load as single channel greyscale rather than as a pseudo-colored RGB.
  * @return {Promise<Image>}
  * @example
  * const image = await Image.load('https://example.com/image.png');
@@ -28,15 +31,23 @@ export default function load(image, options) {
   if (typeof image === 'string') {
     return loadURL(image, options);
   } else if (image instanceof ArrayBuffer) {
-    return Promise.resolve(loadBinary(new Uint8Array(image)));
+    return Promise.resolve(
+      loadBinary(
+        new Uint8Array(image),
+        undefined,
+        options && options.ignorePalette,
+      ),
+    );
   } else if (image.buffer) {
-    return Promise.resolve(loadBinary(image));
+    return Promise.resolve(
+      loadBinary(image, undefined, options && options.ignorePalette),
+    );
   } else {
     throw new Error('argument to "load" must be a string or buffer.');
   }
 }
 
-function loadBinary(image, base64Url) {
+function loadBinary(image, base64Url, ignorePalette) {
   const type = imageType(image);
   if (type) {
     switch (type.mime) {
@@ -45,12 +56,13 @@ function loadBinary(image, base64Url) {
       case 'image/jpeg':
         return loadJPEG(image);
       case 'image/tiff':
-        return loadTIFF(image);
+        return loadTIFF(image, ignorePalette);
       default:
         return loadGeneric(getBase64(type.mime));
     }
   }
   return loadGeneric(getBase64('application/octet-stream'));
+
   function getBase64(type) {
     if (base64Url) {
       return base64Url;
@@ -70,7 +82,11 @@ function loadURL(url, options) {
   }
   return binaryDataP.then((binaryData) => {
     const uint8 = new Uint8Array(binaryData);
-    return loadBinary(uint8, dataURL ? url : undefined);
+    return loadBinary(
+      uint8,
+      dataURL ? url : undefined,
+      options && options.ignorePalette,
+    );
   });
 }
 
@@ -159,12 +175,16 @@ function loadJPEG(data) {
   return image;
 }
 
-function loadTIFF(data) {
+function loadTIFF(data, ignorePalette) {
   let result = decodeTiff(data);
   if (result.length === 1) {
-    return getImageFromIFD(result[0]);
+    return getImageFromIFD(result[0], ignorePalette);
   } else {
-    return new Stack(result.map(getImageFromIFD));
+    return new Stack(
+      result.map(function (image) {
+        return getImageFromIFD(image, ignorePalette);
+      }),
+    );
   }
 }
 
@@ -184,8 +204,8 @@ function getMetadata(image) {
   return metadata;
 }
 
-function getImageFromIFD(image) {
-  if (image.type === 3) {
+function getImageFromIFD(image, ignorePalette) {
+  if (!ignorePalette && image.type === 3) {
     // Palette
     const data = new Uint16Array(3 * image.width * image.height);
     const palette = image.palette;

package/src/image/roi/creator/fromMask.js

@@ -151,5 +151,6 @@ export default function fromMask(mask, options = {}) {
       }
     }
   }
+
   return new RoiMap(mask, data);
 }

package/src/image/transform/mask/minimum.js

@@ -31,6 +31,7 @@ export default function minimum(histogram) {
   threshold = minimumBetweenPeeks(histogramCopy, max);
   return threshold;
 }
+
 function smoothed(histogram) {
   // Smooth with a 3 point running mean filter
   let auHistogram = new Array(histogram.length); // a copy of the histograma for the smoothing process
@@ -42,6 +43,7 @@ function smoothed(histogram) {
     (histogram[histogram.length - 2] + histogram[histogram.length - 1]) / 3;
   return auHistogram;
 }
+
 function minimumBetweenPeeks(histogramBimodal, max) {
   let threshold;
   for (let i = 1; i < max; i++) {
@@ -55,6 +57,7 @@ function minimumBetweenPeeks(histogramBimodal, max) {
   }
   return threshold;
 }
+
 function bimodalTest(histogram) {
   // It is responsible for determining if a histogram is bimodal
   let len = histogram.length;