fix: add guards for MagickImage.Clahe (#1551)

Author: Gounlaf

src/Magick.NET.Core/IMagickImage.cs

@@ -738,6 +738,7 @@ Interlace Interlace
     /// <param name="numberBins">The number of bins for histogram ("dynamic range").</param>
     /// <param name="clipLimit">The contrast limit for localised changes in contrast. A limit less than 1
     /// results in standard non-contrast limited AHE.</param>
+    /// <exception cref="MagickException">Thrown when an error is raised by ImageMagick.</exception>
     void Clahe(Percentage xTiles, Percentage yTiles, int numberBins, double clipLimit);
 
     /// <summary>
@@ -749,6 +750,7 @@ Interlace Interlace
     /// <param name="numberBins">The number of bins for histogram ("dynamic range").</param>
     /// <param name="clipLimit">The contrast limit for localised changes in contrast. A limit less than 1
     /// results in standard non-contrast limited AHE.</param>
+    /// <exception cref="MagickException">Thrown when an error is raised by ImageMagick.</exception>
     void Clahe(int xTiles, int yTiles, int numberBins, double clipLimit);
 
     /// <summary>

src/Magick.NET/MagickImage.cs

@@ -1539,6 +1539,7 @@ public void ChopVertical(int offset, int height)
     /// <param name="numberBins">The number of bins for histogram ("dynamic range").</param>
     /// <param name="clipLimit">The contrast limit for localised changes in contrast. A limit less than 1
     /// results in standard non-contrast limited AHE.</param>
+    /// <exception cref="MagickException">Thrown when an error is raised by ImageMagick.</exception>
     public void Clahe(Percentage xTiles, Percentage yTiles, int numberBins, double clipLimit)
         => Clahe(Width * xTiles, Height * yTiles, numberBins, clipLimit);
 
@@ -1551,8 +1552,15 @@ public void Clahe(Percentage xTiles, Percentage yTiles, int numberBins, double c
     /// <param name="numberBins">The number of bins for histogram ("dynamic range").</param>
     /// <param name="clipLimit">The contrast limit for localised changes in contrast. A limit less than 1
     /// results in standard non-contrast limited AHE.</param>
+    /// <exception cref="MagickException">Thrown when an error is raised by ImageMagick.</exception>
     public void Clahe(int xTiles, int yTiles, int numberBins, double clipLimit)
-        => _nativeInstance.Clahe(xTiles, yTiles, numberBins, clipLimit);
+    {
+        Throw.IfNegative(nameof(xTiles), xTiles);
+        Throw.IfNegative(nameof(yTiles), yTiles);
+        Throw.IfNegative(nameof(numberBins), numberBins);
+
+        _nativeInstance.Clahe(xTiles, yTiles, numberBins, clipLimit);
+    }
 
     /// <summary>
     /// Set each pixel whose value is below zero to zero and any the pixel whose value is above

tests/Magick.NET.Tests/MagickImageTests/TheClaheMethod.cs

@@ -1,6 +1,7 @@
 // Copyright Dirk Lemstra https://github.com/dlemstra/Magick.NET.
 // Licensed under the Apache License, Version 2.0.
 
+using System;
 using ImageMagick;
 using Xunit;
 
@@ -10,6 +11,27 @@ public partial class MagickImageTests
 {
     public class TheClaheMethod
     {
+        [Fact]
+        public void ShouldThrowExceptionWhenXTilesIsNegative()
+        {
+            using var image = new MagickImage(Files.FujiFilmFinePixS1ProPNG);
+            Assert.Throws<ArgumentException>("xTiles", () => image.Clahe(-10, 20, 30, 1.5));
+        }
+
+        [Fact]
+        public void ShouldThrowExceptionWhenYTilesIsNegative()
+        {
+            using var image = new MagickImage(Files.FujiFilmFinePixS1ProPNG);
+            Assert.Throws<ArgumentException>("yTiles", () => image.Clahe(10, -20, 30, 1.5));
+        }
+
+        [Fact]
+        public void ShouldThrowExceptionWhenNumberBinsIsNegative()
+        {
+            using var image = new MagickImage(Files.FujiFilmFinePixS1ProPNG);
+            Assert.Throws<ArgumentException>("numberBins", () => image.Clahe(10, 20, -30, 1.5));
+        }
+
         [Fact]
         public void ShouldChangeTheImage()
         {