@babylonjs/core 5.17.0 → 5.19.0

package/Maths/math.vector.js

@@ -406,6 +406,16 @@ var Vector2 = /** @class */ (function () {
     Vector2.One = function () {
         return new Vector2(1, 1);
     };
+    Object.defineProperty(Vector2, "ZeroReadOnly", {
+        /**
+         * Gets a zero Vector2 that must not be updated
+         */
+        get: function () {
+            return Vector2._ZeroReadOnly;
+        },
+        enumerable: false,
+        configurable: true
+    });
     /**
      * Gets a new Vector2 set from the given index element of the given array
      * @param array defines the data source
@@ -677,6 +687,7 @@ var Vector2 = /** @class */ (function () {
         var proj = segA.add(v.multiplyByFloats(t, t));
         return Vector2.Distance(p, proj);
     };
+    Vector2._ZeroReadOnly = Vector2.Zero();
     return Vector2;
 }());
 export { Vector2 };
@@ -989,7 +1000,7 @@ var Vector3 = /** @class */ (function () {
         return result.addInPlaceFromFloats(this._x * scale, this._y * scale, this._z * scale);
     };
     /**
-     * Projects the current vector3 to a plane along a ray starting from a specified origin and directed towards the point.
+     * Projects the current point Vector3 to a plane along a ray starting from a specified origin and passing through the current point Vector3.
      * @param plane defines the plane to project to
      * @param origin defines the origin of the projection ray
      * @returns the projected vector3
@@ -1000,41 +1011,29 @@ var Vector3 = /** @class */ (function () {
         return result;
     };
     /**
-     * Projects the current vector3 to a plane along a ray starting from a specified origin and directed towards the point.
+     * Projects the current point Vector3 to a plane along a ray starting from a specified origin and passing through the current point Vector3.
      * @param plane defines the plane to project to
      * @param origin defines the origin of the projection ray
      * @param result defines the Vector3 where to store the result
      */
     Vector3.prototype.projectOnPlaneToRef = function (plane, origin, result) {
-        // Use the normal scaled to the plane offset as the origin for the formula
-        var planeOrigin = MathTmp.Vector3[0];
-        plane.normal.scaleToRef(-plane.d, planeOrigin);
-        // Since the normal in Babylon should point toward the viewer, invert it for the dot product
-        var inverseNormal = MathTmp.Vector3[1];
-        plane.normal.negateToRef(inverseNormal);
-        // This vector is the direction
-        var _a = this, x = _a.x, y = _a.y, z = _a.z;
-        // Calculate how close the direction is to the normal of the plane
-        var dotProduct = Vector3.Dot(inverseNormal, this);
-        /*
-         * Early out in case the direction will never hit the plane.
-         *
-         * Epsilon is used to avoid issues with rays very near to parallel with the
-         * plane, and squared because as of writing the value is not sufficiently
-         * small for this use case.
-         */
-        if (dotProduct <= Epsilon * Epsilon) {
-            // No good option for setting the result vector here, so just take the origin of the ray
-            result.copyFrom(origin);
-            return;
+        var n = plane.normal;
+        var d = plane.d;
+        var V = MathTmp.Vector3[0];
+        // ray direction
+        this.subtractToRef(origin, V);
+        V.normalize();
+        var denom = Vector3.Dot(V, n);
+        //When the ray is close to parallel to the plane return infinity vector
+        if (Math.abs(denom) < Math.pow(10, -10)) {
+            result.setAll(Infinity);
+        }
+        else {
+            var t = -(Vector3.Dot(origin, n) + d) / denom;
+            // P = P0 + t*V
+            var scaledV = V.scaleInPlace(t);
+            origin.addToRef(scaledV, result);
         }
-        // Calculate the offset
-        var relativeOrigin = MathTmp.Vector3[2];
-        planeOrigin.subtractToRef(origin, relativeOrigin);
-        // Calculate the length along the direction vector to the hit point
-        var hitDistance = Vector3.Dot(relativeOrigin, inverseNormal) / dotProduct;
-        // Apply the hit point by adding the direction scaled by the distance to the origin
-        result.set(origin.x + x * hitDistance, origin.y + y * hitDistance, origin.z + z * hitDistance);
     };
     /**
      * Returns true if the current Vector3 and the given vector coordinates are strictly equal
@@ -1582,7 +1581,7 @@ var Vector3 = /** @class */ (function () {
     };
     Object.defineProperty(Vector3, "UpReadOnly", {
         /**
-         * Gets a up Vector3 that must not be updated
+         * Gets an up Vector3 that must not be updated
          */
         get: function () {
             return Vector3._UpReadOnly;
@@ -1590,6 +1589,16 @@ var Vector3 = /** @class */ (function () {
         enumerable: false,
         configurable: true
     });
+    Object.defineProperty(Vector3, "DownReadOnly", {
+        /**
+         * Gets a down Vector3 that must not be updated
+         */
+        get: function () {
+            return Vector3._DownReadOnly;
+        },
+        enumerable: false,
+        configurable: true
+    });
     Object.defineProperty(Vector3, "RightReadOnly", {
         /**
          * Gets a right Vector3 that must not be updated
@@ -2305,6 +2314,7 @@ var Vector3 = /** @class */ (function () {
         quat.toEulerAnglesToRef(ref);
     };
     Vector3._UpReadOnly = Vector3.Up();
+    Vector3._DownReadOnly = Vector3.Down();
     Vector3._LeftHandedForwardReadOnly = Vector3.Forward(false);
     Vector3._RightHandedForwardReadOnly = Vector3.Forward(true);
     Vector3._RightReadOnly = Vector3.Right();
@@ -2882,6 +2892,16 @@ var Vector4 = /** @class */ (function () {
     Vector4.One = function () {
         return new Vector4(1.0, 1.0, 1.0, 1.0);
     };
+    Object.defineProperty(Vector4, "ZeroReadOnly", {
+        /**
+         * Gets a zero Vector4 that must not be updated
+         */
+        get: function () {
+            return Vector4._ZeroReadOnly;
+        },
+        enumerable: false,
+        configurable: true
+    });
     /**
      * Returns a new normalized Vector4 from the given one.
      * @param vector the vector to normalize
@@ -3065,6 +3085,7 @@ var Vector4 = /** @class */ (function () {
         if (w === void 0) { w = 0; }
         return new Vector4(source._x, source._y, source._z, w);
     };
+    Vector4._ZeroReadOnly = Vector4.Zero();
     return Vector4;
 }());
 export { Vector4 };