Added adaptiveThreshold to MagickImage.

Author: dlemstra

src/magick-image.ts

@@ -411,6 +411,44 @@ export interface IMagickImage extends IDisposable {
      */
     adaptiveSharpen(radius: number, sigma: number, channels: Channels): void;
 
+    /**
+     * Local adaptive threshold image.
+     * http://www.dai.ed.ac.uk/HIPR2/adpthrsh.htm.
+     * @param width The width of the pixel neighborhood.
+     * @param height The height of the pixel neighborhood.
+     */
+    adaptiveThreshold(width: number, height: number): void;
+
+    /**
+     * Local adaptive threshold image.
+     * http://www.dai.ed.ac.uk/HIPR2/adpthrsh.htm.
+     * @param width The width of the pixel neighborhood.
+     * @param height The height of the pixel neighborhood.
+     * @param channels The channel(s) to threshold.
+     */
+    adaptiveThreshold(width: number, height: number, channels: Channels): void;
+
+    /**
+     * Local adaptive threshold image.
+     * http://www.dai.ed.ac.uk/HIPR2/adpthrsh.htm.
+     * @param width The width of the pixel neighborhood.
+     * @param height The height of the pixel neighborhood.
+     * @param channels The channel(s) to threshold.
+     * @param bias Constant to subtract from pixel neighborhood mean (+/-)(0-QuantumRange).
+     */
+    adaptiveThreshold(width: number, height: number, bias: Percentage,): void;
+
+    /**
+     * Local adaptive threshold image.
+     * http://www.dai.ed.ac.uk/HIPR2/adpthrsh.htm.
+     * @param width The width of the pixel neighborhood.
+     * @param height The height of the pixel neighborhood.
+     * @param channels The channel(s) to threshold.
+     * @param bias Constant to subtract from pixel neighborhood mean (+/-)(0-QuantumRange).
+     * @param channels The channel(s) to threshold.
+     */
+    adaptiveThreshold(width: number, height: number, bias: Percentage, channels: Channels): void;
+
     /**
      * Add noise to image with the specified noise type.
      * @param noiseType The type of noise that should be added to the image.
@@ -2409,6 +2447,22 @@ export class MagickImage extends NativeInstance implements IMagickImage {
         });
     }
 
+    adaptiveThreshold(width: number, height: number): void;
+    adaptiveThreshold(width: number, height: number, channels: Channels): void;
+    adaptiveThreshold(width: number, height: number, bias: Percentage,): void;
+    adaptiveThreshold(width: number, height: number, bias: Percentage, channels: Channels): void;
+    adaptiveThreshold(width: number, height: number, biasChannelsOrUndefined?: Percentage | Channels, channelsOrUndefined?: Channels): void {
+        const bias = biasChannelsOrUndefined instanceof Percentage ? biasChannelsOrUndefined._toQuantum() : 0.0;
+        let channels = channelsOrUndefined ?? Channels.Undefined;
+        if (typeof biasChannelsOrUndefined === 'number')
+            channels = biasChannelsOrUndefined;
+
+        this.useException(exception => {
+            const instance = ImageMagick._api._MagickImage_AdaptiveThreshold(this._instance, width, height, bias, channels, exception.ptr);
+            this._setInstance(instance, exception);
+        });
+    }
+
     addNoise(noiseType: NoiseType): void;
     addNoise(noiseType: NoiseType, channels: Channels): void;
     addNoise(noiseType: NoiseType, attenuate: number): void;

tests/magick-image/adaptive-threshold.spec.ts

@@ -0,0 +1,40 @@
+/*
+  Copyright Dirk Lemstra https://github.com/dlemstra/magick-wasm.
+  Licensed under the Apache License, Version 2.0.
+*/
+
+import { Channels } from '@src/enums/channels';
+import { Percentage } from '@src/types/percentage';
+import { TestFiles } from '@test/test-files';
+
+describe('MagickImage#adaptiveSharpen', () => {
+    it('should threshold the image', () => {
+        TestFiles.Images.fujiFilmFinePixS1ProJpg.use(image => {
+            image.adaptiveThreshold(100, 100);
+
+            TestFiles.Images.fujiFilmFinePixS1ProJpg.use(original => {
+                expect(image).toEqualImage(original, 0.45749);
+            });
+        });
+    });
+
+    it('should use the bias percentage', () => {
+        TestFiles.Images.fujiFilmFinePixS1ProJpg.use(image => {
+            image.adaptiveThreshold(100, 100, new Percentage(50));
+
+            TestFiles.Images.fujiFilmFinePixS1ProJpg.use(original => {
+                expect(image).toEqualImage(original, 0.42296);
+            });
+        });
+    });
+
+    it('should use the specified channels', () => {
+        TestFiles.Images.fujiFilmFinePixS1ProJpg.use(image => {
+            image.adaptiveThreshold(100, 100, new Percentage(50), Channels.Green);
+
+            TestFiles.Images.fujiFilmFinePixS1ProJpg.use(original => {
+                expect(image).toEqualImage(original, 0.23814);
+            });
+        });
+    });
+});