x_ite 8.7.4 → 8.7.5

package/docs/_config.yml

@@ -20,7 +20,7 @@ timezone:
 # ↓ --------------------------
 
 title: X_ITE X3D Browser               # the main title
-version: 8.7.4                         # x_ite latest version
+version: 8.7.5                         # x_ite latest version
 size: 290                              # size in kb
 x3d_latest_version: 4.0                # x3d latest version
 

package/docs/_posts/reference/field-services-and-objects.md

@@ -263,11 +263,21 @@ None
 
 #### void **setTransform** (*translation*, *rotation*, *scaleFactor*, *scaleOrientation*, *center*)
 
-Sets the SFMatrix3d/f to the passed values. *translation* is an SFVec2d/f object, *rotation* is a Number, *scaleFactor* is a SFVec2d/f object, *scaleOrientation* is a Number and *center* is a SFVec2d/f object. Any of the rightmost parameters can be omitted. In other words, the method can take from 0 to 5 parameters. For example, you can specify 0 parameters (resulting in a identity matrix), 1 parameter (a translation), 2 parameters (a translation and a rotation), 3 parameters (a translation, rotation and a scaleFactor), etc. Any unspecified parameter is set to its default as specified in the **Transform** node section of the X3D specification.
+Sets the SFMatrix3d/f to the passed values. *translation* is an SFVec2d/f object, *rotation* is a Number, *scaleFactor* is a SFVec2d/f object, *scaleOrientation* is a Number and *center* is a SFVec2d/f object.
 
-#### void **getTransform** (*translation*, *rotation*, *scaleFactor*)
+Any of the rightmost parameters can be omitted, or any parameter can be `null`. In other words, the method can take from 0 to 5 parameters. For example, you can specify 0 parameters (resulting in a identity matrix), 1 parameter (a translation), 2 parameters (a translation and a rotation), 3 parameters (a translation, rotation and a scaleFactor), etc. Any unspecified parameter is set to its default as specified in the **Transform** node section of the X3D specification.
 
-Decomposes the SFMatrix3d/f and returns the components in the passed *translation*, *rotation*, and *scaleFactor* objects*. rotation* is a SFVec3d/f where x and y are the complex value of the rotation and z is the rotation angle in radians. The other types of the parameters are the same as in **setTransform**. Any projection or shear information in the matrix is ignored.
+#### void **getTransform** (*translation*, *rotation*, *scaleFactor*, *scaleOrientation*, *center*)
+
+Decomposes the SFMatrix3d/f and returns the components in the passed *translation*, *rotation*, and *scaleFactor* objects*. rotation* is a SFVec3d/f, where x and y are the complex value of the rotation and z is the rotation angle in radians. The other types of the parameters are the same as in **setTransform**.
+
+Any of the rightmost parameters can be omitted, or any parameter can be `null`. In other words, the method can take from 0 to 5 parameters. For example, you can specify 0 parameters (resulting in a identity matrix), 1 parameter (a translation), 2 parameters (a translation and a rotation), 3 parameters (a translation, rotation and a scaleFactor), etc. Any unspecified parameter is set to its default as specified in the **Transform** node section of the X3D specification.
+
+A center of any value can be specified around which the rotation and scaling will take place.
+
+#### Number **determinant** ()
+
+Returns the determinant of this object's matrix.
 
 #### SFMatrix3d/f **inverse** ()
 
@@ -327,11 +337,21 @@ None
 
 #### void **setTransform** (*translation*, *rotation*, *scaleFactor*, *scaleOrientation*, *center*)
 
-Sets the SFMatrix4d/f to the passed values. *translation* is an SFVec3d/f object, *rotation* is a SFRotation object, *scaleFactor* is a SFVec3d/f object, *scaleOrientation* is a SFRotation object and *center* is a SFVec3d/f object. Any of the rightmost parameters can be omitted. In other words, the method can take from 0 to 5 parameters. For example, you can specify 0 parameters (resulting in a identity matrix), 1 parameter (a translation), 2 parameters (a translation and a rotation), 3 parameters (a translation, rotation and a scaleFactor), etc. Any unspecified parameter is set to its default as specified in the **Transform** node section of the X3D specification.
+Sets the SFMatrix4d/f to the passed values. *translation* is an SFVec3d/f object, *rotation* is a SFRotation object, *scaleFactor* is a SFVec3d/f object, *scaleOrientation* is a SFRotation object and *center* is a SFVec3d/f object.
+
+Any of the rightmost parameters can be omitted. In other words, the method can take from 0 to 5 parameters. For example, you can specify 0 parameters (resulting in a identity matrix), 1 parameter (a translation), 2 parameters (a translation and a rotation), 3 parameters (a translation, rotation and a scaleFactor), etc. Any unspecified parameter is set to its default as specified in the **Transform** node section of the X3D specification.
+
+#### void **getTransform** (*translation*, *rotation*, *scaleFactor*, *scaleOrientation*, *center*)
+
+Decomposes the SFMatrix4d/f and returns the components in the passed *translation*, *rotation*, and *scaleFactor* objects. The types of the parameters are the same as in **setTransform**.
+
+Any of the rightmost parameters can be omitted. In other words, the method can take from 0 to 5 parameters. For example, you can specify 0 parameters (resulting in a identity matrix), 1 parameter (a translation), 2 parameters (a translation and a rotation), 3 parameters (a translation, rotation and a scaleFactor), etc. Any unspecified parameter is set to its default as specified in the **Transform** node section of the X3D specification.
+
+A center of any value can be specified around which the rotation and scaling will take place.
 
-#### void **getTransform** (*translation*, *rotation*, *scaleFactor*)
+#### Number **determinant** ()
 
-Decomposes the SFMatrix4d/f and returns the components in the passed *translation*, *rotation*, and *scaleFactor* objects*.* The types of the parameters are the same as in **setTransform**. Any projection or shear information in the matrix is ignored.
+Returns the determinant of this object's matrix.
 
 #### SFMatrix4d/f **inverse** ()
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "x_ite",
-	"version": "8.7.4",
+	"version": "8.7.5",
 	"description": "X_ITE X3D Browser, view and manipulate X3D and VRML scenes in HTML.",
 	"homepage": "https://create3000.github.io/x_ite/",
 	"author": "Holger Seelig <holger.seelig@gmail.com>",

package/src/standard/Math/Algorithms/eigen_decomposition.js

@@ -55,23 +55,23 @@ function eigen_decomposition (matrix, result)
 {
    const
       ORDER   = matrix .order,
+      SIZE    = matrix .length,
       values  = result .values,
       vectors = result .vectors;
 
    let
-      sm,                // smallest entry
-      theta,             // angle for Jacobi rotation
-      c, s, t,           // cosine, sine, tangent of theta
-      tau,               // sine / (1 + cos)
-      h, g,              // two scrap values
-      thresh,            // threshold below which no rotation done
-      p, q, i, j,
-      SIZE = matrix .length;
+      sm,         // smallest entry
+      theta,      // angle for Jacobi rotation
+      c, s, t,    // cosine, sine, tangent of theta
+      tau,        // sine / (1 + cos)
+      h, g,       // two scrap values
+      thresh,     // threshold below which no rotation done
+      p, q, i, j; // indices
 
    // initializations
    for (i = 0; i < ORDER; ++ i)
    {
-      a [i] = a [i] || new Array (ORDER);
+      a [i] = a [i] ?? [ ];
       b [i] = values [i] = matrix .get1 (i, i);
       z [i] = 0;
 

package/src/standard/Math/Geometry/Box2.js

@@ -203,33 +203,33 @@ Box2 .prototype =
    },
 };
 
-Object .defineProperty (Box2 .prototype, "size",
+Object .defineProperties (Box2 .prototype,
 {
-   get: (function ()
+   size:
    {
-      const
-         min = new Vector2 (0, 0),
-         max = new Vector2 (0, 0);
-
-      return function ()
+      get: (function ()
       {
-         this .getAbsoluteExtents (min, max);
+         const
+            min = new Vector2 (0, 0),
+            max = new Vector2 (0, 0);
 
-         return max .subtract (min);
-      };
-   })(),
-   enumerable: true,
-   configurable: false
-});
+         return function ()
+         {
+            this .getAbsoluteExtents (min, max);
 
-Object .defineProperty (Box2 .prototype, "center",
-{
-   get: function ()
+            return max .subtract (min);
+         };
+      })(),
+      enumerable: true,
+   },
+   center:
    {
-      return this .matrix .origin;
+      get: function ()
+      {
+         return this .matrix .origin;
+      },
+      enumerable: true,
    },
-   enumerable: true,
-   configurable: false
 });
 
 export default Box2;

package/src/standard/Math/Geometry/Box3.js

@@ -611,33 +611,33 @@ Box3 .prototype =
    },
 };
 
-Object .defineProperty (Box3 .prototype, "size",
+Object .defineProperties (Box3 .prototype,
 {
-   get: (function ()
+   size:
    {
-      const
-         min = new Vector3 (0, 0, 0),
-         max = new Vector3 (0, 0, 0);
-
-      return function ()
+      get: (function ()
       {
-         this .getAbsoluteExtents (min, max);
+         const
+            min = new Vector3 (0, 0, 0),
+            max = new Vector3 (0, 0, 0);
 
-         return max .subtract (min);
-      };
-   })(),
-   enumerable: true,
-   configurable: false
-});
+         return function ()
+         {
+            this .getAbsoluteExtents (min, max);
 
-Object .defineProperty (Box3 .prototype, "center",
-{
-   get: function ()
+            return max .subtract (min);
+         };
+      })(),
+      enumerable: true,
+   },
+   center:
    {
-      return this .matrix .origin;
+      get: function ()
+      {
+         return this .matrix .origin;
+      },
+      enumerable: true,
    },
-   enumerable: true,
-   configurable: false
 });
 
 export default Box3;

package/src/standard/Math/Numbers/Color3.js

@@ -64,7 +64,6 @@ function Color3 (r, g, b)
 Color3 .prototype =
 {
    constructor: Color3,
-   length: 3,
    [Symbol .iterator]: function* ()
    {
       yield this [_r];
@@ -180,35 +179,28 @@ Color3 .prototype =
 const r = {
    get: function () { return this [_r]; },
    set: function (value) { this [_r] = clamp (value, 0, 1); },
-   enumerable: true,
-   configurable: false
 };
 
 const g = {
    get: function () { return this [_g]; },
    set: function (value) { this [_g] = clamp (value, 0, 1); },
-   enumerable: true,
-   configurable: false
 };
 
 const b = {
    get: function () { return this [_b]; },
    set: function (value) { this [_b] = clamp (value, 0, 1); },
-   enumerable: true,
-   configurable: false
 };
 
-Object .defineProperty (Color3 .prototype, "r", r);
-Object .defineProperty (Color3 .prototype, "g", g);
-Object .defineProperty (Color3 .prototype, "b", b);
-
-r .enumerable = false;
-g .enumerable = false;
-b .enumerable = false;
-
-Object .defineProperty (Color3 .prototype, "0", r);
-Object .defineProperty (Color3 .prototype, "1", g);
-Object .defineProperty (Color3 .prototype, "2", b);
+Object .defineProperties (Color3 .prototype,
+{
+   length: { value: 3 },
+   0: r,
+   1: g,
+   2: b,
+   r: Object .assign ({ enumerable: true }, r),
+   g: Object .assign ({ enumerable: true }, g),
+   b: Object .assign ({ enumerable: true }, b),
+});
 
 Object .assign (Color3,
 {

package/src/standard/Math/Numbers/Color4.js

@@ -67,7 +67,6 @@ function Color4 (r, g, b, a)
 Color4 .prototype =
 {
    constructor: Color4,
-   length: 4,
    [Symbol .iterator]: function* ()
    {
       yield this [_r];
@@ -135,45 +134,35 @@ Color4 .prototype =
 const r = {
    get: function () { return this [_r]; },
    set: function (value) { this [_r] = clamp (value, 0, 1); },
-   enumerable: true,
-   configurable: false
 };
 
 const g = {
    get: function () { return this [_g]; },
    set: function (value) { this [_g] = clamp (value, 0, 1); },
-   enumerable: true,
-   configurable: false
 };
 
 const b = {
    get: function () { return this [_b]; },
    set: function (value) { this [_b] = clamp (value, 0, 1); },
-   enumerable: true,
-   configurable: false
 };
 
 const a = {
    get: function () { return this [_a]; },
    set: function (value) { this [_a] = clamp (value, 0, 1); },
-   enumerable: true,
-   configurable: false
 };
 
-Object .defineProperty (Color4 .prototype, "r", r);
-Object .defineProperty (Color4 .prototype, "g", g);
-Object .defineProperty (Color4 .prototype, "b", b);
-Object .defineProperty (Color4 .prototype, "a", a);
-
-r .enumerable = false;
-g .enumerable = false;
-b .enumerable = false;
-a .enumerable = false;
-
-Object .defineProperty (Color4 .prototype, "0", r);
-Object .defineProperty (Color4 .prototype, "1", g);
-Object .defineProperty (Color4 .prototype, "2", b);
-Object .defineProperty (Color4 .prototype, "3", a);
+Object .defineProperties (Color4 .prototype,
+{
+   length: { value: 4 },
+   0: r,
+   1: g,
+   2: b,
+   3: a,
+   r: Object .assign ({ enumerable: true }, r),
+   g: Object .assign ({ enumerable: true }, g),
+   b: Object .assign ({ enumerable: true }, b),
+   a: Object .assign ({ enumerable: true }, a),
+});
 
 Object .assign (Color4,
 {

package/src/standard/Math/Numbers/Complex.js

@@ -54,7 +54,6 @@ function Complex (real, imag)
 Complex .prototype =
 {
    constructor: Complex,
-   length: 2,
    [Symbol .iterator]: function* ()
    {
       yield this .real;
@@ -156,75 +155,81 @@ Complex .prototype =
    },
    toString: function ()
    {
-      if (this .imag)
-         return this .real + " " + this .imag + "i";
+      let string = "";
 
-      return String (this .real);
-   },
-};
+      string += this .real;
 
-Object .defineProperty (Complex .prototype, "0",
-{
-   get: function ()
-   {
-      return this .real;
-   },
-   set: function (value)
-   {
-      this .real = value;
+      if (this .imag < 0)
+      {
+         string += this .imag;
+         string += "i";
+      }
+      else if (this .imag > 0)
+      {
+         string += "+";
+         string += this .imag;
+         string += "i";
+      }
+
+      return string;
    },
-   enumerable: false,
-   configurable: false
-});
+};
 
-Object .defineProperty (Complex .prototype, "1",
+Object .defineProperties (Complex .prototype,
 {
-   get: function ()
+   length: { value: 2 },
+   0:
    {
-      return this .imag;
+      get: function ()
+      {
+         return this .real;
+      },
+      set: function (value)
+      {
+         this .real = value;
+      },
    },
-   set: function (value)
+   1:
    {
-      this .imag = value;
+      get: function ()
+      {
+         return this .imag;
+      },
+      set: function (value)
+      {
+         this .imag = value;
+      },
    },
-   enumerable: false,
-   configurable: false
-});
-
-Object .defineProperty (Complex .prototype, "magnitude",
-{
-   get: function ()
+   magnitude:
    {
-      if (this .real)
+      get: function ()
       {
-         if (this .imag)
-            return Math .hypot (this .real, this .imag);
+         if (this .real)
+         {
+            if (this .imag)
+               return Math .hypot (this .real, this .imag);
 
-         return Math .abs (this .real);
-      }
+            return Math .abs (this .real);
+         }
 
-      return Math .abs (this .imag);
-   },
-   set: function (magnitude)
-   {
-      this .setPolar (magnitude, this .angle);
-   },
-   enumerable: false,
-   configurable: false
-});
-
-Object .defineProperty (Complex .prototype, "angle",
-{
-   get: function ()
-   {
-      return Math .atan2 (this .imag, this .real);
+         return Math .abs (this .imag);
+      },
+      set: function (magnitude)
+      {
+         this .setPolar (magnitude, this .angle);
+      },
    },
-   set: function (angle)
+   angle:
    {
-      this .setPolar (this .magnitude, angle);
+      get: function ()
+      {
+         return Math .atan2 (this .imag, this .real);
+      },
+      set: function (angle)
+      {
+         this .setPolar (this .magnitude, angle);
+      },
    },
-   enumerable: false,
-   configurable: false
 });
 
 Object .assign (Complex,

package/src/standard/Math/Numbers/Matrix2.js

@@ -45,8 +45,7 @@
  *
  ******************************************************************************/
 
-import Vector2   from "./Vector2.js";
-import Algorithm from "../Algorithm.js";
+import Vector2 from "./Vector2.js";
 
 function Matrix2 ()
 {
@@ -64,13 +63,9 @@ function Matrix2 ()
 Matrix2 .prototype =
 {
    constructor: Matrix2,
-   order: 2,
-   length: 4,
    [Symbol .iterator]: function* ()
    {
-      const length = this .length;
-
-      for (let i = 0; i < length; ++ i)
+      for (let i = 0; i < 4; ++ i)
          yield this [i];
    },
    copy: function ()
@@ -236,49 +231,40 @@ Matrix2 .prototype =
    },
 };
 
-Object .defineProperty (Matrix2 .prototype, "x",
+Object .defineProperties (Matrix2 .prototype,
 {
-   get: (function ()
+   order: { value: 2 },
+   length: { value: 4 },
+   x:
    {
-      const vector = new Vector2 (0, 0);
-
-      return function () { return vector .set (this [0], this [1]); };
-   })(),
-   enumerable: false,
-   configurable: false
-});
+      get: (function ()
+      {
+         const vector = new Vector2 (0, 0);
 
-Object .defineProperty (Matrix2 .prototype, "y",
-{
-   get: (function ()
+         return function () { return vector .set (this [0], this [1]); };
+      })(),
+   },
+   y:
    {
-      const vector = new Vector2 (0, 0);
-
-      return function () { return vector .set (this [2], this [3]); };
-   })(),
-   enumerable: false,
-   configurable: false
-});
-
-Object .defineProperty (Matrix2 .prototype, "xAxis",
-{
-   get: function () { return this [0]; },
-   enumerable: false,
-   configurable: false
-});
-
-Object .defineProperty (Matrix2 .prototype, "origin",
-{
-   get: function () { return this [2]; },
-   enumerable: false,
-   configurable: false
-});
+      get: (function ()
+      {
+         const vector = new Vector2 (0, 0);
 
-Object .defineProperty (Matrix2 .prototype, "submatrix",
-{
-   get: function () { return this [0]; },
-   enumerable: false,
-   configurable: false
+         return function () { return vector .set (this [2], this [3]); };
+      })(),
+   },
+   xAxis:
+   {
+      get: function () { return this [0]; },
+   },
+   origin:
+   {
+      get: function () { return this [2]; },
+   },
+   submatrix:
+   {
+      get: function () { return this [0]; },
+   },
 });
 
 Object .assign (Matrix2,