image-js 1.0.0-alpha.3 → 1.0.0

package/lib/featureMatching/utils/sortBySourceDest.js

@@ -0,0 +1,29 @@
+/**
+ * Sort array of matches by source index and then destination index.
+ * @param matches - Array of matches to sort.
+ * @returns Sorted copy of the array of matches.
+ */
+export function sortBySourceDest(matches) {
+    return matches.slice().sort((match1, match2) => {
+        if (match1.sourceIndex < match2.sourceIndex)
+            return -1;
+        if (match1.sourceIndex > match2.sourceIndex)
+            return 1;
+        return match1.destinationIndex - match2.destinationIndex;
+    });
+}
+/**
+ * Sort array of matches by destination index and then source index.
+ * @param matches - Array of matches to sort.
+ * @returns Sorted copy of the array of matches.
+ */
+export function sortByDestSource(matches) {
+    return matches.slice().sort((match1, match2) => {
+        if (match1.destinationIndex < match2.destinationIndex)
+            return -1;
+        if (match1.destinationIndex > match2.destinationIndex)
+            return 1;
+        return match1.sourceIndex - match2.sourceIndex;
+    });
+}
+//# sourceMappingURL=sortBySourceDest.js.map

package/lib/featureMatching/utils/sortBySourceDest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sortBySourceDest.js","sourceRoot":"","sources":["../../../src/featureMatching/utils/sortBySourceDest.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE;QAC7C,IAAI,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW;YAAE,OAAO,CAAC,CAAC,CAAC;QACvD,IAAI,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW;YAAE,OAAO,CAAC,CAAC;QACtD,OAAO,MAAM,CAAC,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,CAAC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE;QAC7C,IAAI,MAAM,CAAC,gBAAgB,GAAG,MAAM,CAAC,gBAAgB;YAAE,OAAO,CAAC,CAAC,CAAC;QACjE,IAAI,MAAM,CAAC,gBAAgB,GAAG,MAAM,CAAC,gBAAgB;YAAE,OAAO,CAAC,CAAC;QAChE,OAAO,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/lib/featureMatching/visualize/Montage.d.ts

@@ -0,0 +1,84 @@
+import { Image } from '../../Image.js';
+import type { Point } from '../../geometry/index.js';
+import type { FastKeypoint } from '../keypoints/getFastKeypoints.js';
+import type { Match } from '../matching/bruteForceMatch.js';
+import type { DrawKeypointsOptions } from './drawKeypoints.js';
+import type { DrawMatchesOptions } from './drawMatches.js';
+export declare const MontageDisposition: {
+    readonly HORIZONTAL: "horizontal";
+    readonly VERTICAL: "vertical";
+};
+export type MontageDisposition = (typeof MontageDisposition)[keyof typeof MontageDisposition];
+export interface MontageOptions {
+    /**
+     * Factor by which to scale the images.
+     *  @default `1`
+     */
+    scale?: number;
+    /**
+     * How should the images be aligned: vertically or horizontally.
+     * @default `'horizontal'`
+     */
+    disposition?: MontageDisposition;
+}
+export declare class Montage {
+    /**
+     * Scaled width of the first image.
+     */
+    readonly sourceWidth: number;
+    /**
+     * Scaled height of the first image.
+     */
+    readonly sourceHeight: number;
+    /**
+     * Scaled width of the second image.
+     */
+    readonly destinationWidth: number;
+    /**
+     * Scaled height of the second image.
+     */
+    readonly destinationHeight: number;
+    /**
+     * Origin of the destination / second image relative to top-left corner of the Montage.
+     */
+    readonly destinationOrigin: Point;
+    /**
+     * Width of the Montage.
+     */
+    readonly width: number;
+    /**
+     * Height of the Montage.
+     */
+    readonly height: number;
+    /**
+     * Factor by which to scale the images are scaled in the montage.
+     */
+    readonly scale: number;
+    readonly disposition: MontageDisposition;
+    /**
+     * Image of the Montage.
+     */
+    image: Image;
+    /**
+     * Create a Montage of two images. The two images are placed side by side for comparison.
+     * @param source - First image.
+     * @param destination - Second image.
+     * @param options  - Montage options.
+     */
+    constructor(source: Image, destination: Image, options?: MontageOptions);
+    /**
+     * Draw keypoints on the Montage.
+     * @param keypoints - Keypoints to draw.
+     * @param options - Draw keypoints options.
+     */
+    drawKeypoints(keypoints: FastKeypoint[], options?: DrawKeypointsOptions): void;
+    /**
+     * Draw the matches between source and destination keypoints.
+     * @param matches - Matches to draw.
+     * @param sourceKeypoints - Source keypoints.
+     * @param destinationKeypoints  - Destination keypoints.
+     * @param options - Draw matches options.
+     */
+    drawMatches(matches: Match[], sourceKeypoints: FastKeypoint[], destinationKeypoints: FastKeypoint[], options?: DrawMatchesOptions): void;
+}
+//# sourceMappingURL=Montage.d.ts.map

package/lib/featureMatching/visualize/Montage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Montage.d.ts","sourceRoot":"","sources":["../../../src/featureMatching/visualize/Montage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAC;AAE5D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAI3D,eAAO,MAAM,kBAAkB;;;CAGrB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAC5B,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAClC;AAED,qBAAa,OAAO;IAClB;;OAEG;IACH,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC;;OAEG;IACH,SAAgB,YAAY,EAAE,MAAM,CAAC;IACrC;;OAEG;IACH,SAAgB,gBAAgB,EAAE,MAAM,CAAC;IACzC;;OAEG;IACH,SAAgB,iBAAiB,EAAE,MAAM,CAAC;IAC1C;;OAEG;IACH,SAAgB,iBAAiB,EAAE,KAAK,CAAC;IACzC;;OAEG;IACH,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B;;OAEG;IACH,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B;;OAEG;IACH,SAAgB,KAAK,EAAE,MAAM,CAAC;IAE9B,SAAgB,WAAW,EAAE,kBAAkB,CAAC;IAEhD;;OAEG;IACI,KAAK,EAAE,KAAK,CAAC;IAEpB;;;;;OAKG;gBAED,MAAM,EAAE,KAAK,EACb,WAAW,EAAE,KAAK,EAClB,OAAO,GAAE,cAAmB;IAgD9B;;;;OAIG;IACI,aAAa,CAClB,SAAS,EAAE,YAAY,EAAE,EACzB,OAAO,GAAE,oBAAyB,GACjC,IAAI;IAKP;;;;;;OAMG;IACI,WAAW,CAChB,OAAO,EAAE,KAAK,EAAE,EAChB,eAAe,EAAE,YAAY,EAAE,EAC/B,oBAAoB,EAAE,YAAY,EAAE,EACpC,OAAO,GAAE,kBAAuB,GAC/B,IAAI;CASR"}

package/lib/featureMatching/visualize/Montage.js

@@ -0,0 +1,113 @@
+import { Image } from '../../Image.js';
+import { drawKeypoints } from './drawKeypoints.js';
+import { drawMatches } from './drawMatches.js';
+import { scaleKeypoints } from './scaleKeypoints.js';
+export const MontageDisposition = {
+    HORIZONTAL: 'horizontal',
+    VERTICAL: 'vertical',
+};
+export class Montage {
+    /**
+     * Scaled width of the first image.
+     */
+    sourceWidth;
+    /**
+     * Scaled height of the first image.
+     */
+    sourceHeight;
+    /**
+     * Scaled width of the second image.
+     */
+    destinationWidth;
+    /**
+     * Scaled height of the second image.
+     */
+    destinationHeight;
+    /**
+     * Origin of the destination / second image relative to top-left corner of the Montage.
+     */
+    destinationOrigin;
+    /**
+     * Width of the Montage.
+     */
+    width;
+    /**
+     * Height of the Montage.
+     */
+    height;
+    /**
+     * Factor by which to scale the images are scaled in the montage.
+     */
+    scale;
+    disposition;
+    /**
+     * Image of the Montage.
+     */
+    image;
+    /**
+     * Create a Montage of two images. The two images are placed side by side for comparison.
+     * @param source - First image.
+     * @param destination - Second image.
+     * @param options  - Montage options.
+     */
+    constructor(source, destination, options = {}) {
+        const { scale = 1, disposition = 'horizontal' } = options;
+        if (!Number.isInteger(scale)) {
+            throw new TypeError('scale must be an integer');
+        }
+        this.scale = scale;
+        this.disposition = disposition;
+        this.sourceWidth = scale * source.width;
+        this.destinationWidth = scale * destination.width;
+        this.sourceHeight = scale * source.height;
+        this.destinationHeight = scale * destination.height;
+        if (disposition === 'horizontal') {
+            this.destinationOrigin = { row: 0, column: this.sourceWidth };
+            this.width = this.sourceWidth + this.destinationWidth;
+            this.height = Math.max(this.sourceHeight, this.destinationHeight);
+        }
+        else if (disposition === 'vertical') {
+            this.destinationOrigin = { row: this.sourceHeight, column: 0 };
+            this.width = Math.max(this.sourceWidth, this.destinationWidth);
+            this.height = this.sourceHeight + this.destinationHeight;
+        }
+        else {
+            throw new RangeError(`invalid disposition type: ${disposition}`);
+        }
+        if (source.colorModel !== 'RGB') {
+            source = source.convertColor('RGB');
+        }
+        if (destination.colorModel !== 'RGB') {
+            destination = destination.convertColor('RGB');
+        }
+        const image = new Image(this.width, this.height);
+        source
+            .resize({ xFactor: scale, yFactor: scale })
+            .copyTo(image, { out: image });
+        destination.resize({ xFactor: scale, yFactor: scale }).copyTo(image, {
+            out: image,
+            origin: this.destinationOrigin,
+        });
+        this.image = image;
+    }
+    /**
+     * Draw keypoints on the Montage.
+     * @param keypoints - Keypoints to draw.
+     * @param options - Draw keypoints options.
+     */
+    drawKeypoints(keypoints, options = {}) {
+        const scaledKeypoints = scaleKeypoints(keypoints, this.scale);
+        this.image = drawKeypoints(this.image, scaledKeypoints, options);
+    }
+    /**
+     * Draw the matches between source and destination keypoints.
+     * @param matches - Matches to draw.
+     * @param sourceKeypoints - Source keypoints.
+     * @param destinationKeypoints  - Destination keypoints.
+     * @param options - Draw matches options.
+     */
+    drawMatches(matches, sourceKeypoints, destinationKeypoints, options = {}) {
+        this.image = drawMatches(this, matches, sourceKeypoints, destinationKeypoints, options);
+    }
+}
+//# sourceMappingURL=Montage.js.map

package/lib/featureMatching/visualize/Montage.js.map

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

package/lib/featureMatching/visualize/drawKeypoints.d.ts

@@ -0,0 +1,55 @@
+import type { Image } from '../../Image.js';
+import type { Point } from '../../geometry/index.js';
+import type { GetColorsOptions } from '../featureMatching.types.js';
+import type { FastKeypoint } from '../keypoints/getFastKeypoints.js';
+import type { OrientedFastKeypoint } from '../keypoints/getOrientedFastKeypoints.js';
+export interface DrawKeypointsOptions {
+    /**
+     * Origin of the keypoints in the image.
+     * @default `{row: 0, column: 0}`
+     */
+    origin?: Point;
+    /**
+     * Markers size in pixels.
+     * @default `10`
+     */
+    markerSize?: number;
+    /**
+     * Keypoint's color - An array of numerical values, one for each channel of the image. If less values are defined than there are channels in the image, the remaining channels will be set to 0.
+     * @default `[255,0,0]`
+     */
+    strokeColor?: number[];
+    /**
+     * Whether to fill the markers.
+     * @default `false`
+     */
+    fill?: boolean;
+    /**
+     * Whether the score of the keypoints should be reflected in their color.
+     * @default `false`
+     */
+    showScore?: boolean;
+    /**
+     * Maximal number of matches with smallest distance to draw.
+     * @default `keypoints.length`
+     */
+    maxNbKeypoints?: number;
+    /**
+     * Image to which the resulting image has to be put.
+     */
+    out?: Image;
+    /**
+     * Options for the coloring of the keypoints depending on their score (useful if showScore = true).
+     */
+    showScoreOptions?: GetColorsOptions;
+}
+export interface DrawOrientedKeypointsOptions extends DrawKeypointsOptions {
+    /**
+     * Show the orientation of the keypoints.
+     * @default `false`
+     */
+    showOrientation?: boolean;
+}
+export declare function drawKeypoints(image: Image, keypoints: FastKeypoint[], options?: DrawKeypointsOptions): Image;
+export declare function drawKeypoints(image: Image, keypoints: OrientedFastKeypoint[], options?: DrawOrientedKeypointsOptions): Image;
+//# sourceMappingURL=drawKeypoints.d.ts.map

package/lib/featureMatching/visualize/drawKeypoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drawKeypoints.d.ts","sourceRoot":"","sources":["../../../src/featureMatching/visualize/drawKeypoints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAGrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAIrF,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC;IACf;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IAEH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,GAAG,CAAC,EAAE,KAAK,CAAC;IACZ;;OAEG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED,MAAM,WAAW,4BAA6B,SAAQ,oBAAoB;IACxE;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,YAAY,EAAE,EACzB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,KAAK,CAAC;AACT,wBAAgB,aAAa,CAC3B,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,oBAAoB,EAAE,EACjC,OAAO,CAAC,EAAE,4BAA4B,GACrC,KAAK,CAAC"}

package/lib/featureMatching/visualize/drawKeypoints.js

@@ -0,0 +1,58 @@
+import { sum } from '../../utils/geometry/points.js';
+import { getOutputImage } from '../../utils/getOutputImage.js';
+import { getColors } from '../utils/getColors.js';
+import { getKeypointColor } from '../utils/getKeypointColor.js';
+/**
+ * Draw keypoints on an image.
+ * @param image - The source image of the keypoints.
+ * @param keypoints - The FAST keypoints.
+ * @param options - Draw keypoints options.
+ * @returns The image with the keypoints indicated by empty circles.
+ */
+export function drawKeypoints(image, keypoints, options = {}) {
+    const { markerSize = 10, fill = false, showScore = false, origin = { row: 0, column: 0 }, showScoreOptions, } = options;
+    let { maxNbKeypoints = keypoints.length } = options;
+    const { strokeColor = [255, 0, 0] } = options;
+    if (maxNbKeypoints > keypoints.length) {
+        maxNbKeypoints = keypoints.length;
+    }
+    let newImage = getOutputImage(image, options, { clone: true });
+    if (image.colorModel !== 'RGB') {
+        newImage = newImage.convertColor('RGB');
+    }
+    const colors = getColors(image, strokeColor, showScoreOptions);
+    const radius = Math.ceil(markerSize / 2);
+    for (let i = 0; i < maxNbKeypoints; i++) {
+        const keypoint = keypoints[i];
+        let keypointColor = strokeColor;
+        if (showScore) {
+            keypointColor = getKeypointColor(keypoints, i, colors);
+        }
+        const fillColor = fill ? keypointColor : undefined;
+        const absoluteOrigin = sum(keypoint.origin, origin);
+        newImage.drawCircle(absoluteOrigin, radius, {
+            fillColor,
+            strokeColor: keypointColor,
+            out: newImage,
+        });
+        if (isOrientedFastKeypoint(keypoint) &&
+            options.showOrientation) {
+            const angle = keypoint.angle;
+            const from = absoluteOrigin;
+            const radAngle = (angle * Math.PI) / 180;
+            const to = {
+                column: from.column + Math.round(radius * Math.cos(radAngle)),
+                row: from.row - Math.round(radius * Math.sin(radAngle)),
+            };
+            newImage.drawLine(from, to, {
+                strokeColor: keypointColor,
+                out: newImage,
+            });
+        }
+    }
+    return newImage;
+}
+function isOrientedFastKeypoint(kpt) {
+    return 'angle' in kpt && typeof kpt.angle === 'number';
+}
+//# sourceMappingURL=drawKeypoints.js.map

package/lib/featureMatching/visualize/drawKeypoints.js.map

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

package/lib/featureMatching/visualize/drawMatches.d.ts

@@ -0,0 +1,42 @@
+import type { Image } from '../../Image.js';
+import type { GetColorsOptions } from '../featureMatching.types.js';
+import type { FastKeypoint } from '../keypoints/getFastKeypoints.js';
+import type { Match } from '../matching/bruteForceMatch.js';
+import type { Montage } from './Montage.js';
+export interface DrawMatchesOptions {
+    /**
+     * Circles diameter in pixels.
+     * @default `10`
+     */
+    circleDiameter?: number;
+    /**
+     * Annotations color - An array of numerical values, one for each channel of the image. If less values are defined than there are channels in the image, the remaining channels will be set to 0.
+     * @default `[255,0,0]`
+     */
+    strokeColor?: number[];
+    /**
+     * Whether the matches should be colored depending on the distance.
+     * @default `false`
+     */
+    showDistance?: boolean;
+    /**
+     * Options for the coloring of the matches depending on their distance (useful if showDistance = true).
+     */
+    showDistanceOptions?: GetColorsOptions;
+    /**
+     * Maximal number of keypoints with best score to draw.
+     * @default `matches.length`
+     */
+    maxNbMatches?: number;
+}
+/**
+ * Draw the the matches between two images on their montage.
+ * @param montage - The montage of two images to match.
+ * @param matches - The matches between source and destination.
+ * @param sourceKeypoints - Source keypoints.
+ * @param destinationKeypoints - Destination keypoints.
+ * @param options - Draw matches options.
+ * @returns The comparison image.
+ */
+export declare function drawMatches(montage: Montage, matches: Match[], sourceKeypoints: FastKeypoint[], destinationKeypoints: FastKeypoint[], options?: DrawMatchesOptions): Image;
+//# sourceMappingURL=drawMatches.d.ts.map

package/lib/featureMatching/visualize/drawMatches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drawMatches.d.ts","sourceRoot":"","sources":["../../../src/featureMatching/visualize/drawMatches.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAC;AAK5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG5C,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;OAEG;IACH,mBAAmB,CAAC,EAAE,gBAAgB,CAAC;IACvC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,KAAK,EAAE,EAChB,eAAe,EAAE,YAAY,EAAE,EAC/B,oBAAoB,EAAE,YAAY,EAAE,EAEpC,OAAO,GAAE,kBAAuB,GAC/B,KAAK,CAoDP"}

package/lib/featureMatching/visualize/drawMatches.js

@@ -0,0 +1,52 @@
+import { getColors } from '../utils/getColors.js';
+import { getMatchColor } from '../utils/getMatchColor.js';
+import { sortByDistance } from '../utils/sortByDistance.js';
+import { scaleKeypoints } from './scaleKeypoints.js';
+/**
+ * Draw the the matches between two images on their montage.
+ * @param montage - The montage of two images to match.
+ * @param matches - The matches between source and destination.
+ * @param sourceKeypoints - Source keypoints.
+ * @param destinationKeypoints - Destination keypoints.
+ * @param options - Draw matches options.
+ * @returns The comparison image.
+ */
+export function drawMatches(montage, matches, sourceKeypoints, destinationKeypoints, options = {}) {
+    const { circleDiameter = 10, strokeColor = [255, 0, 0], showDistance = false, showDistanceOptions, } = options;
+    let { maxNbMatches = matches.length } = options;
+    if (maxNbMatches > matches.length) {
+        maxNbMatches = matches.length;
+    }
+    const scaledSource = scaleKeypoints(sourceKeypoints, montage.scale);
+    const scaledDestination = scaleKeypoints(destinationKeypoints, montage.scale);
+    const result = montage.image;
+    const colors = getColors(result, strokeColor, showDistanceOptions);
+    const radius = Math.ceil(circleDiameter / 2);
+    const matchesSortedByDistance = sortByDistance(matches);
+    for (let i = 0; i < maxNbMatches; i++) {
+        let matchColor = strokeColor;
+        if (showDistance) {
+            matchColor = getMatchColor(matchesSortedByDistance, i, colors);
+        }
+        const sourcePoint = scaledSource[matches[i].sourceIndex].origin;
+        result.drawCircle(sourcePoint, radius, {
+            strokeColor: matchColor,
+            out: result,
+        });
+        const relativeDestinationPoint = scaledDestination[matches[i].destinationIndex].origin;
+        const destinationPoint = {
+            column: relativeDestinationPoint.column + montage.destinationOrigin.column,
+            row: relativeDestinationPoint.row + montage.destinationOrigin.row,
+        };
+        result.drawCircle(destinationPoint, radius, {
+            strokeColor: matchColor,
+            out: result,
+        });
+        result.drawLine(sourcePoint, destinationPoint, {
+            out: result,
+            strokeColor: matchColor,
+        });
+    }
+    return result;
+}
+//# sourceMappingURL=drawMatches.js.map

package/lib/featureMatching/visualize/drawMatches.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drawMatches.js","sourceRoot":"","sources":["../../../src/featureMatching/visualize/drawMatches.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG5D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AA6BrD;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CACzB,OAAgB,EAChB,OAAgB,EAChB,eAA+B,EAC/B,oBAAoC,EAEpC,UAA8B,EAAE;IAEhC,MAAM,EACJ,cAAc,GAAG,EAAE,EACnB,WAAW,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,EACzB,YAAY,GAAG,KAAK,EACpB,mBAAmB,GACpB,GAAG,OAAO,CAAC;IACZ,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,OAAO,CAAC;IAEhD,IAAI,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAClC,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAChC,CAAC;IAED,MAAM,YAAY,GAAG,cAAc,CAAC,eAAe,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACpE,MAAM,iBAAiB,GAAG,cAAc,CAAC,oBAAoB,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAE9E,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAE7B,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,mBAAmB,CAAC,CAAC;IAEnE,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC;IAC7C,MAAM,uBAAuB,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACxD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,UAAU,GAAG,WAAW,CAAC;QAC7B,IAAI,YAAY,EAAE,CAAC;YACjB,UAAU,GAAG,aAAa,CAAC,uBAAuB,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;QACjE,CAAC;QACD,MAAM,WAAW,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC;QAChE,MAAM,CAAC,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE;YACrC,WAAW,EAAE,UAAU;YACvB,GAAG,EAAE,MAAM;SACZ,CAAC,CAAC;QAEH,MAAM,wBAAwB,GAC5B,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC;QAExD,MAAM,gBAAgB,GAAG;YACvB,MAAM,EACJ,wBAAwB,CAAC,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,MAAM;YACpE,GAAG,EAAE,wBAAwB,CAAC,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAC,GAAG;SAClE,CAAC;QACF,MAAM,CAAC,UAAU,CAAC,gBAAgB,EAAE,MAAM,EAAE;YAC1C,WAAW,EAAE,UAAU;YACvB,GAAG,EAAE,MAAM;SACZ,CAAC,CAAC;QACH,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,gBAAgB,EAAE;YAC7C,GAAG,EAAE,MAAM;YACX,WAAW,EAAE,UAAU;SACxB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/lib/featureMatching/visualize/overlapImages.d.ts

@@ -0,0 +1,30 @@
+import { Image } from '../../Image.js';
+import type { Point } from '../../geometry/index.js';
+export interface OverlapImageOptions {
+    /**
+     * Origin of the second image relatively to top-left corner of first image.
+     * @default `{row: 0, column: 0}`
+     */
+    origin?: Point;
+    /**
+     * Desired rotation of image 2 in degrees around its top-left corner.
+     * @default `0`
+     */
+    angle?: number;
+    /**
+     * Factor by which to scale the second image.
+     *  @default `1`
+     */
+    scale?: number;
+}
+/**
+ * Overlap two images and specify. The first image can be translated,
+ * rotated and scaled to match the second one.
+ * The first image is drawn in red and the second one in green.
+ * @param image1 - First image.
+ * @param image2 - Second image.
+ * @param options - Overlap image options.
+ * @returns The overlapping images.
+ */
+export declare function overlapImages(image1: Image, image2: Image, options?: OverlapImageOptions): Image;
+//# sourceMappingURL=overlapImages.d.ts.map

package/lib/featureMatching/visualize/overlapImages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlapImages.d.ts","sourceRoot":"","sources":["../../../src/featureMatching/visualize/overlapImages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAoB,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAIrD,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC;IAEf;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,KAAK,EACb,MAAM,EAAE,KAAK,EACb,OAAO,GAAE,mBAAwB,GAChC,KAAK,CA4BP"}

package/lib/featureMatching/visualize/overlapImages.js

@@ -0,0 +1,35 @@
+import { Image, ImageCoordinates } from '../../Image.js';
+import { merge } from '../../operations/index.js';
+import { ImageColorModel } from '../../utils/constants/colorModels.js';
+/**
+ * Overlap two images and specify. The first image can be translated,
+ * rotated and scaled to match the second one.
+ * The first image is drawn in red and the second one in green.
+ * @param image1 - First image.
+ * @param image2 - Second image.
+ * @param options - Overlap image options.
+ * @returns The overlapping images.
+ */
+export function overlapImages(image1, image2, options = {}) {
+    const { origin = { row: 0, column: 0 }, angle = 0, scale = 1 } = options;
+    if (scale === 0) {
+        throw new Error('Scale cannot be 0');
+    }
+    if (image1.colorModel !== ImageColorModel.GREY) {
+        image1 = image1.grey();
+    }
+    if (image2.colorModel !== ImageColorModel.GREY) {
+        image2 = image2.grey();
+    }
+    const inverted1 = image1.invert();
+    const inverted2 = image2.invert();
+    const rotated = inverted1.transformRotate(angle, {
+        center: ImageCoordinates.TOP_LEFT,
+    });
+    const scaled = rotated.resize({ xFactor: scale, yFactor: scale });
+    const empty = Image.createFrom(inverted2);
+    const alignedGrey1 = scaled.copyTo(empty, { origin });
+    const result = merge([alignedGrey1, inverted2, empty]);
+    return result;
+}
+//# sourceMappingURL=overlapImages.js.map

package/lib/featureMatching/visualize/overlapImages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlapImages.js","sourceRoot":"","sources":["../../../src/featureMatching/visualize/overlapImages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,OAAO,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAsBvE;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAa,EACb,MAAa,EACb,UAA+B,EAAE;IAEjC,MAAM,EAAE,MAAM,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC;IAEzE,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,MAAM,CAAC,UAAU,KAAK,eAAe,CAAC,IAAI,EAAE,CAAC;QAC/C,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,KAAK,eAAe,CAAC,IAAI,EAAE,CAAC;QAC/C,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;IAClC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;IAElC,MAAM,OAAO,GAAG,SAAS,CAAC,eAAe,CAAC,KAAK,EAAE;QAC/C,MAAM,EAAE,gBAAgB,CAAC,QAAQ;KAClC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IAElE,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IAE1C,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAEtD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,YAAY,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;IAEvD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/lib/featureMatching/visualize/scaleKeypoints.d.ts

@@ -0,0 +1,9 @@
+import type { FastKeypoint } from '../keypoints/getFastKeypoints.js';
+/**
+ * Scales the coordinates of the keypoints.
+ * @param keypoints - Keypoints to scale.
+ * @param scale - Scalar by which to multiply the coordinates.
+ * @returns Scaled keypoints (copy of the original array).
+ */
+export declare function scaleKeypoints(keypoints: FastKeypoint[], scale: number): FastKeypoint[];
+//# sourceMappingURL=scaleKeypoints.d.ts.map

package/lib/featureMatching/visualize/scaleKeypoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaleKeypoints.d.ts","sourceRoot":"","sources":["../../../src/featureMatching/visualize/scaleKeypoints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAErE;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,YAAY,EAAE,EACzB,KAAK,EAAE,MAAM,GACZ,YAAY,EAAE,CAYhB"}

package/lib/featureMatching/visualize/scaleKeypoints.js

@@ -0,0 +1,20 @@
+/**
+ * Scales the coordinates of the keypoints.
+ * @param keypoints - Keypoints to scale.
+ * @param scale - Scalar by which to multiply the coordinates.
+ * @returns Scaled keypoints (copy of the original array).
+ */
+export function scaleKeypoints(keypoints, scale) {
+    if (scale === 1)
+        return keypoints.slice();
+    return keypoints.map((kpt) => {
+        return {
+            origin: {
+                row: kpt.origin.row * scale,
+                column: kpt.origin.column * scale,
+            },
+            score: kpt.score,
+        };
+    });
+}
+//# sourceMappingURL=scaleKeypoints.js.map

package/lib/featureMatching/visualize/scaleKeypoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaleKeypoints.js","sourceRoot":"","sources":["../../../src/featureMatching/visualize/scaleKeypoints.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,SAAyB,EACzB,KAAa;IAEb,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC,KAAK,EAAE,CAAC;IAE1C,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAC3B,OAAO;YACL,MAAM,EAAE;gBACN,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,GAAG,KAAK;gBAC3B,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,KAAK;aAClC;YACD,KAAK,EAAE,GAAG,CAAC,KAAK;SACjB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/lib/filters/and.d.ts

@@ -0,0 +1,16 @@
+import type { Mask } from '../Mask.js';
+export interface AndOptions {
+    /**
+     * Image to which the resulting image has to be put.
+     */
+    out?: Mask;
+}
+/**
+ * Perform an AND operation on two masks.
+ * @param mask - First mask.
+ * @param otherMask - Second mask.
+ * @param options - And options.
+ * @returns AND of the two masks.
+ */
+export declare function and(mask: Mask, otherMask: Mask, options?: AndOptions): Mask;
+//# sourceMappingURL=and.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"and.d.ts","sourceRoot":"","sources":["../../src/filters/and.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGvC,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED;;;;;;GAMG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAe3E"}

package/lib/filters/and.js

@@ -0,0 +1,24 @@
+import { maskToOutputMask } from '../utils/getOutputImage.js';
+/**
+ * Perform an AND operation on two masks.
+ * @param mask - First mask.
+ * @param otherMask - Second mask.
+ * @param options - And options.
+ * @returns AND of the two masks.
+ */
+export function and(mask, otherMask, options) {
+    const newMask = maskToOutputMask(mask, options);
+    if (mask.width !== otherMask.width || mask.height !== otherMask.height) {
+        throw new RangeError('both masks must have the same size');
+    }
+    for (let i = 0; i < newMask.size; i++) {
+        if (mask.getBitByIndex(i) && otherMask.getBitByIndex(i)) {
+            newMask.setBitByIndex(i, 1);
+        }
+        else {
+            newMask.setBitByIndex(i, 0);
+        }
+    }
+    return newMask;
+}
+//# sourceMappingURL=and.js.map

package/lib/filters/and.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"and.js","sourceRoot":"","sources":["../../src/filters/and.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAS9D;;;;;;GAMG;AACH,MAAM,UAAU,GAAG,CAAC,IAAU,EAAE,SAAe,EAAE,OAAoB;IACnE,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAEhD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM,EAAE,CAAC;QACvE,MAAM,IAAI,UAAU,CAAC,oCAAoC,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,OAAO,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}