Added scale extension methods for Vector2/Vector3

Author: StephanHooft

Runtime/Extensions/Unity/Vector2Extensions.cs

@@ -61,6 +61,42 @@ public static Vector2 Rotate(this Vector2 source, float rotationAmount, bool use
                 new Vector2(rotatedX, rotatedY);
         }
 
+        /// <summary>
+        /// Returns the <see cref="Vector2"/> with a set <paramref name="x"/> component, and Y-component
+        /// scaled to match while retaining the X,Y proportions of the source <see cref="Vector2"/>.
+        /// </summary>
+        /// <param name="x">
+        /// A X-component value for the scaled <see cref="Vector2"/>.
+        /// </param>
+        /// <returns>
+        /// A <see cref="Vector2"/>.
+        /// </returns>
+        public static Vector2 ScaledToX(this Vector2 source, float x)
+        {
+            var factor = x / source.x;
+            var y = source.y * factor;
+            return
+                new(x, y);
+        }
+
+        /// <summary>
+        /// Returns the <see cref="Vector2"/> with a set <paramref name="y"/> component, and X-component
+        /// scaled to match while retaining the X,Y proportions of the source <see cref="Vector2"/>.
+        /// </summary>
+        /// <param name="y">
+        /// A Y-component value for the scaled <see cref="Vector2"/>.
+        /// </param>
+        /// <returns>
+        /// A <see cref="Vector2"/>.
+        /// </returns>
+        public static Vector2 ScaledToY(this Vector2 source, float y)
+        {
+            var factor = y / source.y;
+            var x = source.x * factor;
+            return
+                new(x, y);
+        }
+
         /// <summary>
         /// Converts a <see cref="Vector2"/>[] into a <see cref="Vector3"/>[].
         /// </summary>

Runtime/Extensions/Unity/Vector3Extensions.cs

@@ -31,7 +31,7 @@ public static float DistanceTo(this Vector3 source, Vector3 destination)
         }
 
         /// <summary>
-        /// Return the <see cref="Vector3"/> with its Y-component to 0.
+        /// Return the <see cref="Vector3"/> with its Y-component at 0.
         /// </summary>
         /// <returns>A modified <see cref="Vector3"/> with y component set to 0.</returns>
         public static Vector3 Flat(this Vector3 source)
@@ -40,6 +40,63 @@ public static Vector3 Flat(this Vector3 source)
                 new Vector3(source.x, 0, source.z);
         }
 
+        /// <summary>
+        /// Returns the <see cref="Vector3"/> with a set <paramref name="x"/> component, and Y- and Z-components
+        /// scaled to match while retaining the X,Y,Z proportions of the source <see cref="Vector3"/>.
+        /// </summary>
+        /// <param name="x">
+        /// A X-component value for the scaled <see cref="Vector3"/>.
+        /// </param>
+        /// <returns>
+        /// A <see cref="Vector3"/>.
+        /// </returns>
+        public static Vector3 ScaledToX(this Vector3 source, float x)
+        {
+            var factor = x / source.x;
+            var y = source.y * factor;
+            var z = source.z * factor;
+            return
+                new(x, y, z);
+        }
+
+        /// <summary>
+        /// Returns the <see cref="Vector3"/> with a set <paramref name="y"/> component, and X- and Z-components
+        /// scaled to match while retaining the X,Y,Z proportions of the source <see cref="Vector3"/>.
+        /// </summary>
+        /// <param name="y">
+        /// A Y-component value for the scaled <see cref="Vector3"/>.
+        /// </param>
+        /// <returns>
+        /// A <see cref="Vector3"/>.
+        /// </returns>
+        public static Vector3 ScaledToY(this Vector3 source, float y)
+        {
+            var factor = y / source.y;
+            var x = source.x * factor;
+            var z = source.z * factor;
+            return
+                new(x, y, z);
+        }
+
+        /// <summary>
+        /// Returns the <see cref="Vector3"/> with a set <paramref name="z"/> component, and X- and Y-components
+        /// scaled to match while retaining the X,Y,Z proportions of the source <see cref="Vector3"/>.
+        /// </summary>
+        /// <param name="z">
+        /// A Z-component value for the scaled <see cref="Vector3"/>.
+        /// </param>
+        /// <returns>
+        /// A <see cref="Vector3"/>.
+        /// </returns>
+        public static Vector3 ScaledToZ(this Vector3 source, float z)
+        {
+            var factor = z / source.z;
+            var x = source.x * factor;
+            var y = source.y * factor;
+            return
+                new(x, y, z);
+        }
+
         /// <summary>
         /// Converts a <see cref="Vector3"/>[] into a <see cref="Vector2"/>[].
         /// </summary>

package.json

@@ -1,6 +1,6 @@
 {
   "name": "com.stephanhooft.unity-tools",
-  "version": "7.4.2",
+  "version": "7.5.0",
   "displayName": "Unity Tools",
   "description": "A Unity package for code to reuse across projects.",
   "unity": "2021.3",