image-js 1.0.0-alpha.2 → 1.0.0

package/lib/filters/blur.d.ts

@@ -1,10 +1,34 @@
-import { Image } from '../Image';
-import { BorderType } from '../types';
-export interface IBlurOptions {
+import type { Image } from '../Image.js';
+import type { BorderType } from '../utils/interpolateBorder.js';
+export interface BlurOptions {
+    /**
+     * Width of the blurring matrix, must be an odd integer.
+     */
     width: number;
+    /**
+     * Height of the blurring matrix, must be an odd integer.
+     */
     height: number;
+    /**
+     * Explicit how to handle the borders.
+     * @default `'reflect101'`
+     */
     borderType?: BorderType;
+    /**
+     * Value of the border if BorderType is 'constant'.
+     * @default `0`
+     */
+    borderValue?: number;
+    /**
+     * Image to which to output.
+     */
     out?: Image;
 }
-export declare function blur(image: Image, options: IBlurOptions): Image;
+/**
+ * Blur an image. The pixel in the center becomes an average of the surrounding ones.
+ * @param image - Image to blur.
+ * @param options - Blur options.
+ * @returns The blurred image.
+ */
+export declare function blur(image: Image, options: BlurOptions): Image;
 //# sourceMappingURL=blur.d.ts.map

package/lib/filters/blur.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blur.d.ts","sourceRoot":"","sources":["../../src/filters/blur.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAItC,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,GAAG,CAAC,EAAE,KAAK,CAAC;CACb;AAED,wBAAgB,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,GAAG,KAAK,CAU/D"}
+{"version":3,"file":"blur.d.ts","sourceRoot":"","sources":["../../src/filters/blur.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAIhE,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,GAAG,CAAC,EAAE,KAAK,CAAC;CACb;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,GAAG,KAAK,CAqB9D"}

package/lib/filters/blur.js

@@ -1,15 +1,23 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const convolution_1 = require("./convolution");
-function blur(image, options) {
+import { separableConvolution } from './convolution.js';
+/**
+ * Blur an image. The pixel in the center becomes an average of the surrounding ones.
+ * @param image - Image to blur.
+ * @param options - Blur options.
+ * @returns The blurred image.
+ */
+export function blur(image, options) {
     const { width, height } = options;
+    if (width < 1 || width % 2 === 0) {
+        throw new RangeError(`Invalid property "width". Must be an odd number greater than 0. Received ${width}.`);
+    }
+    if (height < 1 || height % 2 === 0) {
+        throw new RangeError(`Invalid property "height". Must be an odd number greater than 0. Received ${height}.`);
+    }
     const kernelX = new Array(width).fill(1);
     const kernelY = new Array(height).fill(1);
-    return convolution_1.separableConvolution(image, kernelX, kernelY, {
+    return separableConvolution(image, kernelX, kernelY, {
         normalize: true,
-        borderType: options.borderType,
-        out: options.out
+        ...options,
     });
 }
-exports.blur = blur;
 //# sourceMappingURL=blur.js.map

package/lib/filters/blur.js.map

@@ -1 +1 @@
-{"version":3,"file":"blur.js","sourceRoot":"","sources":["../../src/filters/blur.ts"],"names":[],"mappings":";;AAGA,+CAAqD;AASrD,SAAgB,IAAI,CAAC,KAAY,EAAE,OAAqB;IACtD,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAClC,MAAM,OAAO,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAE1C,OAAO,kCAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE;QACnD,SAAS,EAAE,IAAI;QACf,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAC,CAAC;AACL,CAAC;AAVD,oBAUC"}
+{"version":3,"file":"blur.js","sourceRoot":"","sources":["../../src/filters/blur.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AA2BxD;;;;;GAKG;AACH,MAAM,UAAU,IAAI,CAAC,KAAY,EAAE,OAAoB;IACrD,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAElC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,UAAU,CAClB,4EAA4E,KAAK,GAAG,CACrF,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,UAAU,CAClB,6EAA6E,MAAM,GAAG,CACvF,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAE1C,OAAO,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE;QACnD,SAAS,EAAE,IAAI;QACf,GAAG,OAAO;KACX,CAAC,CAAC;AACL,CAAC"}

package/lib/filters/convolution.d.ts

@@ -1,11 +1,72 @@
-import { Image } from '../Image';
-import { BorderType } from '../types';
-interface ISeparableConvolutionOptions {
+import { Image } from '../Image.js';
+import type { BorderType } from '../utils/interpolateBorder.js';
+import type { BorderInterpolationFunction, ClampFunction } from '../utils/utils.types.js';
+export interface ConvolutionOptions {
+    /**
+     * Specify how the borders should be handled.
+     * @default `'reflect101'`
+     */
     borderType?: BorderType;
+    /**
+     * Value of the border if BorderType is 'constant'.
+     * @default `0`
+     */
+    borderValue?: number;
+    /**
+     * Whether the kernel should be normalized.
+     * @default `false`
+     */
     normalize?: boolean;
+    /**
+     * Image to which to output.
+     */
     out?: Image;
 }
-export declare function directConvolution(image: Image, kernel: number[][], options?: ISeparableConvolutionOptions): Image;
-export declare function separableConvolution(image: Image, kernelX: number[], kernelY: number[], options?: ISeparableConvolutionOptions): Image;
-export {};
+/**
+ * Apply a direct convolution on an image using the specified kernel. The convolution corresponds of a weighted average of the surrounding pixels, the weights being defined in the kernel.
+ * @param image - The image to process.
+ * @param kernel - Kernel to use for the convolution. Should be a 2D matrix with odd number of rows and columns.
+ * @param options - Convolution options.
+ * @returns The convoluted image.
+ */
+export declare function directConvolution(image: Image, kernel: number[][], options?: ConvolutionOptions): Image;
+/**
+ * Compute direct convolution of an image and return an array with the raw values.
+ * @param image - Image to process.
+ * @param kernel - 2D kernel used for the convolution.
+ * @param options - Convolution options.
+ * @returns Array with the raw convoluted values.
+ */
+export declare function rawDirectConvolution(image: Image, kernel: number[][], options?: ConvolutionOptions): Float64Array;
+/**
+ * Compute the separable convolution of an image.
+ * @param image - Image to convolute.
+ * @param kernelX - Kernel along x axis.
+ * @param kernelY - Kernel along y axis.
+ * @param options - Convolution options.
+ * @returns The convoluted image.
+ */
+export declare function separableConvolution(image: Image, kernelX: number[], kernelY: number[], options?: ConvolutionOptions): Image;
+export interface ComputeConvolutionValueOptions {
+    /**
+     * Specify wether the return value should not be clamped and rounded.
+     */
+    returnRawValue?: boolean;
+    /**
+     * If the value has to be clamped, specify the clamping function.
+     */
+    clamp?: ClampFunction;
+}
+/**
+ * Compute the convolution of a value of a pixel in an image.
+ * @param column - Column of the pixel.
+ * @param row - Row of the pixel.
+ * @param channel - Channel to process.
+ * @param image - Image to process.
+ * @param kernel - Kernel for the convolutions.
+ * @param interpolateBorder - Function to interpolate the border pixels.
+ * @param options - Compute convolution value options.
+ * @returns The convoluted value.
+ */
+export declare function computeConvolutionValue(column: number, row: number, channel: number, image: Image, kernel: number[][], interpolateBorder: BorderInterpolationFunction, options?: ComputeConvolutionValueOptions): number;
 //# sourceMappingURL=convolution.d.ts.map

package/lib/filters/convolution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"convolution.d.ts","sourceRoot":"","sources":["../../src/filters/convolution.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEjC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAKtC,UAAU,4BAA4B;IACpC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,GAAG,CAAC,EAAE,KAAK,CAAC;CACb;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EAAE,EAAE,EAClB,OAAO,GAAE,4BAAiC,GACzC,KAAK,CAsBP;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,GAAE,4BAAiC,GACzC,KAAK,CAgHP"}
+{"version":3,"file":"convolution.d.ts","sourceRoot":"","sources":["../../src/filters/convolution.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAKpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAGhE,OAAO,KAAK,EACV,2BAA2B,EAC3B,aAAa,EACd,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,GAAG,CAAC,EAAE,KAAK,CAAC;CACb;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EAAE,EAAE,EAClB,OAAO,GAAE,kBAAuB,GAC/B,KAAK,CAoBP;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EAAE,EAAE,EAClB,OAAO,GAAE,kBAAuB,GAC/B,YAAY,CAwBd;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,GAAE,kBAAuB,GAC/B,KAAK,CAmEP;AAED,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;OAEG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EAAE,EAAE,EAClB,iBAAiB,EAAE,2BAA2B,EAC9C,OAAO,GAAE,8BAAmC,GAC3C,MAAM,CAgCR"}

package/lib/filters/convolution.js

@@ -1,95 +1,127 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const ml_convolution_1 = require("ml-convolution");
-const ml_matrix_1 = require("ml-matrix");
-const Image_1 = require("../Image");
-const clamp_1 = require("../utils/clamp");
-const types_1 = require("../types");
-const interpolateBorder_1 = require("../utils/interpolateBorder");
-const round_1 = require("../utils/round");
-const getOutputImage_1 = require("../utils/getOutputImage");
-function directConvolution(image, kernel, options = {}) {
-    const { borderType } = options;
-    const newImage = getOutputImage_1.getOutputImage(image, options);
-    for (let c = 0; c < image.channels; c++) {
-        for (let x = 0; x < image.width; x++) {
-            for (let y = 0; y < image.height; y++) {
-                const idx = (y * image.width + x) * image.channels + c;
-                newImage.data[idx] = computeConvolutionPixel(x, y, c, image, kernel, borderType);
-            }
+import { BorderType as ConvolutionBorderType, DirectConvolution, } from 'ml-convolution';
+import { Image } from '../Image.js';
+import { extendBorders } from '../operations/extendBorders.js';
+import { getClamp } from '../utils/clamp.js';
+import { getIndex } from '../utils/getIndex.js';
+import { getOutputImage } from '../utils/getOutputImage.js';
+import { getBorderInterpolation } from '../utils/interpolateBorder.js';
+import { round } from '../utils/round.js';
+/**
+ * Apply a direct convolution on an image using the specified kernel. The convolution corresponds of a weighted average of the surrounding pixels, the weights being defined in the kernel.
+ * @param image - The image to process.
+ * @param kernel - Kernel to use for the convolution. Should be a 2D matrix with odd number of rows and columns.
+ * @param options - Convolution options.
+ * @returns The convoluted image.
+ */
+export function directConvolution(image, kernel, options = {}) {
+    const { borderType = 'reflect101', borderValue = 0 } = options;
+    const convolutedData = rawDirectConvolution(image, kernel, {
+        borderType,
+        borderValue,
+    });
+    const newImage = getOutputImage(image, options);
+    const clamp = getClamp(newImage);
+    for (let i = 0; i < image.size; i++) {
+        for (let channel = 0; channel < image.channels; channel++) {
+            const dataIndex = i * image.channels + channel;
+            const newValue = round(clamp(convolutedData[dataIndex]));
+            newImage.setValueByIndex(i, channel, newValue);
         }
     }
     return newImage;
 }
-exports.directConvolution = directConvolution;
-function separableConvolution(image, kernelX, kernelY, options = {}) {
-    const { normalize, borderType } = options;
+/**
+ * Compute direct convolution of an image and return an array with the raw values.
+ * @param image - Image to process.
+ * @param kernel - 2D kernel used for the convolution.
+ * @param options - Convolution options.
+ * @returns Array with the raw convoluted values.
+ */
+export function rawDirectConvolution(image, kernel, options = {}) {
+    const { borderType = 'reflect101', borderValue = 0 } = options;
+    const interpolateBorder = getBorderInterpolation(borderType, borderValue);
+    const result = new Float64Array(image.size * image.channels);
+    for (let channel = 0; channel < image.channels; channel++) {
+        for (let row = 0; row < image.height; row++) {
+            for (let column = 0; column < image.width; column++) {
+                const index = getIndex(column, row, image, channel);
+                result[index] = computeConvolutionValue(column, row, channel, image, kernel, interpolateBorder, { returnRawValue: true });
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Compute the separable convolution of an image.
+ * @param image - Image to convolute.
+ * @param kernelX - Kernel along x axis.
+ * @param kernelY - Kernel along y axis.
+ * @param options - Convolution options.
+ * @returns The convoluted image.
+ */
+export function separableConvolution(image, kernelX, kernelY, options = {}) {
+    const { normalize, borderType = 'reflect101', borderValue = 0 } = options;
     if (normalize) {
         [kernelX, kernelY] = normalizeSeparatedKernel(kernelX, kernelY);
     }
-    const kernelOffsetX = (kernelX.length - 1) / 2;
-    const kernelOffsetY = (kernelY.length - 1) / 2;
-    const hFactor = image.channels * image.width;
-    const newImage = Image_1.Image.createFrom(image);
-    const rowConvolution = new ml_convolution_1.DirectConvolution(image.width, kernelX, ml_convolution_1.BorderType.CUT);
-    const columnConvolution = new ml_convolution_1.DirectConvolution(image.height, kernelY, ml_convolution_1.BorderType.CUT);
-    for (let c = 0; c < image.channels; c++) {
-        const imgArr = [];
-        for (let y = 0; y < image.height; y++) {
-            const row = [];
-            const rowIndex = y * image.width * image.channels;
-            for (let x = 0; x < image.width; x++) {
-                row.push(image.data[rowIndex + x * image.channels + c]);
-            }
-            imgArr.push(rowConvolution.convolve(row).slice());
-        }
-        for (let x = 0; x < image.width - 2 * kernelOffsetX; x++) {
-            const wOffset = (x + kernelOffsetX) * image.channels;
-            const column = [];
-            for (let y = 0; y < image.height; y++) {
-                column.push(imgArr[y][x]);
+    const doubleKernelOffsetX = kernelX.length - 1;
+    const kernelOffsetX = doubleKernelOffsetX / 2;
+    const doubleKernelOffsetY = kernelY.length - 1;
+    const kernelOffsetY = doubleKernelOffsetY / 2;
+    const extendedImage = extendBorders(image, {
+        horizontal: kernelOffsetX,
+        vertical: kernelOffsetY,
+        borderType,
+        borderValue,
+    });
+    const newImage = Image.createFrom(image);
+    const clamp = getClamp(newImage);
+    const rowConvolution = new DirectConvolution(extendedImage.width, kernelX, ConvolutionBorderType.CUT);
+    const columnConvolution = new DirectConvolution(extendedImage.height, kernelY, ConvolutionBorderType.CUT);
+    const rowData = new Float64Array(extendedImage.width);
+    const columnData = new Float64Array(extendedImage.height);
+    const convolvedData = new Float64Array(
+    // Use `image.width` because convolution with BorderType.CUT reduces the size of the convolved data.
+    image.width * extendedImage.height);
+    for (let channel = 0; channel < extendedImage.channels; channel++) {
+        for (let row = 0; row < extendedImage.height; row++) {
+            for (let column = 0; column < extendedImage.width; column++) {
+                rowData[column] = extendedImage.getValue(column, row, channel);
             }
-            const result = columnConvolution.convolve(column);
-            for (let i = 0; i < result.length; i++) {
-                const idx = (i + kernelOffsetY) * hFactor + wOffset + c;
-                newImage.data[idx] = round_1.round(clamp_1.clamp(result[i], newImage));
+            const convolvedRow = rowConvolution.convolve(rowData);
+            for (let column = 0; column < image.width; column++) {
+                convolvedData[row * image.width + column] = convolvedRow[column];
             }
         }
-    }
-    // Calculate kernel from separated kernels.
-    const matrixX = ml_matrix_1.Matrix.rowVector(kernelX);
-    const matrixY = ml_matrix_1.Matrix.columnVector(kernelY);
-    const kernel = matrixY.mmul(matrixX).to2DArray();
-    // Apply convolution on the left and right borders
-    for (let c = 0; c < image.channels; c++) {
-        for (let bY = 0; bY < image.height; bY++) {
-            for (let bX = 0; bX < kernelOffsetX; bX++) {
-                const idx = (bY * image.width + bX) * image.channels + c;
-                const bXopp = image.width - bX - 1;
-                const bYopp = image.height - bY - 1;
-                const idxOpp = (bYopp * image.width + bXopp) * image.channels + c;
-                newImage.data[idx] = computeConvolutionPixel(bX, bY, c, image, kernel, borderType);
-                newImage.data[idxOpp] = computeConvolutionPixel(bXopp, bYopp, c, image, kernel, borderType);
+        for (let column = 0; column < image.width; column++) {
+            for (let row = 0; row < extendedImage.height; row++) {
+                columnData[row] = convolvedData[row * image.width + column];
             }
-        }
-    }
-    // apply the convolution on the top and bottom borders
-    for (let c = 0; c < image.channels; c++) {
-        for (let bX = 0; bX < image.width; bX++) {
-            for (let bY = 0; bY < kernelOffsetY; bY++) {
-                const idx = (bY * image.width + bX) * image.channels + c;
-                const bXopp = image.width - bX - 1;
-                const bYopp = image.height - bY - 1;
-                const idxOpp = (bYopp * image.width + bXopp) * image.channels + c;
-                newImage.data[idx] = computeConvolutionPixel(bX, bY, c, image, kernel, borderType);
-                newImage.data[idxOpp] = computeConvolutionPixel(bXopp, bYopp, c, image, kernel, borderType);
+            const convolvedColumn = columnConvolution.convolve(columnData);
+            for (let row = 0; row < image.height; row++) {
+                newImage.setValue(column, row, channel, round(clamp(convolvedColumn[row])));
             }
         }
     }
     return newImage;
 }
-exports.separableConvolution = separableConvolution;
-function computeConvolutionPixel(x, y, channel, image, kernel, borderType = types_1.BorderType.REFLECT_101) {
+/**
+ * Compute the convolution of a value of a pixel in an image.
+ * @param column - Column of the pixel.
+ * @param row - Row of the pixel.
+ * @param channel - Channel to process.
+ * @param image - Image to process.
+ * @param kernel - Kernel for the convolutions.
+ * @param interpolateBorder - Function to interpolate the border pixels.
+ * @param options - Compute convolution value options.
+ * @returns The convoluted value.
+ */
+export function computeConvolutionValue(column, row, channel, image, kernel, interpolateBorder, options = {}) {
+    let { clamp } = options;
+    const { returnRawValue = false } = options;
+    if (returnRawValue) {
+        clamp = undefined;
+    }
     let val = 0;
     const kernelWidth = kernel[0].length;
     const kernelHeight = kernel.length;
@@ -98,19 +130,30 @@ function computeConvolutionPixel(x, y, channel, image, kernel, borderType = type
     for (let kY = 0; kY < kernelHeight; kY++) {
         for (let kX = 0; kX < kernelWidth; kX++) {
             const kernelValue = kernel[kY][kX];
-            const imgX = interpolateBorder_1.interpolateBorder(x + kX - kernelOffsetX, image.width, borderType);
-            const imgY = interpolateBorder_1.interpolateBorder(y + kY - kernelOffsetY, image.height, borderType);
-            val += kernelValue * image.getValue(imgY, imgX, channel);
+            val +=
+                kernelValue *
+                    interpolateBorder(column + kX - kernelOffsetX, row + kY - kernelOffsetY, channel, image);
         }
     }
-    return round_1.round(clamp_1.clamp(val, image));
+    if (!clamp) {
+        return val;
+    }
+    else {
+        return round(clamp(val));
+    }
 }
+/**
+ * Normalize a separated kernel.
+ * @param kernelX - Horizontal component of the separated kernel.
+ * @param kernelY - Vertical component of the separated kernel.
+ * @returns The normalized kernel.
+ */
 function normalizeSeparatedKernel(kernelX, kernelY) {
     const sumKernelX = kernelX.reduce((prev, current) => prev + current, 0);
     const sumKernelY = kernelY.reduce((prev, current) => prev + current, 0);
     const prod = sumKernelX * sumKernelY;
     if (prod < 0) {
-        throw new Error('this separated kernel cannot be normalized');
+        throw new RangeError('this separated kernel cannot be normalized');
     }
     const factor = 1 / Math.sqrt(Math.abs(prod));
     return [kernelX.map((v) => v * factor), kernelY.map((v) => v * factor)];

package/lib/filters/convolution.js.map

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

package/lib/filters/derivativeFilter.d.ts

@@ -0,0 +1,38 @@
+import type { BitDepth, Image } from '../Image.js';
+import type { BorderType } from '../utils/interpolateBorder.js';
+export declare const DerivativeFilter: {
+    readonly SOBEL: "sobel";
+    readonly SCHARR: "scharr";
+    readonly PREWITT: "prewitt";
+};
+export type DerivativeFilter = (typeof DerivativeFilter)[keyof typeof DerivativeFilter];
+export interface DerivativeFilterOptions {
+    /**
+     * Algorithm to use for the derivative filter.
+     * @default `SOBEL`
+     */
+    filter?: DerivativeFilter;
+    /**
+     * Specify how the borders should be handled.
+     * @default `'replicate'`
+     */
+    borderType?: BorderType;
+    /**
+     * Value of the border if BorderType is 'constant'.
+     * @default `0`
+     */
+    borderValue?: number;
+    /**
+     * Specify the bit depth of the resulting image.
+     * @default `image.bitDepth`
+     */
+    bitDepth?: BitDepth;
+}
+/**
+ * Apply a derivative filter to an image.
+ * @param image - Image to process.
+ * @param options - Derivative filter options.
+ * @returns The processed image.
+ */
+export declare function derivativeFilter(image: Image, options?: DerivativeFilterOptions): Image;
+//# sourceMappingURL=derivativeFilter.d.ts.map

package/lib/filters/derivativeFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derivativeFilter.d.ts","sourceRoot":"","sources":["../../src/filters/derivativeFilter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AASnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAEhE,eAAO,MAAM,gBAAgB;;;;CAOnB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAC1B,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAE3D,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B;;;OAGG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,KAAK,EACZ,OAAO,GAAE,uBAA4B,GACpC,KAAK,CAaP"}

package/lib/filters/derivativeFilter.js

@@ -0,0 +1,26 @@
+import { match } from 'ts-pattern';
+import { PREWITT_X, PREWITT_Y, SCHARR_X, SCHARR_Y, SOBEL_X, SOBEL_Y, } from '../utils/constants/kernels.js';
+export const DerivativeFilter = {
+    SOBEL: 'sobel',
+    SCHARR: 'scharr',
+    PREWITT: 'prewitt',
+    // todo: handle even sized kernels to implement Roberts' filter
+    // for 2x2 matrices, the current pixel corresponds to the top-left
+    //  ROBERTS = 'roberts',
+};
+/**
+ * Apply a derivative filter to an image.
+ * @param image - Image to process.
+ * @param options - Derivative filter options.
+ * @returns The processed image.
+ */
+export function derivativeFilter(image, options = {}) {
+    const { filter = 'sobel' } = options;
+    const kernels = match(filter)
+        .with('sobel', () => ({ kernelX: SOBEL_X, kernelY: SOBEL_Y }))
+        .with('scharr', () => ({ kernelX: SCHARR_X, kernelY: SCHARR_Y }))
+        .with('prewitt', () => ({ kernelX: PREWITT_X, kernelY: PREWITT_Y }))
+        .exhaustive();
+    return image.gradientFilter({ ...kernels, ...options });
+}
+//# sourceMappingURL=derivativeFilter.js.map

package/lib/filters/derivativeFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"derivativeFilter.js","sourceRoot":"","sources":["../../src/filters/derivativeFilter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,OAAO,EACL,SAAS,EACT,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,OAAO,GACR,MAAM,+BAA+B,CAAC;AAGvC,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,+DAA+D;IAC/D,kEAAkE;IAClE,wBAAwB;CAChB,CAAC;AA4BX;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAY,EACZ,UAAmC,EAAE;IAErC,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE,GAAG,OAAO,CAAC;IAErC,MAAM,OAAO,GAAG,KAAK,CAGnB,MAAM,CAAC;SACN,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;SAC7D,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;SAChE,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;SACnE,UAAU,EAAE,CAAC;IAEhB,OAAO,KAAK,CAAC,cAAc,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;AAC1D,CAAC"}

package/lib/filters/flip.d.ts

@@ -0,0 +1,20 @@
+import type { Image } from '../Image.js';
+export interface FlipOptions {
+    /**
+     * Image to which the resulting image has to be put.
+     * @default `'horizontal'`
+     */
+    axis?: 'horizontal' | 'vertical' | 'both';
+    /**
+     * Image to which the resulting image has to be put.
+     */
+    out?: Image;
+}
+/**
+ * Apply a flip filter to an image.
+ * @param image - Image to process.
+ * @param options - Flip options.
+ * @returns - The processed image.
+ */
+export declare function flip(image: Image, options?: FlipOptions): Image;
+//# sourceMappingURL=flip.d.ts.map

package/lib/filters/flip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flip.d.ts","sourceRoot":"","sources":["../../src/filters/flip.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAMzC,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,IAAI,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,MAAM,CAAC;IAC1C;;OAEG;IACH,GAAG,CAAC,EAAE,KAAK,CAAC;CACb;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,GAAE,WAAgB,GAAG,KAAK,CAUnE"}

package/lib/filters/flip.js

@@ -0,0 +1,23 @@
+import { getOutputImage } from '../utils/getOutputImage.js';
+import flipX from './flipX.js';
+import flipY from './flipY.js';
+/**
+ * Apply a flip filter to an image.
+ * @param image - Image to process.
+ * @param options - Flip options.
+ * @returns - The processed image.
+ */
+export function flip(image, options = {}) {
+    const { axis = 'horizontal' } = options;
+    const newImage = getOutputImage(image, options, { clone: true });
+    if (axis === 'horizontal') {
+        return flipX(newImage);
+    }
+    else if (axis === 'vertical') {
+        return flipY(newImage);
+    }
+    else {
+        return flipY(flipX(newImage));
+    }
+}
+//# sourceMappingURL=flip.js.map

package/lib/filters/flip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flip.js","sourceRoot":"","sources":["../../src/filters/flip.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,KAAK,MAAM,YAAY,CAAC;AAc/B;;;;;GAKG;AACH,MAAM,UAAU,IAAI,CAAC,KAAY,EAAE,UAAuB,EAAE;IAC1D,MAAM,EAAE,IAAI,GAAG,YAAY,EAAE,GAAG,OAAO,CAAC;IACxC,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;SAAM,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;SAAM,CAAC;QACN,OAAO,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IAChC,CAAC;AACH,CAAC"}

package/lib/filters/flipX.d.ts

@@ -0,0 +1,8 @@
+import type { Image } from '../Image.js';
+/**
+ * Apply a flipX filter to an image.
+ * @param image - Image to process.
+ * @returns The processed image.
+ */
+export default function flipX(image: Image): Image;
+//# sourceMappingURL=flipX.d.ts.map

package/lib/filters/flipX.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flipX.d.ts","sourceRoot":"","sources":["../../src/filters/flipX.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAuBjD"}