x_ite 8.10.1 → 8.11.1

package/docs/_config.yml

@@ -20,8 +20,8 @@ timezone:
 # ↓ --------------------------
 
 title: X_ITE X3D Browser               # the main title
-version: 8.10.1                         # x_ite latest version
-size: 289                              # size in kb
+version: 8.11.1                         # x_ite latest version
+size: 291                              # size in kb
 x3d_latest_version: 4.0                # x3d latest version
 
 tagline: Step Into The Future          # it will display as the sub-title

package/docs/_posts/components/Core/MetadataBoolean.md

@@ -15,7 +15,7 @@ tags: [MetadataBoolean, Core]
 
 MetadataBoolean contains a typed list of values providing metadata information about its parent node. Further information about this specific Metadata* node may be provided by a single child Metadata* node with `containerField='metadata'.`
 
-The MetadataBoolean node belongs to the **Core** component and its default container field is *metadata.* It is available from X3D version 3.3 or higher.
+The MetadataBoolean node belongs to the **Core** component and its default container field is *value.* It is available from X3D version 3.3 or higher.
 
 ## Hierarchy
 
@@ -65,15 +65,17 @@ The *value* attribute is a strictly typed data array providing relevant metadata
 
 ### Hints
 
-- Use `containerField='value'` if the parent node is MetadataSet.
-- [Each of the Metadata nodes are allowed as top-level root nodes in a scene, be sure to explicitly define `containerField='metadata'.`](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-DIS/Part01/concepts.html#Rootnodes){:target="_blank"}
+- Typically use `containerField='value'` if the parent node is MetadataSet.
+- Explicitly defining containerField for Metadata nodes is always allowed and also unambiguous across each version of X3D.
+- [Each of the Metadata nodes are allowed as top-level root nodes in a scene, if doing that be sure to explicitly define `containerField='metadata'.`](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-DIS/Part01/concepts.html#Rootnodes){:target="_blank"}
 - If present, an IS statement is the first child within any other node.
 - An IS statement precedes any sibling Metadata* node, which in turn precedes any other sibling nodes.
 - Comments are not readable when a model file is loaded for viewing, but WorldInfo and Metadata* nodes are persistent and inspectable at run time.
 - [X3D for Web Authors, Chapter 15, Metadata Information](https://www.web3d.org/x3d/content/examples/X3dForWebAuthors/Chapter15-Metadata/Chapter15-MetadataInformation.html){:target="_blank"}
 
-### Warning
+### Warnings
 
+- Default `containerField='metadata'` in X3D 3 changed to default `containerField='value'` in X3D 4.0, allowing construction of much terser MetadataSet vocabulary structures.
 - Metadata nodes can only contain other Metadata nodes.
 
 ## See Also

package/docs/_posts/components/Core/MetadataDouble.md

@@ -15,7 +15,7 @@ tags: [MetadataDouble, Core]
 
 MetadataDouble contains a typed list of values providing metadata information about its parent node. Further information about this specific Metadata* node may be provided by a single child Metadata* node with `containerField='metadata'.`
 
-The MetadataDouble node belongs to the **Core** component and its default container field is *metadata.* It is available from X3D version 3.0 or higher.
+The MetadataDouble node belongs to the **Core** component and its default container field is *value.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -65,16 +65,18 @@ The *value* attribute is a strictly typed data array providing relevant metadata
 
 ### Hints
 
-- Use `containerField='value'` if the parent node is MetadataSet.
-- [Each of the Metadata nodes are allowed as top-level root nodes in a scene, be sure to explicitly define `containerField='metadata'.`](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-DIS/Part01/concepts.html#Rootnodes){:target="_blank"}
+- Typically use `containerField='value'` if the parent node is MetadataSet.
+- Explicitly defining containerField for Metadata nodes is always allowed and also unambiguous across each version of X3D.
+- [Each of the Metadata nodes are allowed as top-level root nodes in a scene, if doing that be sure to explicitly define `containerField='metadata'.`](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-DIS/Part01/concepts.html#Rootnodes){:target="_blank"}
 - If present, an IS statement is the first child within any other node.
 - An IS statement precedes any sibling Metadata* node, which in turn precedes any other sibling nodes.
 - The choice of MetadataDouble versus MetadataFloat usually depends on the relevant tool utilizing the value, or else the relevant metadata reference defining the value.
 - Comments are not readable when a model file is loaded for viewing, but WorldInfo and Metadata* nodes are persistent and inspectable at run time.
 - [X3D for Web Authors, Chapter 15, Metadata Information](https://www.web3d.org/x3d/content/examples/X3dForWebAuthors/Chapter15-Metadata/Chapter15-MetadataInformation.html){:target="_blank"}
 
-### Warning
+### Warnings
 
+- Default `containerField='metadata'` in X3D 3 changed to default `containerField='value'` in X3D 4.0, allowing construction of much terser MetadataSet vocabulary structures.
 - Metadata nodes can only contain other Metadata nodes.
 
 ## See Also

package/docs/_posts/components/Core/MetadataFloat.md

@@ -15,7 +15,7 @@ tags: [MetadataFloat, Core]
 
 MetadataFloat contains a typed list of values providing metadata information about its parent node. Further information about this specific Metadata* node may be provided by a single child Metadata* node with `containerField='metadata'.`
 
-The MetadataFloat node belongs to the **Core** component and its default container field is *metadata.* It is available from X3D version 3.0 or higher.
+The MetadataFloat node belongs to the **Core** component and its default container field is *value.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -65,16 +65,18 @@ The *value* attribute is a strictly typed data array providing relevant metadata
 
 ### Hints
 
-- Use `containerField='value'` if the parent node is MetadataSet.
-- [Each of the Metadata nodes are allowed as top-level root nodes in a scene, be sure to explicitly define `containerField='metadata'.`](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-DIS/Part01/concepts.html#Rootnodes){:target="_blank"}
+- Typically use `containerField='value'` if the parent node is MetadataSet.
+- Explicitly defining containerField for Metadata nodes is always allowed and also unambiguous across each version of X3D.
+- [Each of the Metadata nodes are allowed as top-level root nodes in a scene, if doing that be sure to explicitly define `containerField='metadata'.`](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-DIS/Part01/concepts.html#Rootnodes){:target="_blank"}
 - If present, an IS statement is the first child within any other node.
 - An IS statement precedes any sibling Metadata* node, which in turn precedes any other sibling nodes.
 - The choice of MetadataDouble versus MetadataFloat usually depends on the relevant tool utilizing the value, or else the relevant metadata reference defining the value.
 - Comments are not readable when a model file is loaded for viewing, but WorldInfo and Metadata* nodes are persistent and inspectable at run time.
 - [X3D for Web Authors, Chapter 15, Metadata Information](https://www.web3d.org/x3d/content/examples/X3dForWebAuthors/Chapter15-Metadata/Chapter15-MetadataInformation.html){:target="_blank"}
 
-### Warning
+### Warnings
 
+- Default `containerField='metadata'` in X3D 3 changed to default `containerField='value'` in X3D 4.0, allowing construction of much terser MetadataSet vocabulary structures.
 - Metadata nodes can only contain other Metadata nodes.
 
 ## See Also

package/docs/_posts/components/Core/MetadataInteger.md

@@ -15,7 +15,7 @@ tags: [MetadataInteger, Core]
 
 MetadataInteger contains a typed list of values providing metadata information about its parent node. Further information about this specific Metadata* node may be provided by a single child Metadata* node with `containerField='metadata'.`
 
-The MetadataInteger node belongs to the **Core** component and its default container field is *metadata.* It is available from X3D version 3.0 or higher.
+The MetadataInteger node belongs to the **Core** component and its default container field is *value.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -65,15 +65,17 @@ The *value* attribute is a strictly typed data array providing relevant metadata
 
 ### Hints
 
-- Use `containerField='value'` if the parent node is MetadataSet.
-- [Each of the Metadata nodes are allowed as top-level root nodes in a scene, be sure to explicitly define `containerField='metadata'.`](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-DIS/Part01/concepts.html#Rootnodes){:target="_blank"}
+- Typically use `containerField='value'` if the parent node is MetadataSet.
+- Explicitly defining containerField for Metadata nodes is always allowed and also unambiguous across each version of X3D.
+- [Each of the Metadata nodes are allowed as top-level root nodes in a scene, if doing that be sure to explicitly define `containerField='metadata'.`](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-DIS/Part01/concepts.html#Rootnodes){:target="_blank"}
 - If present, an IS statement is the first child within any other node.
 - An IS statement precedes any sibling Metadata* node, which in turn precedes any other sibling nodes.
 - Comments are not readable when a model file is loaded for viewing, but WorldInfo and Metadata* nodes are persistent and inspectable at run time.
 - [X3D for Web Authors, Chapter 15, Metadata Information](https://www.web3d.org/x3d/content/examples/X3dForWebAuthors/Chapter15-Metadata/Chapter15-MetadataInformation.html){:target="_blank"}
 
-### Warning
+### Warnings
 
+- Default `containerField='metadata'` in X3D 3 changed to default `containerField='value'` in X3D 4.0, allowing construction of much terser MetadataSet vocabulary structures.
 - Metadata nodes can only contain other Metadata nodes.
 
 ## See Also

package/docs/_posts/components/Core/MetadataSet.md

@@ -15,7 +15,7 @@ tags: [MetadataSet, Core]
 
 MetadataSet contains a list of Metadata* nodes that each have `containerField='value'` and together provide information about the parent node of the MetadataSet. Further information about this specific MetadataSet node may be provided by a single child Metadata* node with `containerField='metadata'.`
 
-The MetadataSet node belongs to the **Core** component and its default container field is *metadata.* It is available from X3D version 3.0 or higher.
+The MetadataSet node belongs to the **Core** component and its default container field is *value.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -61,16 +61,18 @@ The *value* field provides a list of X3DMetadataObject nodes whose meaning is de
 
 ### Hints
 
-- Use `containerField='value'` if the parent node is MetadataSet.
-- [Each of the Metadata nodes are allowed as top-level root nodes in a scene, be sure to explicitly define `containerField='metadata'.`](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-DIS/Part01/concepts.html#Rootnodes){:target="_blank"}
+- Typically use `containerField='value'` if the parent node is MetadataSet.
+- Explicitly defining containerField for Metadata nodes is always allowed and also unambiguous across each version of X3D.
+- [Each of the Metadata nodes are allowed as top-level root nodes in a scene, if doing that be sure to explicitly define `containerField='metadata'.`](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-DIS/Part01/concepts.html#Rootnodes){:target="_blank"}
 - If present, an IS statement is the first child within any other node.
 - An IS statement precedes any sibling Metadata* node, which in turn precedes any other sibling nodes.
 - MetadataSet can contain other MetadataSet nodes.
 - Comments are not readable when a model file is loaded for viewing, but WorldInfo and Metadata* nodes are persistent and inspectable at run time.
 - [X3D for Web Authors, Chapter 15, Metadata Information](https://www.web3d.org/x3d/content/examples/X3dForWebAuthors/Chapter15-Metadata/Chapter15-MetadataInformation.html){:target="_blank"}
 
-### Warning
+### Warnings
 
+- Default `containerField='metadata'` in X3D 3 changed to default `containerField='value'` in X3D 4.0, allowing construction of much terser MetadataSet vocabulary structures.
 - Metadata nodes can only contain other Metadata nodes.
 
 ## See Also

package/docs/_posts/components/Core/MetadataString.md

@@ -15,7 +15,7 @@ tags: [MetadataString, Core]
 
 MetadataString contains a typed list of values providing metadata information about its parent node. Further information about this specific Metadata* node may be provided by a single child Metadata* node with `containerField='metadata'.`
 
-The MetadataString node belongs to the **Core** component and its default container field is *metadata.* It is available from X3D version 3.0 or higher.
+The MetadataString node belongs to the **Core** component and its default container field is *value.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -65,15 +65,17 @@ The *value* attribute is a strictly typed data array providing relevant metadata
 
 ### Hints
 
-- Use `containerField='value'` if the parent node is MetadataSet.
-- [Each of the Metadata nodes are allowed as top-level root nodes in a scene, be sure to explicitly define `containerField='metadata'.`](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-DIS/Part01/concepts.html#Rootnodes){:target="_blank"}
+- Typically use `containerField='value'` if the parent node is MetadataSet.
+- Explicitly defining containerField for Metadata nodes is always allowed and also unambiguous across each version of X3D.
+- [Each of the Metadata nodes are allowed as top-level root nodes in a scene, if doing that be sure to explicitly define `containerField='metadata'.`](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-DIS/Part01/concepts.html#Rootnodes){:target="_blank"}
 - If present, an IS statement is the first child within any other node.
 - An IS statement precedes any sibling Metadata* node, which in turn precedes any other sibling nodes.
 - Comments are not readable when a model file is loaded for viewing, but WorldInfo and Metadata* nodes are persistent and inspectable at run time.
 - [X3D for Web Authors, Chapter 15, Metadata Information](https://www.web3d.org/x3d/content/examples/X3dForWebAuthors/Chapter15-Metadata/Chapter15-MetadataInformation.html){:target="_blank"}
 
-### Warning
+### Warnings
 
+- Default `containerField='metadata'` in X3D 3 changed to default `containerField='value'` in X3D 4.0, allowing construction of much terser MetadataSet vocabulary structures.
 - Metadata nodes can only contain other Metadata nodes.
 
 ## See Also

package/docs/_posts/components/DIS/DISEntityTypeMapping.md

@@ -15,7 +15,7 @@ tags: [DISEntityTypeMapping, DIS]
 
 DISEntityTypeMapping provides a best-match mapping from DIS ESPDU entity type information to a specific X3D model, thus providing a visual and behavioral representation that best matches the entity type. Fields are processed in order: kind, domain, country, category, subcategory, specific, extra.
 
-The DISEntityTypeMapping node belongs to the **DIS** component and its default container field is *mapping.* It is available from X3D version 3.0 or higher.
+The DISEntityTypeMapping node belongs to the **DIS** component and its default container field is *children.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 

package/docs/_posts/components/HAnim/HAnimMotion.md

@@ -15,7 +15,7 @@ tags: [HAnimMotion, HAnim]
 
 An HAnimMotion node supports discrete frame-by-frame playback for HAnim motion data animation. Design characteristics include integration with HAnim figure data and HAnimJoint nodes, animation control, and playback of raw motion data.
 
-The HAnimMotion node belongs to the **HAnim** component and its default container field is *children.* It is available from X3D version 4.0 or higher.
+The HAnimMotion node belongs to the **HAnim** component and its default container field is *motions.* It is available from X3D version 4.0 or higher.
 
 ## Hierarchy
 
@@ -47,57 +47,67 @@ Author-provided prose that describes intended purpose of this node.
 
 Enables/disables node operation.
 
-### SFBool [in] **next**
+### SFInt32 [in, out] **loa** -1 <small>[-1,4]</small>
 
-Send *next* output value in keyValue array, and reset internal fraction field to match corresponding value in key array.
+Level Of Articulation 0..4 indicates complexity and detail of joints for given humanoid skeletal hierarchy.
 
-#### Hint
+#### Hints
 
-- This input event will "wrap around" boundary of frame array, i.e. continue from endFrame next to startFrame if necessary.
+- *loa* value of -1 indicates that no LOA conformance is provided.
+- [Humanoid Animation (HAnim) Specification, Part 1 Architecture, 4.8.4 Levels of articulation](https://www.web3d.org/documents/specifications/19774/V2.0/Architecture/concepts.html#LevelsOfArticulation){:target="_blank"}
 
-#### Warning
+### SFString [in, out] **joints** ""
 
-- It is an error to define this transient inputOnly field in an X3D file, instead only use it a destination for ROUTE events.
+*joints* field lists names of *joints* that raw motion data is to be applied to. The number and order of the names in the *joints* field shall match the number and order of the channels field information, and the number and order of the sets of values in the values field for each frame of the animation.
 
-### SFBool [in] **previous**
+#### Hints
 
-Send *previous* output value in keyValue array, and reset internal fraction field to match corresponding value in key array.
+- Values are space or comma separated.
+- The joint name IGNORED shall be used for channel of motion data that is not used for any joint.
 
-#### Hint
+### MFBool [in, out] **channelsEnabled** [ ]
 
-- This input event will "wrap around" boundary of frame array, i.e. continue from startFrame next to endFrame if necessary.
+Boolean values for each channel indicating whether enabled.
 
-#### Warning
+### SFString [in, out] **channels** ""
 
-- It is an error to define this transient inputOnly field in an X3D file, instead only use it a destination for ROUTE events.
+List of number of *channels* for transformation, followed by transformation type of each channel of data. Each value is space or comma separated.
 
-### SFInt32 [in, out] **startFrame** 0 <small>[0,∞)</small>
+#### Hint
 
-*startFrame* indicates initial index of animated frame. Note that *startFrame* can precede, equal or follow endFrame.
+- *channels* are enabled by default, unless otherwise indicated by channelsEnabled field.
 
-#### Hint
+### MFFloat [in, out] **values** [ ] <small>(-∞,∞)</small>
 
-- *startFrame* starts at 0 and is no greater than (frameCount - 1).
+*values* field contains all transformation *values*, ordered first by frame, then by joint, and then by transformation Sets of floats in the *values* array matching the order listed in joints and channels fields.
 
-### SFInt32 [in, out] **endFrame** 0 <small>[0,∞)</small>
+### SFBool [in, out] **loop** FALSE
 
-*endFrame* indicates final index of animated frame. Note that *endFrame* can precede, equal or follow *endFrame*. The default *endFrame* value is reset to (frameCount - 1) whenever frameCount is changed.
+Repeat indefinitely when *loop*=true, repeat only once when *loop*=false.
+
+### SFBool [in] **next**
+
+Send *next* output value in keyValue array, and reset internal fraction field to match corresponding value in key array.
 
 #### Hint
 
-- *endFrame* starts at 0 and is no greater than (frameCount - 1).
+- This input event will "wrap around" boundary of frame array, i.e. continue from endFrame next to startFrame if necessary.
 
-### SFTime [in, out] **frameDuration** 0.1 <small>(0,∞)</small>
+#### Warning
 
-*frameDuration* specifies the duration of each frame in seconds.
+- It is an error to define this transient inputOnly field in an X3D file, instead only use it a destination for ROUTE events.
 
-### SFInt32 [in, out] **frameIncrement** 1 <small>(-∞,∞)</small>
+### SFBool [in] **previous**
 
-*frameIncrement* field controls whether playback direction is forwards or backwards, and also whether frames are skipped (for example, subsampled replay). For a single animation step, the next frameIndex value equals (frameIndex + *frameIncrement*) modulo frameCount.
+Send *previous* output value in keyValue array, and reset internal fraction field to match corresponding value in key array.
 
 #### Hint
 
-- Note that setting *frameIncrement* to 0 prevents automatic advancement of frameIndex and pauses animation of HAnimMotion node.
+- This input event will "wrap around" boundary of frame array, i.e. continue from startFrame next to endFrame if necessary.
+
+#### Warning
+
+- It is an error to define this transient inputOnly field in an X3D file, instead only use it a destination for ROUTE events.
 
 ### SFInt32 [in, out] **frameIndex** 0 <small>[0,∞)</small>
 
@@ -107,43 +117,33 @@ Send *previous* output value in keyValue array, and reset internal fraction fiel
 
 - *frameIndex* starts at 0 and is no greater than (frameCount - 1). Values less than 0 are reset as 0. Values greater or equal to frameCount are stored as (frameCount - 1). Thus the value of *frameIndex* shall be greater than or equal to zero, and less than frameCount.
 
-### SFBool [in, out] **loop** FALSE
-
-Repeat indefinitely when *loop*=true, repeat only once when *loop*=false.
-
-### MFBool [in, out] **channelsEnabled** [ ]
+### SFTime [in, out] **frameDuration** 0.1 <small>(0,∞)</small>
 
-Boolean values for each channel indicating whether enabled.
+*frameDuration* specifies the duration of each frame in seconds.
 
-### SFString [in, out] **channels** ""
+### SFInt32 [in, out] **frameIncrement** 1 <small>(-∞,∞)</small>
 
-List of number of *channels* for transformation, followed by transformation type of each channel of data. Each value is space or comma separated.
+*frameIncrement* field controls whether playback direction is forwards or backwards, and also whether frames are skipped (for example, subsampled replay). For a single animation step, the next frameIndex value equals (frameIndex + *frameIncrement*) modulo frameCount.
 
 #### Hint
 
-- *channels* are enabled by default, unless otherwise indicated by channelsEnabled field.
-
-### SFString [in, out] **joints** ""
-
-*joints* field lists names of *joints* that raw motion data is to be applied to. The number and order of the names in the *joints* field shall match the number and order of the channels field information, and the number and order of the sets of values in the values field for each frame of the animation.
+- Note that setting *frameIncrement* to 0 prevents automatic advancement of frameIndex and pauses animation of HAnimMotion node.
 
-#### Hints
+### SFInt32 [in, out] **startFrame** 0 <small>[0,∞)</small>
 
-- Values are space or comma separated.
-- The joint name IGNORED shall be used for channel of motion data that is not used for any joint.
+*startFrame* indicates initial index of animated frame. Note that *startFrame* can precede, equal or follow endFrame.
 
-### SFInt32 [in, out] **loa** -1 <small>[-1,4]</small>
+#### Hint
 
-Level Of Articulation 0..4 indicates complexity and detail of joints for given humanoid skeletal hierarchy.
+- *startFrame* starts at 0 and is no greater than (frameCount - 1).
 
-#### Hints
+### SFInt32 [in, out] **endFrame** 0 <small>[0,∞)</small>
 
-- *loa* value of -1 indicates that no LOA conformance is provided.
-- [Humanoid Animation (HAnim) Specification, Part 1 Architecture, 4.8.4 Levels of articulation](https://www.web3d.org/documents/specifications/19774/V2.0/Architecture/concepts.html#LevelsOfArticulation){:target="_blank"}
+*endFrame* indicates final index of animated frame. Note that *endFrame* can precede, equal or follow *endFrame*. The default *endFrame* value is reset to (frameCount - 1) whenever frameCount is changed.
 
-### MFFloat [in, out] **values** [ ] <small>(-∞,∞)</small>
+#### Hint
 
-*values* field contains all transformation *values*, ordered first by frame, then by joint, and then by transformation Sets of floats in the *values* array matching the order listed in joints and channels fields.
+- *endFrame* starts at 0 and is no greater than (frameCount - 1).
 
 ### SFTime [out] **cycleTime**
 

package/docs/_posts/components/RigidBodyPhysics/Contact.md

@@ -15,7 +15,7 @@ tags: [Contact, RigidBodyPhysics]
 
 Contact nodes are produced as output events when two collidable objects or spaces make contact.
 
-The Contact node belongs to the **RigidBodyPhysics** component and its default container field is *children.* It is available from X3D version 3.2 or higher.
+The Contact node belongs to the **RigidBodyPhysics** component and its default container field is *contacts.* It is available from X3D version 3.2 or higher.
 
 ## Hierarchy