image-js 1.1.0 → 1.3.0

package/dist/image-js.esm.js

@@ -1,5 +1,5 @@
 /*
- * image-js v1.1.0
+ * image-js v1.3.0
  * Image processing and manipulation in JavaScript
  * https://github.com/image-js/image-js#readme
  *
@@ -5109,11 +5109,11 @@ matrix.solve = solve;
 matrix.wrap = wrap;
 
 const EigenvalueDecomposition = EigenvalueDecomposition_1;
-const Matrix = Matrix_1;
+const Matrix$1 = Matrix_1;
 const SVD = SVD$1;
 const SingularValueDecomposition = SingularValueDecomposition_1;
 const WrapperMatrix1D = WrapperMatrix1D_1;
-var Matrix$1 = _default.Matrix ? _default.Matrix : Matrix_1;
+var Matrix = _default.Matrix ? _default.Matrix : Matrix_1;
 const determinant = determinant_1;
 const inverse = inverse_1;
 const pseudoInverse = pseudoInverse_1;
@@ -5125,7 +5125,7 @@ const pseudoInverse = pseudoInverse_1;
  * @returns The centroid.
  */
 function getCentroid(points) {
-  let result = new Matrix$1(3, 1);
+  let result = new Matrix(3, 1);
   const nbPoints = points.columns;
   let xSum = 0;
   let ySum = 0;
@@ -5166,7 +5166,7 @@ function getAffineTransform$1(source, destination) {
     ratioSum += getDistanceToOrigin(destinationPoint) / getDistanceToOrigin(sourcePoint);
   }
   const scale = ratioSum / nbPoints;
-  const scaledSource = Matrix$1.mul(translatedSource, scale);
+  const scaledSource = Matrix.mul(translatedSource, scale);
   // computing rotation
   const covarianceMatrix = scaledSource.mmul(translatedDestination.transpose());
   const svd = new SingularValueDecomposition(covarianceMatrix);
@@ -5182,7 +5182,7 @@ function getAffineTransform$1(source, destination) {
     angleDegrees = 180;
   }
   // computing translation
-  const translation = Matrix$1.sub(destinationCentroid, Matrix$1.mul(rotation.mmul(sourceCentroid), scale));
+  const translation = Matrix.sub(destinationCentroid, Matrix.mul(rotation.mmul(sourceCentroid), scale));
   return {
     translation: {
       x: translation.get(0, 0),
@@ -6263,9 +6263,9 @@ function F(t) {
 var index_umd$1 = {exports: {}};
 
 var index_umd = index_umd$1.exports;
-(function (module, exports) {
+(function (module, exports$1) {
   (function (N, J) {
-    J(exports) ;
+    J(exports$1) ;
   })(index_umd, function (N) {
 
     function J(f, a, o, t, e) {
@@ -6949,7 +6949,7 @@ function getHarrisScore(image, origin, options = {}) {
   const xxSum = xx.sum();
   const xySum = xy.sum();
   const yySum = yy.sum();
-  const structureTensor = new Matrix([[xxSum, xySum], [xySum, yySum]]);
+  const structureTensor = new Matrix$1([[xxSum, xySum], [xySum, yySum]]);
   const eigenValues = new EigenvalueDecomposition(structureTensor).realEigenvalues;
   return eigenValues[0] * eigenValues[1] - harrisConstant * (eigenValues[0] + eigenValues[1]) ** 2;
 }
@@ -8662,7 +8662,7 @@ function getDefaultColor(image) {
  * @param image - The image with which to blend.
  * @param column - Column of the target pixel.
  * @param row - Row of the target pixel.
- * @param color - Color with which to blend the image pixel. @default `'Opaque black'`.
+ * @param color - Color with which to blend the image pixel. Default: `Opaque black`.
  */
 function setBlendedPixel(image, column, row, color) {
   color = color ?? getDefaultColor(image);
@@ -8692,7 +8692,7 @@ function setBlendedPixel(image, column, row, color) {
  * @param image - The image with which to blend.
  * @param column - Column of the target pixel.
  * @param row - Row of the target pixel.
- * @param color - Color with which to blend the image pixel. @default `'Opaque black'`.
+ * @param color - Color with which to blend the image pixel. Default: `Opaque black`.
  */
 function setBlendedVisiblePixel(image, column, row, color) {
   if (column >= 0 && column < image.width && row >= 0 && row < image.height) {
@@ -9444,9 +9444,9 @@ function robustSubtract(e, f) {
 })(orientation);
 var orientationExports = orientation.exports;
 
-var robustPnp = robustPointInPolygon;
+var robustPnp = robustPointInPolygon$1;
 var orient = orientationExports;
-function robustPointInPolygon(vs, point) {
+function robustPointInPolygon$1(vs, point) {
   var x = point[0];
   var y = point[1];
   var n = vs.length;
@@ -9542,7 +9542,7 @@ function robustPointInPolygon(vs, point) {
   }
   return 2 * inside - 1;
 }
-var robustPointInPolygon$1 = /*@__PURE__*/getDefaultExportFromCjs(robustPnp);
+var robustPointInPolygon = /*@__PURE__*/getDefaultExportFromCjs(robustPnp);
 
 /**
  * Convert object points into array points.
@@ -9590,7 +9590,7 @@ function drawPolygonOnImage(image, points, options = {}) {
     const arrayPoints = arrayPointsToObjects(filteredPoints);
     for (let row = 0; row < newImage.height; row++) {
       for (let column = 0; column < newImage.width; column++) {
-        if (robustPointInPolygon$1(arrayPoints, [column, row]) === -1) {
+        if (robustPointInPolygon(arrayPoints, [column, row]) === -1) {
           setBlendedVisiblePixel(newImage, Math.round(origin.column) + column, Math.round(origin.row) + row, fillColor);
         }
       }
@@ -9631,7 +9631,7 @@ function drawPolygonOnMask(mask, points, options = {}) {
   const arrayPoints = arrayPointsToObjects(filteredPoints);
   for (let row = 0; row < newMask.height; row++) {
     for (let column = 0; column < newMask.width; column++) {
-      if (robustPointInPolygon$1(arrayPoints, [column, row]) === -1) {
+      if (robustPointInPolygon(arrayPoints, [column, row]) === -1) {
         newMask.setBit(Math.round(origin.column) + column, Math.round(origin.row) + row, 1);
       }
     }
@@ -12606,7 +12606,7 @@ function transform(image, transformMatrix, options = {}) {
     height = Math.round(height);
   }
   if (!options.inverse) {
-    transformMatrix = inverse(new Matrix(transformMatrix)).to2DArray();
+    transformMatrix = inverse(new Matrix$1(transformMatrix)).to2DArray();
   }
   const newImage = Image.createFrom(image, {
     width,
@@ -12845,8 +12845,8 @@ function getPerspectiveWarp(pts, options = {}) {
   const [x2, y2] = [widthRect - 1, 0];
   const [x3, y3] = [widthRect - 1, heightRect - 1];
   const [x4, y4] = [0, heightRect - 1];
-  const S = new Matrix([[x1, y1, 1, 0, 0, 0, -x1 * tl.column, -y1 * tl.column], [x2, y2, 1, 0, 0, 0, -x2 * tr.column, -y2 * tr.column], [x3, y3, 1, 0, 0, 0, -x3 * br.column, -y3 * br.column], [x4, y4, 1, 0, 0, 0, -x4 * bl.column, -y4 * bl.column], [0, 0, 0, x1, y1, 1, -x1 * tl.row, -y1 * tl.row], [0, 0, 0, x2, y2, 1, -x2 * tr.row, -y2 * tr.row], [0, 0, 0, x3, y3, 1, -x3 * br.row, -y3 * br.row], [0, 0, 0, x4, y4, 1, -x4 * bl.row, -y4 * bl.row]]);
-  const D = Matrix.columnVector([tl.column, tr.column, br.column, bl.column, tl.row, tr.row, br.row, bl.row]);
+  const S = new Matrix$1([[x1, y1, 1, 0, 0, 0, -x1 * tl.column, -y1 * tl.column], [x2, y2, 1, 0, 0, 0, -x2 * tr.column, -y2 * tr.column], [x3, y3, 1, 0, 0, 0, -x3 * br.column, -y3 * br.column], [x4, y4, 1, 0, 0, 0, -x4 * bl.column, -y4 * bl.column], [0, 0, 0, x1, y1, 1, -x1 * tl.row, -y1 * tl.row], [0, 0, 0, x2, y2, 1, -x2 * tr.row, -y2 * tr.row], [0, 0, 0, x3, y3, 1, -x3 * br.row, -y3 * br.row], [0, 0, 0, x4, y4, 1, -x4 * bl.row, -y4 * bl.row]]);
+  const D = Matrix$1.columnVector([tl.column, tr.column, br.column, bl.column, tl.row, tr.row, br.row, bl.row]);
   const svd = new SingularValueDecomposition(S);
   const T = svd.solve(D).to1DArray(); // solve S*T = D
   T.push(1);
@@ -13241,7 +13241,7 @@ class PolynomialRegression2D extends BaseRegression2D {
     // @ts-expect-error internal use only
     if (inputs === true) {
       // @ts-expect-error internal use only
-      this.coefficients = Matrix.columnVector(outputs.coefficients);
+      this.coefficients = Matrix$1.columnVector(outputs.coefficients);
       // @ts-expect-error internal use only
       this.order = outputs.order;
       // @ts-expect-error internal use only
@@ -13356,8 +13356,8 @@ function powColVector(x, power) {
  * @param y - A vector of the prediction values.
  */
 function train(input, y, order) {
-  if (!Matrix.isMatrix(y)) y = Matrix.columnVector(y);
-  const x = new Matrix(y.rows, 2);
+  if (!Matrix$1.isMatrix(y)) y = Matrix$1.columnVector(y);
+  const x = new Matrix$1(y.rows, 2);
   x.setColumn(0, input.x);
   x.setColumn(1, input.y);
   if (y.rows !== x.rows) {
@@ -13382,7 +13382,7 @@ function train(input, y, order) {
   x1.mulColumn(0, scaleX1);
   x2.mulColumn(0, scaleX2);
   y.mulColumn(0, scaleY);
-  const A = new Matrix(examples, nbCoefficients);
+  const A = new Matrix$1(examples, nbCoefficients);
   let col = 0;
   for (let i = 0; i <= order; ++i) {
     const limit = order - i;
@@ -13397,11 +13397,11 @@ function train(input, y, order) {
     computeRightSingularVectors: true,
     autoTranspose: false
   });
-  let qqs = Matrix.rowVector(svd.diagonal);
+  let qqs = Matrix$1.rowVector(svd.diagonal);
   qqs = qqs.apply((i, j) => {
     if (qqs.get(i, j) >= 1e-15) qqs.set(i, j, 1 / qqs.get(i, j));else qqs.set(i, j, 0);
   });
-  const qqs1 = Matrix.zeros(examples, nbCoefficients);
+  const qqs1 = Matrix$1.zeros(examples, nbCoefficients);
   for (let i = 0; i < nbCoefficients; ++i) {
     qqs1.set(i, i, qqs.get(0, i));
   }
@@ -16069,8 +16069,8 @@ class MultivariateLinearRegression {
       this.outputs = y.outputs;
       this.intercept = y.intercept;
     } else {
-      x = new Matrix(x);
-      y = new Matrix(y);
+      x = new Matrix$1(x);
+      y = new Matrix$1(y);
       if (intercept) {
         x.addColumn(new Array(x.rows).fill(1));
       }
@@ -16112,8 +16112,8 @@ class MultivariateLinearRegression {
         }
         return y;
       }
-    } else if (Matrix.isMatrix(x)) {
-      const y = new Matrix(x.rows, this.outputs);
+    } else if (Matrix$1.isMatrix(x)) {
+      const y = new Matrix$1(x.rows, this.outputs);
       for (let i = 0; i < x.rows; i++) {
         y.setRow(i, this._predict(x.getRow(i)));
       }
@@ -16811,6 +16811,10 @@ class Image {
    * Origin of the image relative to a the parent image.
    */
   origin;
+  /**
+   * Original image resolution.
+   */
+  originalResolution;
   meta;
   /**
    * Typed array holding the image data.
@@ -16831,7 +16835,8 @@ class Image {
         row: 0,
         column: 0
       },
-      meta
+      meta,
+      resolution
     } = options;
     if (width < 1 || !Number.isInteger(width)) {
       throw new RangeError(`width must be an integer and at least 1. Received ${width}`);
@@ -16846,6 +16851,7 @@ class Image {
     this.colorModel = colorModel;
     this.origin = origin;
     this.meta = meta;
+    this.originalResolution = resolution;
     const colorModelDef = colorModels[colorModel];
     this.components = colorModelDef.components;
     this.alpha = colorModelDef.alpha;
@@ -16866,6 +16872,38 @@ class Image {
       this.data = data;
     }
   }
+  /**
+   * Returns normalized resolution in pixels per centimeter. If resolution unit is unknown, return null.
+   * @returns Object with x and y resolutions in pixel/cm.
+   */
+  get normalizedResolution() {
+    if (!this.originalResolution) {
+      return undefined;
+    }
+    const centimetersPerInch = 2.54;
+    const centimetersPerMeter = 100;
+    switch (this.originalResolution.unit) {
+      case 'inch':
+        return {
+          x: this.originalResolution.x / centimetersPerInch,
+          y: this.originalResolution.y / centimetersPerInch
+        };
+      case 'centimeter':
+        return {
+          x: this.originalResolution.x,
+          y: this.originalResolution.y
+        };
+      case 'meter':
+        return {
+          x: this.originalResolution.x / centimetersPerMeter,
+          y: this.originalResolution.y / centimetersPerMeter
+        };
+      case 'unknown':
+        return null;
+      default:
+        throw new Error('Unknown resolution unit.');
+    }
+  }
   /**
    * Create a new Image based on the properties of an existing one.
    * @param other - Reference image.
@@ -28673,7 +28711,7 @@ function encode(image, options = defaultPng) {
  * @returns - The `fs`, `path` and `url` Node.js modules.
  */
 function getNodeApiOrThrow(methodName) {
-  if (typeof process === 'undefined' || typeof process.getBuiltinModule !== 'function') {
+  if (!isNode()) {
     throw new Error(`${methodName} is only implemented for Node.js`);
   }
   return {
@@ -28682,6 +28720,35 @@ function getNodeApiOrThrow(methodName) {
     url: process.getBuiltinModule('node:url')
   };
 }
+let CanvasCtorBrowser;
+let CanvasCtorNode;
+/**
+ * Returns a 2D canvas context for rendering on the browser or Node.js.
+ * @param width - Width of the canvas.
+ * @param height - Height of the canvas.
+ * @returns The initialised canvas context.
+ */
+function getCanvasContext(width, height) {
+  if (isNode()) {
+    CanvasCtorNode ??= getRequireFn()('skia-canvas').Canvas;
+    return new CanvasCtorNode(width, height).getContext('2d');
+  } else {
+    CanvasCtorBrowser ??= globalThis.OffscreenCanvas;
+    const context = new CanvasCtorBrowser(width, height).getContext('2d');
+    if (!context) {
+      throw new Error('Failed to create canvas context');
+    }
+    return context;
+  }
+}
+function isNode() {
+  return typeof process !== 'undefined' && typeof process.getBuiltinModule === 'function';
+}
+let requireFn;
+function getRequireFn() {
+  requireFn ??= process.getBuiltinModule('node:module').createRequire(import.meta.url);
+  return requireFn;
+}
 
 /**
  * Asynchronously write an image to the disk.
@@ -28708,7 +28775,7 @@ async function write(path, image, options) {
   await nodeApi.fs.promises.writeFile(path, toWrite);
 }
 /**
- * Synchronous version of @see {@link write}.
+ * Synchronous version of {@link write}.
  * This method is only implemented for Node.js.
  * @param path - Path where the image should be written.
  * @param image - Image to save.
@@ -28858,7 +28925,7 @@ function encodeDataURL(image, options = defaultPng) {
  * @returns The matrix.
  */
 function getMatrixFromPoints(points) {
-  const matrix = new Matrix(3, points.length);
+  const matrix = new Matrix$1(3, points.length);
   for (let i = 0; i < points.length; i++) {
     matrix.set(0, i, points[i].column);
     matrix.set(1, i, points[i].row);
@@ -30168,18 +30235,18 @@ var fileTypeExports = fileType$1.exports;
 
 const fileType = fileTypeExports;
 const imageExts = new Set(['jpg', 'png', 'gif', 'webp', 'flif', 'cr2', 'tif', 'bmp', 'jxr', 'psd', 'ico', 'bpg', 'jp2', 'jpm', 'jpx', 'heic', 'cur', 'dcm']);
-const imageType = input => {
+const imageType$1 = input => {
   const ret = fileType(input);
   return imageExts.has(ret && ret.ext) ? ret : null;
 };
-imageType$2.exports = imageType;
+imageType$2.exports = imageType$1;
 // TODO: Remove this for the next major release
-imageType$2.exports.default = imageType;
-Object.defineProperty(imageType, 'minimumBytes', {
+imageType$2.exports.default = imageType$1;
+Object.defineProperty(imageType$1, 'minimumBytes', {
   value: fileType.minimumBytes
 });
 var imageTypeExports = imageType$2.exports;
-var imageType$1 = /*@__PURE__*/getDefaultExportFromCjs(imageTypeExports);
+var imageType = /*@__PURE__*/getDefaultExportFromCjs(imageTypeExports);
 
 /**
  * Decode a BMP. See the fast-bmp npm module.
@@ -31511,10 +31578,23 @@ function decodePng(buffer) {
     default:
       throw new RangeError(`invalid number of channels: ${png.channels}`);
   }
+  let resolution;
+  if (png.resolution) {
+    resolution = png.resolution.unit === 1 ? /*If the resolution unit is meters*/{
+      x: png.resolution.x,
+      y: png.resolution.y,
+      unit: 'meter'
+    } : /*If resolution unit is unknown */{
+      x: png.resolution.x,
+      y: png.resolution.y,
+      unit: 'unknown'
+    };
+  }
   return new Image(png.width, png.height, {
     colorModel,
     bitDepth,
-    data: png.data
+    data: png.data,
+    resolution
   });
 }
 /**
@@ -31584,6 +31664,7 @@ function getImageFromIFD(ifd) {
   if (ifd.data instanceof Float32Array || ifd.data instanceof Float64Array) {
     throw new Error('Float TIFF data is not supported.');
   }
+  const resolution = getTiffResolution(ifd);
   if (ifd.type === 3) {
     const hasAlpha = ifd.samplesPerPixel === 2;
     const pixelLength = hasAlpha ? 4 : 3;
@@ -31611,7 +31692,8 @@ function getImageFromIFD(ifd) {
       data,
       colorModel: hasAlpha ? 'RGBA' : 'RGB',
       bitDepth: 16,
-      meta: getMetadata(ifd)
+      meta: getMetadata(ifd),
+      resolution
     });
   } else if (ifd.type === 1 || ifd.type === 0) {
     if (ifd.bitsPerSample !== 1) {
@@ -31619,14 +31701,16 @@ function getImageFromIFD(ifd) {
         data: ifd.data,
         bitDepth: ifd.bitsPerSample,
         colorModel: ifd.alpha ? 'GREYA' : 'GREY',
-        meta: getMetadata(ifd)
+        meta: getMetadata(ifd),
+        resolution
       });
     } else {
       return new Image(ifd.width, ifd.height, {
         data: ifd.data.map(pixel => pixel * 255),
         bitDepth: 8,
         colorModel: 'GREY',
-        meta: getMetadata(ifd)
+        meta: getMetadata(ifd),
+        resolution
       });
     }
   } else {
@@ -31634,10 +31718,41 @@ function getImageFromIFD(ifd) {
       data: ifd.data,
       bitDepth: ifd.bitsPerSample,
       colorModel: ifd.alpha ? 'RGBA' : 'RGB',
-      meta: getMetadata(ifd)
+      meta: getMetadata(ifd),
+      resolution
     });
   }
 }
+/**
+ * Gets image resolution from its metadata and converts it into Pixels per meter, when it's possible. Also keeps original resolution values and units.
+ * @param ifd - Tiff metadata.
+ * @returns Resolution object.
+ */
+function getTiffResolution(ifd) {
+  if (!ifd.xResolution || !ifd.yResolution) {
+    return undefined;
+  }
+  switch (ifd.resolutionUnit) {
+    case 1:
+      return {
+        x: ifd.xResolution,
+        y: ifd.yResolution,
+        unit: 'unknown'
+      };
+    case 3:
+      return {
+        x: ifd.xResolution,
+        y: ifd.yResolution,
+        unit: 'centimeter'
+      };
+    default:
+      return {
+        x: ifd.xResolution,
+        y: ifd.yResolution,
+        unit: 'inch'
+      };
+  }
+}
 
 /**
  * Decode input data. Data format is automatically detected.
@@ -31647,7 +31762,7 @@ function getImageFromIFD(ifd) {
  */
 function decode(data) {
   const typedArray = new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
-  const type = imageType$1(typedArray);
+  const type = imageType(typedArray);
   return M$2(type).with({
     mime: 'image/png'
   }, () => decodePng(typedArray)).with({
@@ -31674,7 +31789,7 @@ async function read(path) {
   return decode(data);
 }
 /**
- * Synchronous version of @see {@link read}.
+ * Synchronous version of {@link read}.
  * This method is only implemented for Node.js.
  * @param path - The path to the image.
  * @returns Image instance.
@@ -32747,7 +32862,7 @@ class RoiMapManager {
    * @returns The ROI map matrix.
    */
   getMapMatrix() {
-    return Matrix.from1DArray(this.map.height, this.map.width, this.map.data).to2DArray();
+    return Matrix$1.from1DArray(this.map.height, this.map.width, this.map.data).to2DArray();
   }
   getRois(options = {}) {
     return getRois(this, options);
@@ -32887,7 +33002,7 @@ function commonjsRequire(path) {
 
 var priorityQueue = {exports: {}};
 
-(function (module, exports) {
+(function (module, exports$1) {
   (function (f) {
     {
       module.exports = f();
@@ -32917,7 +33032,7 @@ var priorityQueue = {exports: {}};
       for (var o = 0; o < r.length; o++) s(r[o]);
       return s;
     }({
-      1: [function (_dereq_, module, exports) {
+      1: [function (_dereq_, module, exports$1) {
         var AbstractPriorityQueue,
           ArrayStrategy,
           BHeapStrategy,
@@ -32962,7 +33077,7 @@ var priorityQueue = {exports: {}};
         "./PriorityQueue/BHeapStrategy": 4,
         "./PriorityQueue/BinaryHeapStrategy": 5
       }],
-      2: [function (_dereq_, module, exports) {
+      2: [function (_dereq_, module, exports$1) {
         module.exports = function () {
           function AbstractPriorityQueue(options) {
             var ref;
@@ -33000,7 +33115,7 @@ var priorityQueue = {exports: {}};
           return AbstractPriorityQueue;
         }();
       }, {}],
-      3: [function (_dereq_, module, exports) {
+      3: [function (_dereq_, module, exports$1) {
         var binarySearchForIndexReversed;
         binarySearchForIndexReversed = function (array, value, comparator) {
           var high, low, mid;
@@ -33043,7 +33158,7 @@ var priorityQueue = {exports: {}};
           return ArrayStrategy;
         }();
       }, {}],
-      4: [function (_dereq_, module, exports) {
+      4: [function (_dereq_, module, exports$1) {
         module.exports = function () {
           function BHeapStrategy(options) {
             var arr, j, k, len, ref, ref1, shift, value;
@@ -33181,7 +33296,7 @@ var priorityQueue = {exports: {}};
           return BHeapStrategy;
         }();
       }, {}],
-      5: [function (_dereq_, module, exports) {
+      5: [function (_dereq_, module, exports$1) {
         module.exports = function () {
           function BinaryHeapStrategy(options) {
             var ref;
@@ -33580,7 +33695,7 @@ function decodeStackFromTiff(buffer) {
  */
 function decodeStack(data) {
   const typedArray = new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
-  const type = imageType$1(typedArray);
+  const type = imageType(typedArray);
   return M$2(type).with({
     mime: 'image/tiff'
   }, () => decodeStackFromTiff(typedArray)).with({
@@ -33843,5 +33958,104 @@ const channelLabels = {
   BINARY: ['Mask']
 };
 
-export { BorderType, DerivativeFilter, GreyAlgorithm, Image, ImageColorModel, ImageCoordinates, ImageFormat, InterpolationType, Mask, Montage, MontageDisposition, Roi, RoiKind, RoiMapManager, RoisColorMode, Stack, ThresholdAlgorithm, add, alignMinDifference, and, blur, bottomHat, bruteForceOneMatch, cannyEdgeDetector, channelLabels, clearBorder, close, colorModels, colorRois, computeConvolutionValue, computeMse, computePsnr, computeRmse, computeRois, computeThreshold, convertBinaryToGrey, convertBinaryToRgb, convertBitDepth, convertColor, copyAlpha, copyTo, correctBackground, correctColor, crop, cropAlpha, cropRectangle, crosscheck, decode, decodeJpeg, decodePng, decodeStack, decodeTiff, defaultPng, derivativeFilter, dilate, directConvolution, divide, drawCircleOnImage, drawKeypoints, drawLineOnImage, drawLineOnMask, drawMarker, drawMarkers, drawMatches, drawPoints, drawPolygonOnImage, drawPolygonOnMask, drawPolylineOnImage, drawPolylineOnMask, drawRectangle, encode, encodeDataURL, encodeJpeg, encodePng, erode, extendBorders, extract, fetchURL, flip, floodFill, fromMask, gaussianBlur, getAffineTransform, getBestKeypointsInRadius, getBorderPoints, getBriefDescriptors, getCrosscheckMatches, getDirection, getExtrema, getFastKeypoints, getImageFromIFD, getIntensityCentroid, getMask, getOrientedFastKeypoints, getPerspectiveWarp, getRegressionVariables, getRois, gradientFilter, grey, histogram$1 as histogram, hypotenuse, increaseContrast, invert, level, mean, median, medianFilter, merge, morphologicalGradient, multiply, open, or, order4Points, overlapImages, paintMaskOnImage, paintMaskOnMask, pixelate, rawDirectConvolution, read, readCanvas, readImg, readSync, removeClosePoints, resize, rotate, separableConvolution, solidFill, split, subtract, threshold, topHat, transform, transformRotate, variance, waterShed, write, writeCanvas, writeSync };
+/**
+ * Draws text on an image.
+ * @param image - Image to write text on.
+ * @param text - Text to write on the image.
+ * @param options - Out Options
+ * @returns Image with drawn text.
+ */
+function drawText(image, text, options) {
+  if (Array.isArray(text) && text.length === 0) {
+    throw new Error('At least one text element must be provided');
+  }
+  const newImage = getOutputImage(image, options, {
+    clone: true
+  });
+  const defaultFont = options?.font ?? '12px Helvetica';
+  const defaultColor = options?.fontColor ?? [255, 255, 255, 255];
+  const ctx = getCanvasContext(image.width, image.height);
+  if (!Array.isArray(text)) {
+    drawTextElement(image, ctx, text, defaultFont, defaultColor);
+  } else {
+    for (const label of text) {
+      drawTextElement(image, ctx, label, defaultFont, defaultColor);
+    }
+  }
+  layerCanvas(newImage.getRawImage().data, ctx.getImageData(0, 0, image.width, image.height).data, image.channels, image.bitDepth);
+  return newImage;
+}
+function drawTextElement(image, ctx, text, defaultFont, defaultColor) {
+  ctx.font = text.font ?? defaultFont;
+  const fontColor = text.fontColor ?? defaultColor;
+  validateValues(fontColor, image);
+  const alpha = fontColor[3] ? fontColor[3] / 255 : 1;
+  const normalizedColor = [fontColor[0] ?? 0, fontColor[1] ?? 0, fontColor[2] ?? 0, alpha];
+  ctx.fillStyle = `rgba(${normalizedColor.join(',')})`;
+  ctx.fillText(String(text.content), text.position.column, text.position.row);
+}
+/**
+ * Draws labels on the image data from canvas.
+ * @param imageData - Image data to draw text on.
+ * @param canvasData - Canvas data to draw on the image.
+ * @param numberOfChannels - Number of channels of the initial image.
+ * @param bitDepth - Bit depth of the initial image.
+ */
+function layerCanvas(imageData, canvasData, numberOfChannels, bitDepth) {
+  const config = CHANNEL_CONFIGS[numberOfChannels] || CHANNEL_CONFIGS[1];
+  const pixelCount = canvasData.length >>> 2;
+  const bitShift = bitDepth - 8;
+  let imageIndex = 0;
+  let canvasIndex = 0;
+  for (let pixel = 0; pixel < pixelCount; pixel++) {
+    const canvasAlpha = canvasData[canvasIndex + 3] / 255;
+    // Skip transparent canvas pixels completely
+    if (canvasAlpha === 0) {
+      imageIndex += numberOfChannels;
+      canvasIndex += 4;
+      continue;
+    }
+    const invAlpha = 1 - canvasAlpha;
+    for (const channel of config.channelOffsets) {
+      const targetIndex = imageIndex + channel;
+      imageData[targetIndex] = Math.round(canvasData[canvasIndex + channel] * canvasAlpha + imageData[targetIndex] * invAlpha) << bitShift;
+    }
+    if (config.hasAlpha) {
+      const alphaIndex = imageIndex + config.alphaOffset;
+      const imageAlpha = (imageData[alphaIndex] >>> bitShift) / 255;
+      const newAlpha = canvasAlpha + imageAlpha * (1 - canvasAlpha);
+      imageData[alphaIndex] = Math.round(newAlpha * 255) << bitShift;
+    }
+    imageIndex += numberOfChannels;
+    canvasIndex += 4;
+  }
+}
+const CHANNEL_CONFIGS = {
+  // GREY
+  1: {
+    channelOffsets: [0],
+    hasAlpha: false,
+    alphaOffset: undefined
+  },
+  // GREYA
+  2: {
+    channelOffsets: [0],
+    hasAlpha: true,
+    alphaOffset: 1
+  },
+  3: {
+    // RGB
+    channelOffsets: [0, 1, 2],
+    hasAlpha: false,
+    alphaOffset: undefined
+  },
+  4: {
+    // RGBA
+    channelOffsets: [0, 1, 2],
+    hasAlpha: true,
+    alphaOffset: 3
+  }
+};
+
+export { BorderType, DerivativeFilter, GreyAlgorithm, Image, ImageColorModel, ImageCoordinates, ImageFormat, InterpolationType, Mask, Montage, MontageDisposition, Roi, RoiKind, RoiMapManager, RoisColorMode, Stack, ThresholdAlgorithm, add, alignMinDifference, and, blur, bottomHat, bruteForceOneMatch, cannyEdgeDetector, channelLabels, clearBorder, close, colorModels, colorRois, computeConvolutionValue, computeMse, computePsnr, computeRmse, computeRois, computeThreshold, convertBinaryToGrey, convertBinaryToRgb, convertBitDepth, convertColor, copyAlpha, copyTo, correctBackground, correctColor, crop, cropAlpha, cropRectangle, crosscheck, decode, decodeJpeg, decodePng, decodeStack, decodeTiff, defaultPng, derivativeFilter, dilate, directConvolution, divide, drawCircleOnImage, drawKeypoints, drawLineOnImage, drawLineOnMask, drawMarker, drawMarkers, drawMatches, drawPoints, drawPolygonOnImage, drawPolygonOnMask, drawPolylineOnImage, drawPolylineOnMask, drawRectangle, drawText, encode, encodeDataURL, encodeJpeg, encodePng, erode, extendBorders, extract, fetchURL, flip, floodFill, fromMask, gaussianBlur, getAffineTransform, getBestKeypointsInRadius, getBorderPoints, getBriefDescriptors, getCrosscheckMatches, getDirection, getExtrema, getFastKeypoints, getImageFromIFD, getIntensityCentroid, getMask, getOrientedFastKeypoints, getPerspectiveWarp, getRegressionVariables, getRois, gradientFilter, grey, histogram$1 as histogram, hypotenuse, increaseContrast, invert, level, mean, median, medianFilter, merge, morphologicalGradient, multiply, open, or, order4Points, overlapImages, paintMaskOnImage, paintMaskOnMask, pixelate, rawDirectConvolution, read, readCanvas, readImg, readSync, removeClosePoints, resize, rotate, separableConvolution, solidFill, split, subtract, threshold, topHat, transform, transformRotate, variance, waterShed, write, writeCanvas, writeSync };
 //# sourceMappingURL=image-js.esm.js.map