adding conversion methods for converting argb colors between System.Int32 and System.Windows.Media.Color representations

Author: MovGP0

src/MaterialDesign3.MaterialColorUtilities/MaterialColorUtilities.csproj

@@ -24,6 +24,11 @@
     <NoWarn>CS0618</NoWarn>
   </PropertyGroup>
 
+  <!-- WPF may not be available when we want to target non-windows platforms in future -->
+  <PropertyGroup Condition="'$(TargetFramework)' == 'net462' OR '$(TargetFramework)' == 'net8.0-windows'">
+    <DefineConstants>$(DefineConstants);WPF</DefineConstants>
+  </PropertyGroup>
+
   <ItemGroup>
     <AssemblyAttribute Include="System.Reflection.AssemblyMetadataAttribute">
       <_Parameter1>MDIXColorsVersion</_Parameter1>

src/MaterialDesign3.MaterialColorUtilities/Utils/ColorUtils.cs

@@ -26,6 +26,24 @@ public static class ColorUtils
     /// </summary>
     public static int ArgbFromRgb(int red, int green, int blue) => (255 << 24) | ((red & 255) << 16) | ((green & 255) << 8) | (blue & 255);
 
+#if WPF
+    /// <summary>
+    /// Converts a color in ARGB format to a <see cref="System.Windows.Media.Color"/>.
+    /// </summary>
+    public static System.Windows.Media.Color ColorFromArgb(int argb) =>
+        System.Windows.Media.Color.FromArgb(
+            (byte)AlphaFromArgb(argb),
+            (byte)RedFromArgb(argb),
+            (byte)GreenFromArgb(argb),
+            (byte)BlueFromArgb(argb));
+
+    /// <summary>
+    /// Converts a <see cref="System.Windows.Media.Color"/> to ARGB format.
+    /// </summary>
+    public static int ArgbFromColor(System.Windows.Media.Color color) =>
+        (color.A << 24) | (color.R << 16) | (color.G << 8) | color.B;
+#endif
+
     /// <summary>
     /// Converts a color from linear RGB components to ARGB format.
     /// </summary>

tests/MaterialColorUtilities.Tests/ColorUtilsTests.cs

@@ -1,4 +1,8 @@
-namespace MaterialColorUtilities.Tests;
+#if WPF
+using System.Windows.Media;
+#endif
+
+namespace MaterialColorUtilities.Tests;
 
 public sealed class ColorUtilsTests
 {
@@ -264,4 +268,43 @@ public async Task Linearize_Delinearize_RoundTrip()
             await Assert.That(converted).IsEqualTo(c);
         }
     }
+
+#if WPF
+    public static IEnumerable<Func<(int argb, Color color)>> TestColors()
+    {
+        yield return () => (unchecked((int)0xFFFF0000), Colors.Red);
+        yield return () => (unchecked((int)0xFF00FF00), Colors.Lime);
+        yield return () => (unchecked((int)0xFF0000FF), Colors.Blue);
+        yield return () => (unchecked((int)0xFFFF00FF), Colors.Magenta);
+        yield return () => (unchecked((int)0xFFFFFF00), Colors.Yellow);
+        yield return () => (unchecked((int)0xFF00FFFF), Colors.Cyan);
+        yield return () => (unchecked((int)0xFFFFFFFF), Colors.White);
+        yield return () => (unchecked((int)0xFF000000), Colors.Black);
+        yield return () => (unchecked((int)0x00FFFFFF), Colors.Transparent);
+    }
+
+    [Test]
+    [DisplayName("colorFromArgb returns known Colors")]
+    [MethodDataSource(nameof(TestColors))]
+    public async Task ColorFromArgb_KnownColors(int argb, Color color)
+    {
+        var converted = ColorUtils.ColorFromArgb(argb);
+
+        string result = $"{converted.A:x}{converted.R:x}{converted.G:x}{converted.B:X}";
+        string expected = $"{color.A:x}{color.R:x}{color.G:x}{color.B:X}";
+
+        await Assert.That(result).IsEqualTo(expected);
+    }
+
+    [Test]
+    [DisplayName("argbFromColor returns known ints")]
+    [MethodDataSource(nameof(TestColors))]
+    public async Task ArgbFromColor_KnownColors(int argb, Color color)
+    {
+        string result = ColorUtils.ArgbFromColor(color).ToString("X");
+        string expected = argb.ToString("X");
+
+        await Assert.That(result).IsEqualTo(expected);
+    }
+#endif
 }

tests/MaterialColorUtilities.Tests/MaterialColorUtilities.Tests.csproj

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFrameworks>net8.0-windows</TargetFrameworks>
+    <TargetFramework>net8.0-windows</TargetFramework>
     <AssemblyTitle>MaterialColorUtilities.Tests</AssemblyTitle>
     <Product>MaterialColorUtilities.Tests</Product>
     <OutputType>Exe</OutputType>
@@ -13,6 +13,12 @@
     <EnableSourceLink>false</EnableSourceLink>
     <SuppressImplicitGitSourceLink>true</SuppressImplicitGitSourceLink>
   </PropertyGroup>
+
+  <!-- WPF may not be available when we want to target non-windows platforms in future -->
+  <PropertyGroup Condition="'$(TargetFramework)' == 'net462' OR '$(TargetFramework)' == 'net8.0-windows'">
+    <DefineConstants>$(DefineConstants);WPF</DefineConstants>
+  </PropertyGroup>
+
   <ItemGroup>
     <ProjectReference Include="..\..\src\MaterialDesign3.MaterialColorUtilities\MaterialColorUtilities.csproj" />
   </ItemGroup>