feat: add precomputed directionInv to Ray3f for optimized ray-box

intersection

- Introduced the `directionInv` field in the `Ray3f` class to store the
reciprocal of the direction vector components.
- Precomputing the reciprocal reduces computation overhead in operations
like ray-box intersections, improving performance.
- Updated the constructor to calculate and assign `directionInv` during
ray initialization.

Author: ArtifactForms

src/main/java/math/Ray3f.java

@@ -22,6 +22,12 @@ public class Ray3f {
 	 */
 	private final Vector3f direction;
 
+	/**
+	 * The reciprocal of the direction vector, used for optimized ray-box
+	 * intersection.
+	 */
+	private final Vector3f directionInv;
+
 	/**
 	 * Constructs a new {@code Ray3f} with the given origin and direction.
 	 * <p>
@@ -45,10 +51,14 @@ public Ray3f(Vector3f origin, Vector3f direction) {
 		this.origin = origin;
 		this.direction = direction;
 		this.direction.normalizeLocal();
+		this.directionInv = direction.reciprocal();
 	}
 
 	/**
 	 * Returns the origin of the ray.
+	 * <p>
+	 * The origin is the starting point from which the ray emanates.
+	 * </p>
 	 * 
 	 * @return The origin of the ray.
 	 */
@@ -58,13 +68,32 @@ public Vector3f getOrigin() {
 
 	/**
 	 * Returns the normalized direction vector of the ray.
+	 * <p>
+	 * The direction vector defines the direction in which the ray travels. The
+	 * vector is normalized, ensuring consistent calculations for operations like
+	 * intersections.
+	 * </p>
 	 * 
 	 * @return The direction vector of the ray.
 	 */
 	public Vector3f getDirection() {
 		return direction;
 	}
 
+	/**
+	 * Returns the reciprocal of the direction vector of the ray.
+	 * <p>
+	 * The reciprocal of the direction vector is precomputed to optimize ray-box
+	 * intersection tests, where division by components of the direction vector is
+	 * required.
+	 * </p>
+	 * 
+	 * @return The reciprocal of the direction vector of the ray.
+	 */
+	public Vector3f getDirectionInv() {
+		return directionInv;
+	}
+
 	/**
 	 * Computes the point along the ray at a given parameter {@code t}.
 	 * <p>
@@ -77,10 +106,12 @@ public Vector3f getDirection() {
 	 * </pre>
 	 * 
 	 * where {@code t} is a scalar representing the distance along the ray from
-	 * the origin.
+	 * the origin. Positive values of {@code t} will give points in the direction
+	 * the ray is pointing, while negative values will give points in the opposite
+	 * direction.
 	 * </p>
 	 * 
-	 * @param t The parameter along the ray (can be negative, zero, or positive)-
+	 * @param t The parameter along the ray (can be negative, zero, or positive).
 	 * @return The point at parameter {@code t}.
 	 */
 	public Vector3f getPointAt(float t) {