Added convenience methods for matrices

Author: HexagonNico

src/main/scala/io/github/hexagonnico/vecmatlib/matrix/Mat4d.scala

@@ -131,6 +131,16 @@ case class Mat4d(
    */
   override def *(v: Vec4d): Vec4d = Vec4d(this.row0 dot v, this.row1 dot v, this.row2 dot v, this.row3 dot v)
 
+  /**
+   * Returns the product of this matrix by the given vector.
+   * Allows a more convenient way to multiply vectors by transformation matrices.
+   *
+   * @param v The X, Y, and Z components of the vector by which this matrix is multiplied
+   * @param w The W component of the vector by which this matrix is multiplied
+   * @return The product of this matrix by the given vector
+   */
+  def *(v: Vec3d, w: Double): Vec4d = this * (v.x, v.y, v.z, w)
+
   /**
    * Returns the product of this matrix by the vector with the given components.
    *
@@ -153,6 +163,18 @@ case class Mat4d(
    */
   def multiply(x: Double, y: Double, z: Double, w: Double): Vec4d = this * Vec4d(x, y, z, w)
 
+  /**
+   * Returns the product of this matrix by the given vector.
+   * Allows a more convenient way to multiply vectors by transformation matrices.
+   *
+   * This method can be used in place of the '*' operator for better interoperability with Java.
+   *
+   * @param v The X, Y, and Z components of the vector by which this matrix is multiplied
+   * @param w The W component of the vector by which this matrix is multiplied
+   * @return The product of this matrix by the given vector
+   */
+  def multiply(v: Vec3d, w: Double): Vec4d = this * (v, w)
+
   /**
    * Returns the product between this matrix and the given one.
    *

src/main/scala/io/github/hexagonnico/vecmatlib/matrix/Mat4f.scala

@@ -131,6 +131,16 @@ case class Mat4f(
    */
   override def *(v: Vec4f): Vec4f = Vec4f(this.row0 dot v, this.row1 dot v, this.row2 dot v, this.row3 dot v)
 
+  /**
+   * Returns the product of this matrix by the given vector.
+   * Allows a more convenient way to multiply vectors by transformation matrices.
+   *
+   * @param v The X, Y, and Z components of the vector by which this matrix is multiplied
+   * @param w The W component of the vector by which this matrix is multiplied
+   * @return The product of this matrix by the given vector
+   */
+  def *(v: Vec3f, w: Float): Vec4f = this * (v.x, v.y, v.z, w)
+
   /**
    * Returns the product of this matrix by the vector with the given components.
    *
@@ -153,6 +163,18 @@ case class Mat4f(
    */
   def multiply(x: Float, y: Float, z: Float, w: Float): Vec4f = this * Vec4f(x, y, z, w)
 
+  /**
+   * Returns the product of this matrix by the given vector.
+   * Allows a more convenient way to multiply vectors by transformation matrices.
+   *
+   * This method can be used in place of the '*' operator for better interoperability with Java.
+   *
+   * @param v The X, Y, and Z components of the vector by which this matrix is multiplied
+   * @param w The W component of the vector by which this matrix is multiplied
+   * @return The product of this matrix by the given vector
+   */
+  def multiply(v: Vec3f, w: Float): Vec4f = this * (v, w)
+
   /**
    * Returns the product between this matrix and the given one.
    *

src/main/scala/io/github/hexagonnico/vecmatlib/matrix/Mat4i.scala

@@ -1,6 +1,6 @@
 package io.github.hexagonnico.vecmatlib.matrix
 
-import io.github.hexagonnico.vecmatlib.vector.Vec4i
+import io.github.hexagonnico.vecmatlib.vector.{Vec3i, Vec4i}
 
 /**
  * 4x4 int matrix.
@@ -131,6 +131,15 @@ case class Mat4i(
    */
   override def *(v: Vec4i): Vec4i = Vec4i(this.row0 dot v, this.row1 dot v, this.row2 dot v, this.row3 dot v)
 
+  /**
+   * Returns the product of this matrix by the given vector.
+   *
+   * @param v The X, Y, and Z components of the vector by which this matrix is multiplied
+   * @param w The W component of the vector by which this matrix is multiplied
+   * @return The product of this matrix by the given vector
+   */
+  def *(v: Vec3i, w: Int): Vec4i = this * (v.x, v.y, v.z, w)
+
   /**
    * Returns the product of this matrix by the vector with the given components.
    *
@@ -153,6 +162,17 @@ case class Mat4i(
    */
   def multiply(x: Int, y: Int, z: Int, w: Int): Vec4i = this * Vec4i(x, y, z, w)
 
+  /**
+   * Returns the product of this matrix by the given vector.
+   *
+   * This method can be used in place of the '*' operator for better interoperability with Java.
+   *
+   * @param v The X, Y, and Z components of the vector by which this matrix is multiplied
+   * @param w The W component of the vector by which this matrix is multiplied
+   * @return The product of this matrix by the given vector
+   */
+  def multiply(v: Vec3i, w: Int): Vec4i = this * (v, w)
+
   /**
    * Returns the product between this matrix and the given one.
    *