x_ite 8.8.7 → 8.9.1

package/docs/_posts/components/VolumeRendering/VolumeData.md

@@ -1,6 +1,6 @@
 ---
 title: VolumeData
-date: 2022-01-07
+date: 2023-01-07
 nav: components-VolumeRendering
 categories: [components, VolumeRendering]
 tags: [VolumeData, VolumeRendering]
@@ -15,7 +15,7 @@ tags: [VolumeData, VolumeRendering]
 
 VolumeData displays a simple non-segmented voxel dataset with a single RenderStyle node.
 
-The VolumeData node belongs to the **VolumeRendering** component and its default container field is *children.* It is available since X3D version 3.3 or later.
+The VolumeData node belongs to the **VolumeRendering** component and its default container field is *children.* It is available from X3D version 3.3 or higher.
 
 ## Hierarchy
 
@@ -30,20 +30,24 @@ The VolumeData node belongs to the **VolumeRendering** component and its default
 
 ### SFNode [in, out] **metadata** NULL <small>[X3DMetadataObject]</small>
 
-Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.
+Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.
+
+#### Hint
+
+- [X3D Architecture 7.2.4 Metadata](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/core.html#Metadata){:target="_blank"}
 
 ### SFVec3f [in, out] **dimensions** 1 1 1 <small>(0,∞)</small>
 
-Actual-size X-Y-Z dimensions of volume data in local coordinate system.
+Actual-size X-Y-Z *dimensions* of volume data in local coordinate system.
 
 ### SFBool [in, out] **visible** TRUE
 
 Whether or not renderable content within this node is visually displayed.
 
-#### Hint
+#### Hints
 
-- The visible field has no effect on animation behaviors, event passing or other non-visual characteristics.
-- Content must be visible to be collidable and to be pickable.
+- The *visible* field has no effect on animation behaviors, event passing or other non-visual characteristics.
+- Content must be *visible* to be collidable and to be pickable.
 
 ### SFBool [in, out] **bboxDisplay** FALSE
 
@@ -57,32 +61,45 @@ Whether to display bounding box for associated geometry, aligned with world coor
 
 Bounding box size is usually omitted, and can easily be calculated automatically by an X3D player at scene-loading time with minimal computational cost. Bounding box size can also be defined as an optional authoring hint that suggests an optimization or constraint.
 
-#### Hint
+#### Hints
 
 - Can be useful for collision computations or inverse-kinematics (IK) engines.
+- Precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
+- [X3D Architecture, 10.2.2 Bounding boxes](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/grouping.html#BoundingBoxes){:target="_blank"}
+- [X3D Architecture, 10.3.1 X3DBoundedObject](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/grouping.html#X3DBoundedObject){:target="_blank"}
 
 ### SFVec3f [ ] **bboxCenter** 0 0 0 <small>(-∞,∞)</small>
 
-Bounding box center: optional hint for position offset from origin of local coordinate system.
+Bounding box center accompanies bboxSize and provides an optional hint for bounding box position offset from origin of local coordinate system.
+
+#### Hints
+
+- Precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
+- [X3D Architecture, 10.2.2 Bounding boxes](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/grouping.html#BoundingBoxes){:target="_blank"}
+- [X3D Architecture, 10.3.1 X3DBoundedObject](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/grouping.html#X3DBoundedObject){:target="_blank"}
 
 ### SFNode [in, out] **renderStyle** NULL <small>[X3DVolumeRenderStyleNode]</small>
 
-Input/Output field renderStyle.
+Single contained X3DVolumeRenderStyleNode node that defines specific rendering technique for this volumetric object. If field is not defined, default is OpacityMapVolumeStyle node.
 
 ### SFNode [in, out] **voxels** NULL <small>[X3DTexture3DNode]</small>
 
-Input/Output field voxels.
+Single contained X3DTexture3DNode (ComposedTexture3D, ImageTexture3D, PixelTexture3D) that provides raw voxel information utilized by corresponding rendering styles. Any number of color components (1-4) may be defined.
 
-## Description
+## Advisories
 
 ### Hint
 
-- VolumeData can contain a single Texture3D node with containerField='voxels' and a single RenderStyle node.
+- VolumeData can contain a single Texture3D node with `containerField='voxels'` and a single RenderStyle node.
+
+### Warning
+
+- Requires X3D `profile='Full'` or else include `<component name='VolumeRendering' level='1'/>`
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/VolumeRendering/VolumeData/VolumeData.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of VolumeData](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/volume.html#VolumeData){:target="_blank"}
+- [X3D Specification of VolumeData node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/volume.html#VolumeData){:target="_blank"}

package/docs/_posts/components/X_ITE/BlendMode.md

@@ -1,6 +1,6 @@
 ---
 title: BlendMode
-date: 2022-01-07
+date: 2023-01-07
 nav: components-X_ITE
 categories: [components, X_ITE]
 tags: [BlendMode, X_ITE]
@@ -17,6 +17,9 @@ BlendMode controls how pixels of an objects are drawn. Pixels can be drawn using
 
 The BlendMode node belongs to the **X_ITE** component and its default container field is *blendMode.* It is available in Titania and X_ITE.
 
+>**Info:** Please note that the functionality of this node is still experimental.
+{: .prompt-info }
+
 ## Hierarchy
 
 ```
@@ -30,7 +33,11 @@ The BlendMode node belongs to the **X_ITE** component and its default container
 
 ### SFNode [in, out] **metadata** NULL <small>[X3DMetadataObject]</small>
 
-Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.
+Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.
+
+#### Hint
+
+- [X3D Architecture 7.2.4 Metadata](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/core.html#Metadata){:target="_blank"}
 
 ### SFColorRGBA [in, out] **blendColor** 0 0 0 0 <small>[0,1]</small>
 

package/docs/_posts/getting-started.md

@@ -589,17 +589,13 @@ If you are in production and everything is working well, then use a fixed versio
 $ npm install x_ite
 ```
 
-It can be used in [Electron](https://www.electronjs.org){:target="_blank"} apps in a preload script of the **renderer process** in a way like this:
+It can be used in [Electron](https://www.electronjs.org){:target="_blank"} apps in the **renderer process** in a way like this:
 
 ```js
-window .addEventListener ("DOMContentLoaded", () =>
-{
-  const X3D = require ("x_ite")
-  ...
-})
+const X3D = require ("x_ite")
 ```
 
-Make sure that contextIsolation is set to **false** when creating a BrowserWindow instance.
+Make sure that `contextIsolation` is set to `false` when creating a BrowserWindow instance.
 
 ## Embedding X_ITE within a Web Page
 
@@ -644,6 +640,7 @@ X_ITE can load several file formats, either directly as the source of the \<x3d-
 | glTF             | .gltf, .glb    | model/gltf+json |
 | Wavefront OBJ    | .obj           | model/obj       |
 | STL              | .stl           | model/stl       |
+| PLY              | .ply           | model/ply       |
 | SVG Document     | .svg, .svgz    | image/svg+xml   |
 
 >**Tip:** All files can be compressed using GZip compression. This saves bandwidth and speeds up download time.

package/docs/_posts/laboratory/x3d-file-converter.md

@@ -157,7 +157,7 @@ $(() =>
 
 ## Upload and Convert
 
-Convert **X3D, VRML, glTF (GLB), OBJ, STL,** and **SVG** to an X3D format of your choice.
+Convert **X3D, VRML, glTF (GLB), OBJ, STL, PLY,** and **SVG** to an X3D format of your choice.
 
 <div id="drop-zone">
    <p id="open-files" class="center">

package/docs/laboratory/gltf-sample-viewer.html

@@ -42,6 +42,7 @@ tags: [glTF, Sample, Viewer]
 }
 
 .viewer-column1 {
+   position: relative;
    flex: 80%;
    width: 80%;
    height: 100%;
@@ -66,6 +67,21 @@ tags: [glTF, Sample, Viewer]
    height: 100%;
    aspect-ratio: unset;
 }
+
+#animations {
+   display: none;
+   position: absolute;
+   right: 0;
+   bottom: 5px;
+   min-width: 200px;
+   padding: 10px 20px;
+   background-color: var(--body-bg);
+   border-bottom: 5px solid var(--text-color);
+}
+
+#animations label {
+   margin: 0;
+}
 </style>
 
 <div class="viewer-row">
@@ -84,6 +100,7 @@ tags: [glTF, Sample, Viewer]
             </Scene>
          </X3D>
       </x3d-canvas>
+      <div id="animations"></div>
    </div>
    <div class="viewer-column2"></div>
 </div>
@@ -357,6 +374,8 @@ async function loadURL (filename, server, event)
 {
    event .preventDefault ();
 
+   $("#animations") .hide ();
+
    const Browser = X3D .getBrowser ();
 
    await Browser .loadURL (new X3D .MFString (server + filename));
@@ -365,13 +384,42 @@ async function loadURL (filename, server, event)
    {
       const animations = Browser .currentScene .getExportedNode ("Animations");
 
-      for (const group of animations .children)
+      $("#animations") .empty ();
+      $("<b></b>") .text ("Animations") .appendTo ($("#animations"));
+      $("<br>") .appendTo ($("#animations"));
+
+      for (const [i, group] of animations .children .entries ())
       {
-         group .children [0] .loop      = true;
-         group .children [0] .startTime = Date .now () / 1000;
+         const timeSensor = group .children [0];
+
+         timeSensor .loop     = true;
+         timeSensor .stopTime = Date .now () / 1000;
+
+         $("<input></input>")
+            .attr ("id", "animation" + i)
+            .attr ("type", "checkbox")
+            .on ("change", event =>
+            {
+               if ($(event .target) .is (":checked"))
+                  timeSensor .startTime = Date .now () / 1000;
+               else
+                  timeSensor .stopTime = Date .now () / 1000;
+            })
+            .appendTo ($("#animations"));
+
+         $(document .createTextNode (" ")) .appendTo ($("#animations"));
+
+         $("<label></label>")
+            .attr ("for", "animation" + i)
+            .text (group .children [0] .description)
+            .appendTo ($("#animations"));
+
+         $("<br>") .appendTo ($("#animations"));
       }
+
+      $("#animations") .show ();
    }
-   catch (error)
+   catch
    { }
 
    if (!Browser .getActiveViewpoint () ._description .getValue ())

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "x_ite",
-	"version": "8.8.7",
+	"version": "8.9.1",
 	"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>",
@@ -23,6 +23,7 @@
 		"JavaScript",
 		"JSON",
 		"Node",
+		"PLY",
 		"STL",
 		"SVG",
 		"VRML",

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

@@ -209,9 +209,19 @@ Object .assign (Box2,
    {
       return new Box2 () .setExtents (min, max);
    },
-   Points (... points)
+   Points (points)
    {
-      return new Box2 () .setExtents (points [0] .copy () .min (... points), points [0] .copy () .max (... points));
+      const
+         min = new Vector2 (Number .POSITIVE_INFINITY, Number .POSITIVE_INFINITY),
+         max = new Vector2 (Number .NEGATIVE_INFINITY, Number .NEGATIVE_INFINITY);
+
+      for (const point of points)
+      {
+         min .min (point);
+         max .max (point);
+      }
+
+      return new Box2 () .setExtents (min, max);
    },
 });
 

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

@@ -617,9 +617,19 @@ Object .assign (Box3,
    {
       return new Box3 () .setExtents (min, max);
    },
-   Points (... points)
+   Points (points)
    {
-      return new Box3 () .setExtents (points [0] .copy () .min (... points), points [0] .copy () .max (... points));
+      const
+         min = new Vector3 (Number .POSITIVE_INFINITY, Number .POSITIVE_INFINITY, Number .POSITIVE_INFINITY),
+         max = new Vector3 (Number .NEGATIVE_INFINITY, Number .NEGATIVE_INFINITY, Number .NEGATIVE_INFINITY);
+
+      for (const point of points)
+      {
+         min .min (point);
+         max .max (point);
+      }
+
+      return new Box3 () .setExtents (min, max);
    },
 });
 

package/src/x_ite/Base/X3DObjectArrayField.js

@@ -124,7 +124,7 @@ const handler =
    },
 };
 
-function X3DObjectArrayField (value)
+function X3DObjectArrayField (values)
 {
    const proxy = new Proxy (this, handler);
 
@@ -133,7 +133,8 @@ function X3DObjectArrayField (value)
    this [_target] = this;
    this [_proxy]  = proxy;
 
-   this .push (... value);
+   for (const value of values)
+   	this .push (value);
 
    return proxy;
 }

package/src/x_ite/Base/X3DTypedArrayField.js

@@ -164,7 +164,7 @@ const handler =
    },
 };
 
-function X3DTypedArrayField (args)
+function X3DTypedArrayField (values)
 {
    const proxy = new Proxy (this, handler);
 
@@ -179,7 +179,8 @@ function X3DTypedArrayField (args)
       this [_tmp]   = [ ]; // Array with components size.
    }
 
-   this .push (... args);
+   for (const value of values)
+   	this .push (value);
 
    return proxy;
 }

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

@@ -420,11 +420,18 @@ Object .assign (X3DCoreContext .prototype,
    },
    parseUrlAttribute (urlCharacters)
    {
-      const url = new Fields .MFString ();
+      try
+      {
+         const url = new Fields .MFString ();
 
-      url .fromString ("[" + urlCharacters + "]", this .getExecutionContext ());
+         url .fromString ("[" + urlCharacters + "]", this .getExecutionContext ());
 
-      return url;
+         return url;
+      }
+      catch
+      {
+         throw new Error ("Couldn't parse url attribute.");
+      }
    },
    callBrowserEventHandler: (() =>
    {

package/src/x_ite/Browser/DOMIntegration.js

@@ -135,15 +135,17 @@ class DOMIntegration
 
 	processAttribute (mutation, element)
 	{
-		const parser = this .parser;
+		const
+			parser = this .parser,
+			node   = $.data (element, "node");
 
-		if ($.data (element, "node"))
+		if (node)
 		{
 			const
 				attributeName = mutation .attributeName,
 				attribute     = element .attributes .getNamedItem (attributeName);
 
-			parser .nodeAttribute (attribute, $.data (element, "node"));
+			parser .nodeAttribute (attribute, node);
 		}
 		else
 		{
@@ -153,11 +155,14 @@ class DOMIntegration
 				parentNode = element .parentNode,
 			 	node       = $.data (parentNode, "node");
 
-			parser .pushExecutionContext (node .getExecutionContext ());
-			parser .pushParent (node);
-			parser .childElement (element);
-			parser .popParent ();
-			parser .popExecutionContext ();
+			if (node)
+			{
+				parser .pushExecutionContext (node .getExecutionContext ());
+				parser .pushParent (node);
+				parser .childElement (element);
+				parser .popParent ();
+				parser .popExecutionContext ();
+			}
 		}
 	}
 

package/src/x_ite/Browser/VERSION.js

@@ -45,4 +45,4 @@
  *
  ******************************************************************************/
 
-export default "8.8.7";
+export default "8.9.1";

package/src/x_ite/Components/CubeMapTexturing/ComposedCubeMapTexture.js

@@ -59,7 +59,7 @@ function ComposedCubeMapTexture (executionContext)
 
    this .addType (X3DConstants .ComposedCubeMapTexture);
 
-   if (executionContext .getSpecificationVersion () < 4)
+   if (executionContext .getSpecificationVersion () < 4.0)
    {
       this .addAlias ("front",  this ._frontTexture);
       this .addAlias ("back",   this ._backTexture);

package/src/x_ite/Components/DIS/DISEntityManager.js

@@ -57,7 +57,7 @@ function DISEntityManager (executionContext)
 
    this .addType (X3DConstants .DISEntityManager);
 
-   if (executionContext .getSpecificationVersion () < 4)
+   if (executionContext .getSpecificationVersion () <= 3.3)
       this .addAlias ("mapping", this ._children);
 }
 

package/src/x_ite/Components/Grouping/Switch.js

@@ -59,7 +59,7 @@ function Switch (executionContext)
 
    this .addType (X3DConstants .Switch);
 
-   if (executionContext .getSpecificationVersion () === "2.0")
+   if (executionContext .getSpecificationVersion () == 2.0)
       this .addAlias ("choice", this ._children);
 
    this .childNode     = null;