Added MipmapCount to the DdsWriteDefines that will replace the Mipmaps property in the next major release.

Author: dlemstra

src/Magick.NET/Formats/Dds/DdsWriteDefines.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 System.Collections.Generic;
 
 namespace ImageMagick.Formats;
@@ -35,7 +36,17 @@ public MagickFormat Format
     /// <summary>
     /// Gets or sets the the number of mipmaps, zero will disable writing mipmaps (dds:mipmaps).
     /// </summary>
-    public int? Mipmaps { get; set; }
+    [Obsolete($"This property will be removed in the next major release, use {nameof(MipmapCount)} instead.")]
+    public int? Mipmaps
+    {
+        get => MipmapCount;
+        set => MipmapCount = value;
+    }
+
+    /// <summary>
+    /// Gets or sets the the number of mipmaps, zero will disable writing mipmaps (dds:mipmaps).
+    /// </summary>
+    public int? MipmapCount { get; set; }
 
     /// <summary>
     /// Gets or sets a value indicating whether the mipmaps should be created from the images in the collection (dds:mipmaps=fromlist).
@@ -70,8 +81,8 @@ public IEnumerable<IDefine> Defines
 
             if (MipmapsFromCollection == true)
                 yield return new MagickDefine(Format, "mipmaps", "fromlist");
-            else if (Mipmaps.HasValue)
-                yield return new MagickDefine(Format, "mipmaps", Mipmaps.Value);
+            else if (MipmapCount.HasValue)
+                yield return new MagickDefine(Format, "mipmaps", MipmapCount.Value);
 
             if (Raw.HasValue)
                 yield return new MagickDefine(Format, "raw", Raw.Value);

tests/Magick.NET.Tests/Formats/Dds/DdsWriteDefinesTests/TheMipmapsProperty.cs renamed to tests/Magick.NET.Tests/Formats/Dds/DdsWriteDefinesTests/TheMipmapCountProperty.cs

@@ -9,14 +9,14 @@ namespace Magick.NET.Tests;
 
 public partial class DdsWriteDefinesTests
 {
-    public class TheMipmapsProperty
+    public class TheMipmapCountProperty
     {
         [Fact]
         public void ShouldSetTheDefine()
         {
             var defines = new DdsWriteDefines
             {
-                Mipmaps = 2,
+                MipmapCount = 2,
             };
 
             using var image = new MagickImage();

tests/Magick.NET.Tests/Formats/Dds/DdsWriteDefinesTests/TheMipmapsFromCollectionProperty.cs

@@ -17,7 +17,7 @@ public void ShouldSetTheDefine()
             var defines = new DdsWriteDefines
             {
                 MipmapsFromCollection = true,
-                Mipmaps = 4, // this is ignored
+                MipmapCount = 4, // this is ignored
             };
 
             using var image = new MagickImage();
@@ -32,7 +32,7 @@ public void ShouldBeIgnoredWhenSetToFalse()
             var defines = new DdsWriteDefines
             {
                 MipmapsFromCollection = false,
-                Mipmaps = 4,
+                MipmapCount = 4,
             };
 
             using var image = new MagickImage();