From 5d9cccc9fd3dc76ba586ec6773f1aad849acbafe Mon Sep 17 00:00:00 2001
From: Ellpeck <me@ellpeck.de>
Date: Wed, 22 Dec 2021 14:24:37 +0100
Subject: [PATCH] Added ColorExtensions.Multiply

---
 CHANGELOG.md                       |  1 +
 MLEM/Extensions/ColorExtensions.cs | 38 +++++++++++++++++++-----------
 2 files changed, 25 insertions(+), 14 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4a912b9..98db3bb 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -11,6 +11,7 @@ Jump to version:
 ### MLEM
 Additions
 - Added StringBuilder overloads to GenericFont
+- Added ColorExtensions.Multiply
 
 Improvements
 - Generify GenericFont's string drawing
diff --git a/MLEM/Extensions/ColorExtensions.cs b/MLEM/Extensions/ColorExtensions.cs
index e14f5b0..5095888 100644
--- a/MLEM/Extensions/ColorExtensions.cs
+++ b/MLEM/Extensions/ColorExtensions.cs
@@ -3,16 +3,16 @@ using Microsoft.Xna.Framework;
 
 namespace MLEM.Extensions {
     /// <summary>
-    /// A set of extensions for dealing with <see cref="Color"/> objects
+    /// A set of extensions for dealing with <see cref="Color"/> objects.
     /// </summary>
     public static class ColorExtensions {
 
         /// <summary>
-        /// Copies the alpha value from another color into this color.
+        /// Copies the alpha value from another color into this color and returns the result.
         /// </summary>
-        /// <param name="color">The color</param>
-        /// <param name="other">The color to copy the alpha from</param>
-        /// <returns>The first color with the second color's alpha value</returns>
+        /// <param name="color">The color.</param>
+        /// <param name="other">The color to copy the alpha from.</param>
+        /// <returns>The first color with the second color's alpha value.</returns>
         public static Color CopyAlpha(this Color color, Color other) {
             return color * (other.A / 255F);
         }
@@ -20,16 +20,26 @@ namespace MLEM.Extensions {
         /// <summary>
         /// Returns an inverted version of this color.
         /// </summary>
-        /// <param name="color">The color to invert</param>
-        /// <returns>The inverted color</returns>
+        /// <param name="color">The color to invert.</param>
+        /// <returns>The inverted color.</returns>
         public static Color Invert(this Color color) {
             return new Color(255 - color.R, 255 - color.G, 255 - color.B, color.A);
         }
 
+        /// <summary>
+        /// Multiplies this color with another color and returns the result.
+        /// </summary>
+        /// <param name="color">The first color.</param>
+        /// <param name="other">The second color.</param>
+        /// <returns>The two colors multiplied together.</returns>
+        public static Color Multiply(this Color color, Color other) {
+            return new Color(color.ToVector4() * other.ToVector4());
+        }
+
     }
 
     /// <summary>
-    /// A set of utility methods for dealing with <see cref="Color"/> objects
+    /// A set of utility methods for dealing with <see cref="Color"/> objects.
     /// </summary>
     public static class ColorHelper {
 
@@ -37,8 +47,8 @@ namespace MLEM.Extensions {
         /// Parses a hexadecimal number into an rgba color.
         /// The number should be in the format <c>0xaarrggbb</c>.
         /// </summary>
-        /// <param name="value">The number to parse</param>
-        /// <returns>The resulting color</returns>
+        /// <param name="value">The number to parse.</param>
+        /// <returns>The resulting color.</returns>
         public static Color FromHexRgba(int value) {
             return new Color(value >> 16 & 0xFF, value >> 8 & 0xFF, value >> 0 & 0xFF, value >> 24 & 0xFF);
         }
@@ -47,8 +57,8 @@ namespace MLEM.Extensions {
         /// Parses a hexadecimal number into an rgb color with 100% alpha.
         /// The number should be in the format <c>0xrrggbb</c>.
         /// </summary>
-        /// <param name="value">The number to parse</param>
-        /// <returns>The resulting color</returns>
+        /// <param name="value">The number to parse.</param>
+        /// <returns>The resulting color.</returns>
         public static Color FromHexRgb(int value) {
             return new Color(value >> 16 & 0xFF, value >> 8 & 0xFF, value >> 0 & 0xFF);
         }
@@ -57,8 +67,8 @@ namespace MLEM.Extensions {
         /// Parses a hexadecimal string into a color.
         /// The string can either be formatted as RRGGBB or AARRGGBB and can optionally start with a <c>#</c>.
         /// </summary>
-        /// <param name="value">The string to parse</param>
-        /// <returns>The resulting color</returns>
+        /// <param name="value">The string to parse.</param>
+        /// <returns>The resulting color.</returns>
         public static Color FromHexString(string value) {
             if (value.StartsWith("#"))
                 value = value.Substring(1);