x_ite 8.6.23 → 8.7.0

package/docs/_posts/supported-nodes.md

@@ -7,7 +7,7 @@ tags: [Supported, Nodes, Components, Profiles]
 ---
 ## Overview
 
-X_ITE supports a certain number of X3D nodes. Objects in a X3D scene are also called nodes. These nodes are grouped into components and the components are grouped in profiles.
+X_ITE supports a certain number of X3D nodes. Objects in an X3D scene are also called nodes. These nodes are grouped into components and the components are grouped in profiles.
 
 The following lists outlines the profiles and nodes that are supported in X_ITE.
 

package/docs/_posts/tutorials/basic-nodes.md

@@ -253,7 +253,7 @@ DEF LookAtHouse Viewpoint {
 
 Beside the Viewpoint node there is also an [OrthoViewpoint](../components/navigation/orthoviewpoint) node to define an orthographic camera.
 
-If you define more than once viewpoint in a X3D file, the first viewpoint defined will be bound if the world is loaded. To bind one of the other viewpoints send a *set\_bind* event with the value TRUE to the viewpoint. You must use a [Script](../components/scripting/script) node for that or use a Anchor node with the name of the viewpoint in the *url* field preceded by '#'.
+If you define more than once viewpoint in an X3D file, the first viewpoint defined will be bound if the world is loaded. To bind one of the other viewpoints send a *set\_bind* event with the value TRUE to the viewpoint. You must use a [Script](../components/scripting/script) node for that or use a Anchor node with the name of the viewpoint in the *url* field preceded by '#'.
 
 ### XML Encoding
 

package/docs/_posts/tutorials/building-a-x3d-world.md

@@ -1,5 +1,5 @@
 ---
-title: Building a X3D World
+title: Building an X3D World
 date: 2022-11-28
 nav: tutorials-shapes-geometry-and-appearance
 categories: [Tutorials]

package/docs/_posts/tutorials/building-primitive-shapes.md

@@ -7,7 +7,7 @@ tags: [Building, Primitive, Shapes]
 ---
 ## Motivation
 
-Shapes are the building blocks of a X3D world. Primitive Shapes are standard building blocks:
+Shapes are the building blocks of an X3D world. Primitive Shapes are standard building blocks:
 
 - [Box](../components/geometry3d/box)
 - [Cone](../components/geometry3d/cone)

package/docs/_posts/tutorials/increasing-rendering-speed.md

@@ -32,7 +32,7 @@ Effective use of textures can be a relative inexpensive way to add interest and
 
 ### Use Lights Sparingly
 
-Lights are expensive in terms of performance. On most platforms, a X3D file should contain no more than two or three local lights per shape. Placing a directional light under a Transform node with the *global* field set to FALSE localizes the effect of the light.
+Lights are expensive in terms of performance. On most platforms, an X3D file should contain no more than two or three local lights per shape. Placing a directional light under a Transform node with the *global* field set to FALSE localizes the effect of the light.
 
 ### Use Fewer Nodes
 

package/docs/_posts/tutorials/introducing-x3d.md

@@ -21,7 +21,7 @@ X3D is:
 
 ## What do I need to use X3D?
 
-You can view X3D files using a X3D browser:
+You can view X3D files using an X3D browser:
 
 - A X3D standalone application
 - A X3D JavaScript plug-in like to an HTML browser

package/docs/_posts/tutorials/overview.md

@@ -23,7 +23,7 @@ Simple, fast and efficient, our X3D tutorials give you all the tips and tricks t
 Shapes, Geometry, and Appearance
 
 - [Introducing X3D](introducing-x3d)
-- [Building a X3D World](building-a-x3d-world)
+- [Building an X3D World](building-a-x3d-world)
 - [Building Primitive Shapes ](building-primitive-shapes)
 - [Transforming Shapes](transforming-shapes)
 - [Controlling Appearance with Materials ](controlling-appearance-with-materials)

package/docs/_posts/what's-new.md

@@ -5,6 +5,16 @@ nav: main
 categories: []
 tags: [New, Releases]
 ---
+## X_ITE v8.7.0 Released
+
+*Leipzig, 14th May 2023:* This release comes with a breaking change: `Browser.createX3DFromString` is now asynchronous and returns now a Promise. This ensures that all components are loaded, and all necessary nodes can be provided.
+
+In addition, there is now an [automated test suite](https://github.com/create3000/x_ite-tests){:target="_blank"}, which is being expanded on a daily basis.
+
+### Breaking Changes
+
+- `Browser.createX3DFromString` now returns a Promise.
+
 ## X_ITE v8.5.2 Released
 
 *Leipzig, 28th January 2023:* Now, X_ITE has support for SVG as well as STL support. When a scene is parsed you can, instead of a number use special constants like PI or PI3_4.
@@ -960,7 +970,7 @@ You can tune the *shadowIntensity*. It is the intensity of the shadow. 0 means n
 
 ## X_ITE v4.1.3 Released
 
-*Leipzig, 25th December 2017:* There is now the new BlendMode node in X_ITE available, which gives X3D authors the ability to specify the WebGL blend modes for a node. The node is a X3DAppearance child node and can be assigned the the new *blendMode* field of a Appearance node. Shader authors have now more control over particle systems, there are three new build in variables available in shaders: *x3d\_ParticleId, x3d\_ParticleLife, x3d\_ParticleElapsedTime, x3d\_ParticlePosition.* For more information have a look at <custom-shaders>.
+*Leipzig, 25th December 2017:* There is now the new BlendMode node in X_ITE available, which gives X3D authors the ability to specify the WebGL blend modes for a node. The node is an X3DAppearance child node and can be assigned the the new *blendMode* field of a Appearance node. Shader authors have now more control over particle systems, there are three new build in variables available in shaders: *x3d\_ParticleId, x3d\_ParticleLife, x3d\_ParticleElapsedTime, x3d\_ParticlePosition.* For more information have a look at <custom-shaders>.
 
 ## X_ITE v4.1.2 Released
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "x_ite",
-	"version": "8.6.23",
+	"version": "8.7.0",
 	"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>",
@@ -59,7 +59,7 @@
 		"css-element-queries": "^1.2.3",
 		"dicom-parser": "^1.8.21",
 		"jpeg-js": "^0.4.4",
-		"jpeg-lossless-decoder-js": "^2.0.4",
+		"jpeg-lossless-decoder-js": "^2.0.5",
 		"jquery": "^3.6.4",
 		"jquery-fullscreen-plugin": "^1.1.5",
 		"jquery-mousewheel": "^3.1.13",
@@ -71,8 +71,8 @@
 		"opentype.js": "^1.3.4",
 		"pako": "^2.1.0",
 		"string-replace-webpack-plugin": "^0.1.3",
-		"webpack": "^5.80.0",
-		"webpack-cli": "^5.0.2",
+		"webpack": "^5.82.1",
+		"webpack-cli": "^5.1.1",
 		"webpack-shell-plugin-next": "^2.3.1"
 	},
 	"scripts": {

package/src/x_ite/Base/X3DBaseNode.js

@@ -318,6 +318,8 @@ X3DBaseNode .prototype = Object .assign (Object .create (X3DEventObject .prototy
       {
          get: function () { return field; },
          set: function (value) { field .setValue (value); },
+			configurable: true,
+         enumerable: false,
       });
 
       if (!this .isPrivate ())
@@ -372,7 +374,6 @@ X3DBaseNode .prototype = Object .assign (Object .create (X3DEventObject .prototy
       {
          get: function () { return field; },
          set: function (value) { field .setValue (value); },
-         enumerable: true,
       });
 
       if (field .isInitializable ())

package/src/x_ite/Base/X3DField.js

@@ -123,15 +123,15 @@ X3DField .prototype = Object .assign (Object .create (X3DChildObject .prototype)
    },
    isInitializable: function ()
    {
-      return this [_accessType] & X3DConstants .initializeOnly;
+      return !! (this [_accessType] & X3DConstants .initializeOnly);
    },
    isInput: function ()
    {
-      return this [_accessType] & X3DConstants .inputOnly;
+      return !! (this [_accessType] & X3DConstants .inputOnly);
    },
    isOutput: function ()
    {
-      return this [_accessType] & X3DConstants .outputOnly;
+      return !! (this [_accessType] & X3DConstants .outputOnly);
    },
    isReadable: function ()
    {
@@ -139,7 +139,7 @@ X3DField .prototype = Object .assign (Object .create (X3DChildObject .prototype)
    },
    isWritable: function ()
    {
-      return this [_accessType] !== X3DConstants .initializeOnly;
+      return this [_accessType] !== X3DConstants .outputOnly;
    },
    setUnit: function (value)
    {

package/src/x_ite/Base/X3DFieldDefinition.js

@@ -49,10 +49,13 @@ import X3DObject from "./X3DObject.js";
 
 function X3DFieldDefinition (accessType, name, value)
 {
-   this .accessType  = accessType;
-   this .dataType    = value .getType ();
-   this .name        = name;
-   this .value       = value;
+   Object .defineProperties (this,
+   {
+      accessType: { value: accessType, enumerable: true },
+      dataType: { value: value .getType (), enumerable: true },
+      name: { value: name, enumerable: true },
+      value: { value: value },
+   });
 }
 
 X3DFieldDefinition .prototype = Object .assign (Object .create (X3DObject .prototype),

package/src/x_ite/Browser/Core/BrowserOptions.js

@@ -80,7 +80,7 @@ BrowserOptions .prototype = Object .assign (Object .create (X3DBaseNode .prototy
       new X3DFieldDefinition (X3DConstants .inputOutput, "Antialiased",            new Fields .SFBool (true)),
       new X3DFieldDefinition (X3DConstants .inputOutput, "TextureQuality",         new Fields .SFString ("MEDIUM")),
       new X3DFieldDefinition (X3DConstants .inputOutput, "PrimitiveQuality",       new Fields .SFString ("MEDIUM")),
-      new X3DFieldDefinition (X3DConstants .inputOutput, "QualityWhenMoving",      new Fields .SFString ("MEDIUM")),
+      new X3DFieldDefinition (X3DConstants .inputOutput, "QualityWhenMoving",      new Fields .SFString ("SAME")),
       new X3DFieldDefinition (X3DConstants .inputOutput, "Shading",                new Fields .SFString ("GOURAUD")),
       new X3DFieldDefinition (X3DConstants .inputOutput, "MotionBlur",             new Fields .SFBool ()),
       new X3DFieldDefinition (X3DConstants .inputOutput, "Cache",                  new Fields .SFBool (true)),
@@ -131,6 +131,12 @@ BrowserOptions .prototype = Object .assign (Object .create (X3DBaseNode .prototy
       this ._Multisampling          .addInterest ("set_multisampling__",          this);
       this ._Timings                .addInterest ("set_timings__",                this);
 
+      this .set_antialiased__            (this ._Antialiased);
+      this .set_shading__                (this ._Shading);
+      this .set_contentScale__           (this ._ContentScale);
+      this .set_logarithmicDepthBuffer__ (this ._LogarithmicDepthBuffer);
+      this .set_multisampling__          (this ._Multisampling);
+
       this .configure ();
    },
    configure: (function ()
@@ -168,9 +174,11 @@ BrowserOptions .prototype = Object .assign (Object .create (X3DBaseNode .prototy
                   attribute = $.toLowerCaseFirst (name),
                   value     = browser .getElement () .attr (attribute);
 
-               browser .attributeChangedCallback (attribute, null, value);
-
-               continue;
+               if (value !== undefined)
+               {
+                  browser .attributeChangedCallback (attribute, null, value);
+                  continue;
+               }
             }
 
             if (restorable .has (name))

package/src/x_ite/Browser/Core/X3DCoreContext.js

@@ -113,10 +113,10 @@ function X3DCoreContext (element)
    this [_localStorage] = new DataStorage (localStorage, "X_ITE.X3DBrowser(" + this [_instanceId] + ").");
    this [_mobile]       = /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i .test (navigator .userAgent);
 
-   this [_browserTimings]      = new BrowserTimings      (this .getPrivateScene ());
+   this [_renderingProperties] = new RenderingProperties (this .getPrivateScene ());
    this [_browserOptions]      = new BrowserOptions      (this .getPrivateScene ());
    this [_browserProperties]   = new BrowserProperties   (this .getPrivateScene ());
-   this [_renderingProperties] = new RenderingProperties (this .getPrivateScene ());
+   this [_browserTimings]      = new BrowserTimings      (this .getPrivateScene ());
    this [_notification]        = new Notification        (this .getPrivateScene ());
    this [_contextMenu]         = new ContextMenu         (this .getPrivateScene ());
 
@@ -136,45 +136,53 @@ X3DCoreContext .prototype =
    {
       // Setup browser nodes.
 
-      this [_browserTimings]      .setup ();
+      this [_renderingProperties] .setup ();
       this [_browserOptions]      .setup ();
       this [_browserProperties]   .setup ();
-      this [_renderingProperties] .setup ();
+      this [_browserTimings]      .setup ();
       this [_notification]        .setup ();
       this [_contextMenu]         .setup ();
 
-      // Define src and url property.
+      // Define properties of X3DCanvasElement.
 
-      Object .defineProperty (this .getElement () .get (0), "src",
+      Object .defineProperties (this .getElement () .get (0),
       {
-         get: () =>
-         {
-            return this .getExecutionContext () .getWorldURL ();
-         },
-         set: (value) =>
+         browser:
          {
-            this .loadURL (new Fields .MFString (value), new Fields .MFString ());
+            value: this,
+            enumerable: true,
          },
-         enumerable: true,
-      });
-
-      Object .defineProperty (this .getElement () .get (0), "url",
-      {
-         get: () =>
+         src:
          {
-            return new Fields .MFString (this .getExecutionContext () .getWorldURL ());
+            get: () =>
+            {
+               return this .getExecutionContext () .getWorldURL ();
+            },
+            set: (value) =>
+            {
+               this .loadURL (new Fields .MFString (value), new Fields .MFString ());
+            },
+            enumerable: true,
          },
-         set: (value) =>
+         url:
          {
-            this .loadURL (value, new Fields .MFString ());
+            get: () =>
+            {
+               return new Fields .MFString (this .getExecutionContext () .getWorldURL ());
+            },
+            set: (value) =>
+            {
+               this .loadURL (value, new Fields .MFString ());
+            },
+            enumerable: true,
          },
-         enumerable: true,
       });
 
       // Configure browser event handlers.
 
-      this .getElement () .on ("keydown.X3DCoreContext", this [_keydown] .bind (this));
-      this .getElement () .on ("keyup.X3DCoreContext",   this [_keyup]   .bind (this));
+      this .getElement ()
+         .on ("keydown.X3DCoreContext", this [_keydown] .bind (this))
+         .on ("keyup.X3DCoreContext",   this [_keyup]   .bind (this));
    },
    getInstanceId: function ()
    {
@@ -310,6 +318,21 @@ X3DCoreContext .prototype =
             this .setBrowserOption ("Notifications", this .parseBooleanAttribute (newValue, true));
             break;
          }
+         case "onerror":
+         case "oninitialized":
+         case "onshutdown":
+         {
+            try
+            {
+               this .getElement () [0] [name] = new Function ("event", newValue);
+            }
+            catch (error)
+            {
+               console .error (error);
+            }
+
+            break;
+         }
          case "splashScreen":
          case "splashscreen":
          {
@@ -325,7 +348,9 @@ X3DCoreContext .prototype =
          }
          case "src":
          {
-            this .loadURL (new Fields .MFString (newValue), new Fields .MFString ());
+            if (newValue)
+               this .loadURL (new Fields .MFString (newValue), new Fields .MFString ());
+
             break;
          }
          case "timings":
@@ -335,7 +360,9 @@ X3DCoreContext .prototype =
          }
          case "url":
          {
-            this .loadURL (this .parseUrlAttribute (newValue), new Fields .MFString ());
+            if (newValue)
+               this .loadURL (this .parseUrlAttribute (newValue), new Fields .MFString ());
+
             break;
          }
       }
@@ -358,13 +385,34 @@ X3DCoreContext .prototype =
 
       return url;
    },
-   callBrowserEventHandler: function (events)
+   callBrowserEventHandler: (function ()
    {
-      const element = this .getElement ();
+      const build_in = new Set (["error", "load"]);
 
-      for (const event of events .split (" "))
-         element .trigger (event);
-   },
+      return function (events)
+      {
+         const element = this .getElement () [0];
+
+         for (const name of events .split (" "))
+         {
+            // Order is attribute, then dispatch.
+
+            const event = new CustomEvent (name);
+
+            try
+            {
+               if (!build_in .has (name))
+                  element [`on${name}`] ?.(event);
+            }
+            catch (error)
+            {
+               console .error (error);
+            }
+
+            element .dispatchEvent (event);
+         }
+      };
+   })(),
    getShiftKey: function ()
    {
       return this ._shiftKey .getValue ();

package/src/x_ite/Browser/NURBS/NURBS.js

@@ -320,7 +320,7 @@ const NURBS = {
          controlPoints     = result || [ ],
          controlPointArray = controlPoint .getValue (),
          dimension         = controlPoint .length,
-         haveWeights       = Boolean (weights),
+         haveWeights       = !! weights,
          Vector            = haveWeights ? Vector3 : Vector2;
 
       if (controlPoints .haveWeights !== haveWeights)
@@ -353,7 +353,7 @@ const NURBS = {
       const
          controlPoints = result || [ ],
          dimension     = controlPointNode .getSize (),
-         haveWeights   = Boolean (weights),
+         haveWeights   = !! weights,
          Vector        = haveWeights ? Vector4 : Vector3;
 
       if (controlPoints .haveWeights !== haveWeights)
@@ -384,7 +384,7 @@ const NURBS = {
    {
       const
          controlPoints = result || [ ],
-         haveWeights   = Boolean (weights),
+         haveWeights   = !! weights,
          Vector        = haveWeights ? Vector4 : Vector3;
 
       if (controlPoints .haveWeights !== haveWeights)

package/src/x_ite/Browser/Shaders/X3DShadersContext.js

@@ -160,7 +160,7 @@ X3DShadersContext .prototype =
          version = gl .getVersion ();
 
       const vertexShader = new ShaderPart (this .getPrivateScene ());
-      vertexShader ._url .push (vs .startsWith ("data:") ? vs : "data:x-shader/x-vertex," + Shaders .vertex [version] [vs]);
+      vertexShader ._url .push (encodeURI (vs .startsWith ("data:") ? vs : "data:x-shader/x-vertex," + Shaders .vertex [version] [vs]));
       vertexShader .setPrivate (true);
       vertexShader .setName (name + "Vertex");
       vertexShader .setOptions (options);
@@ -168,7 +168,7 @@ X3DShadersContext .prototype =
 
       const fragmentShader = new ShaderPart (this .getPrivateScene ());
       fragmentShader ._type  = "FRAGMENT";
-      fragmentShader ._url .push (fs .startsWith ("data:") ? fs : "data:x-shader/x-fragment," + Shaders .fragment [version] [fs]);
+      fragmentShader ._url .push (encodeURI (fs .startsWith ("data:") ? fs : "data:x-shader/x-fragment," + Shaders .fragment [version] [fs]));
       fragmentShader .setPrivate (true);
       fragmentShader .setName (name + "Fragment");
       fragmentShader .setOptions (options);

package/src/x_ite/Browser/Texturing/X3DTexturingContext.js

@@ -52,9 +52,6 @@ import TextureQuality    from "../Core/TextureQuality.js";
 
 const
    _maxTextures              = Symbol (),
-   _maxTextureSize           = Symbol (),
-   _maxCombinedTextureUnits  = Symbol (),
-   _textureMemory            = Symbol (),
    _combinedTextureUnits     = Symbol (),
    _texture2DUnits           = Symbol (),
    _texture3DUnits           = Symbol (),
@@ -89,13 +86,11 @@ X3DTexturingContext .prototype =
 
       gl .pixelStorei (gl .UNPACK_ALIGNMENT, 1);
 
-      this [_maxTextureSize]          = gl .getParameter (gl .MAX_TEXTURE_SIZE);
-      this [_maxCombinedTextureUnits] = gl .getParameter (gl .MAX_COMBINED_TEXTURE_IMAGE_UNITS);
-      this [_textureMemory]           = NaN;
-
       // Get texture Units
 
-      this [_combinedTextureUnits] = [...Array (this [_maxCombinedTextureUnits]) .keys ()];
+      const maxCombinedTextureUnits = gl .getParameter (gl .MAX_COMBINED_TEXTURE_IMAGE_UNITS);
+
+      this [_combinedTextureUnits] = [...Array (maxCombinedTextureUnits) .keys ()];
       this [_texture2DUnits]       = [this [_combinedTextureUnits] .pop ()];
       this [_texture3DUnits]       = [this [_combinedTextureUnits] .pop ()];
       this [_textureCubeUnits]     = [this [_combinedTextureUnits] .pop ()];
@@ -160,11 +155,15 @@ X3DTexturingContext .prototype =
    },
    getMaxTextureSize: function ()
    {
-      return this [_maxTextureSize];
+      const gl = this .getContext ();
+
+      return gl .getParameter (gl .MAX_TEXTURE_SIZE);
    },
    getMaxCombinedTextureUnits: function ()
    {
-      return this [_maxCombinedTextureUnits];
+      const gl = this .getContext ();
+
+      return gl .getParameter (gl .MAX_COMBINED_TEXTURE_IMAGE_UNITS)
    },
    popTexture2DUnit: function ()
    {
@@ -253,7 +252,7 @@ X3DTexturingContext .prototype =
    },
    getTextureMemory: function ()
    {
-      return this [_textureMemory];
+      return NaN;
    },
    getDefaultTextureProperties: function ()
    {

package/src/x_ite/Browser/Time/X3DTimeContext.js

@@ -55,7 +55,7 @@ const
 
 function X3DTimeContext ()
 {
-   this [_currentTime]      = 0;
+   this [_currentTime]      = Date .now () / 1000;
    this [_currentFrameRate] = 60;
    this [_currentPosition]  = new Vector3 (0, 0, 0);
    this [_currentSpeed]     = 0;
@@ -63,10 +63,6 @@ function X3DTimeContext ()
 
 X3DTimeContext .prototype =
 {
-   initialize: function ()
-   {
-      this .advanceTime ();
-   },
    getCurrentTime: function ()
    {
       return this [_currentTime];

package/src/x_ite/Browser/VERSION.js

@@ -45,4 +45,4 @@
  *
  ******************************************************************************/
 
-export default "8.6.23";
+export default "8.7.0";