x_ite 8.8.6 → 8.9.0

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

@@ -1,6 +1,6 @@
 ---
 title: RigidBodyCollection
-date: 2022-01-07
+date: 2023-01-07
 nav: components-RigidBodyPhysics
 categories: [components, RigidBodyPhysics]
 tags: [RigidBodyCollection, RigidBodyPhysics]
@@ -15,7 +15,7 @@ tags: [RigidBodyCollection, RigidBodyPhysics]
 
 RigidBodyCollection represents a system of bodies that interact within a single physics model.
 
-The RigidBodyCollection node belongs to the **RigidBodyPhysics** component and its default container field is *children.* It is available since X3D version 3.2 or later.
+The RigidBodyCollection node belongs to the **RigidBodyPhysics** component and its default container field is *children.* It is available from X3D version 3.2 or higher.
 
 ## Hierarchy
 
@@ -29,43 +29,52 @@ The RigidBodyCollection node belongs to the **RigidBodyPhysics** component and i
 
 ### 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"}
 
 ### SFBool [in, out] **enabled** TRUE
 
 Enables/disables node operation.
 
-### MFNode [in] **set_contacts** <span class="red"><small>not supported</small></span>
+### MFNode [in] **set_contacts** <small class="red">not supported</small>
+
+*set_contacts* input field for Contact nodes provides per-frame information about *contacts* between bodies.
+
+#### Warning
 
-*set_contacts* input field for Contact nodes provides per-frame information about contacts between bodies.
+- It is an error to define this transient inputOnly field in an X3D file, instead only use it a destination for ROUTE events.
 
-### SFVec3f [in, out] **gravity** 0 -9.8 0
+### SFVec3f [in, out] **gravity** 0 -9.8 0 <small>(-∞,∞)</small>
 
-*gravity* indicates direction and strength of local gravity vector for this collection of bodies (units m/sec^2).
+*gravity* indicates direction and strength of local *gravity* vector for this collection of bodies (units m/sec^2).
 
 ### SFBool [in, out] **preferAccuracy** FALSE
 
 *preferAccuracy* provides hint for performance preference: higher accuracy or faster computational speed.
 
-### SFFloat [in, out] **errorCorrection** 0.8 <small>[0,1] <span class="red">not supported</span></small>
+### SFFloat [in, out] **errorCorrection** 0.8 <small>[0,1]</small> <small class="red">not supported</small>
 
 *errorCorrection* describes how quickly intersection errors due to floating-point inaccuracies are resolved (0=no correction, 1=all corrected in single step).
 
 ### SFInt32 [in, out] **iterations** 10 <small>[0,∞)</small>
 
-*iterations* controls number of iterations performed over collectioned joints and bodies during each evaluation.
+*iterations* controls number of *iterations* performed over collectioned joints and bodies during each evaluation.
 
-### SFFloat [in, out] **constantForceMix** 0.0001 <small>[0,∞) <span class="red">not supported</span></small>
+### SFFloat [in, out] **constantForceMix** 0.0001 <small>[0,∞)</small> <small class="red">not supported</small>
 
 *constantForceMix* modifies damping calculations by violating normal constraints while applying small, constant forces in those calculations.
 
 #### Hints
 
-- This allows joints and bodies to be a fraction springy, and helps to eliminate numerical instability. Spring-driven or spongy connections can be emulated by combined use of errorCorrection and constantForceMix.
+- This allows joints and bodies to be a fraction springy, and helps to eliminate numerical instability.
+- Spring-driven or spongy connections can be emulated by combined use of errorCorrection and *constantForceMix*.
 
-### SFFloat [in, out] **maxCorrectionSpeed** -1 <small>[0,∞) or -1 <span class="red">not supported</span></small>
+### SFFloat [in, out] **maxCorrectionSpeed** -1 <small>[0,∞) or -1</small> <small class="red">not supported</small>
 
-Or -1, maxCorrectionSpeed .
+Or -1, *maxCorrectionSpeed* .
 
 ### SFFloat [in, out] **contactSurfaceThickness** 0 <small>[0,∞)</small>
 
@@ -75,13 +84,14 @@ Or -1, maxCorrectionSpeed .
 
 *autoDisable* toggles operation of disableAngularSpeed, disableLinearSpeed, disableTime.
 
-### SFFloat [in, out] **disableTime** 0 <small>[0,∞) <span class="red">not supported</span></small>
+### SFFloat [in, out] **disableTime** 0 <small>[0,∞)</small> <small class="red">not supported</small>
 
 *disableTime* defines interval when body becomes at rest and not part of rigid body calculations, reducing numeric instabilities.
 
-#### Hint
+#### Hints
 
 - Only activated if autoDisable='true'
+- *disableTime* is an SFTime duration interval, not an absolute clock time.
 
 ### SFFloat [in, out] **disableLinearSpeed** 0 <small>[0,∞)</small>
 
@@ -101,20 +111,26 @@ Or -1, maxCorrectionSpeed .
 
 ### SFNode [ ] **collider** NULL <small>[CollisionCollection]</small>
 
-Field collider.
+The *collider* field associates a collision collection with this rigid body collection allowing seamless updates and integration without the need to use the X3D event model.
 
 ### MFNode [in, out] **bodies** [ ] <small>[RigidBody]</small>
 
-Input/Output field bodies.
+Collection of top-level nodes that comprise a set of *bodies* evaluated as a single set of interactions.
 
 ### MFNode [in, out] **joints** [ ] <small>[X3DRigidJointNode]</small>
 
-Input/Output field joints.
+The *joints* field is used to register all *joints* between bodies contained in this collection.
+
+#### Warnings
+
+- If a joint is connected between bodies in two different collections, the result is implementation-dependent.
+- If a joint instance is registered with more than one collection, the results are implementation dependent.
+- Joints not registered with any collection are not evaluated.
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/RigidBodyPhysics/RigidBodyCollection/RigidBodyCollection.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of RigidBodyCollection](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/rigidBodyPhysics.html#RigidBodyCollection){:target="_blank"}
+- [X3D Specification of RigidBodyCollection node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/rigidBodyPhysics.html#RigidBodyCollection){:target="_blank"}

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

@@ -1,6 +1,6 @@
 ---
 title: SingleAxisHingeJoint
-date: 2022-01-07
+date: 2023-01-07
 nav: components-RigidBodyPhysics
 categories: [components, RigidBodyPhysics]
 tags: [SingleAxisHingeJoint, RigidBodyPhysics]
@@ -15,7 +15,7 @@ tags: [SingleAxisHingeJoint, RigidBodyPhysics]
 
 SingleAxisHingeJoint has single axis about which to rotate, similar to a traditional door hinge. Contains two RigidBody nodes (containerField values body1, body2).
 
-The SingleAxisHingeJoint node belongs to the **RigidBodyPhysics** component and its default container field is *joints.* It is available since X3D version 3.2 or later.
+The SingleAxisHingeJoint node belongs to the **RigidBodyPhysics** component and its default container field is *joints.* It is available from X3D version 3.2 or higher.
 
 ## Hierarchy
 
@@ -29,41 +29,51 @@ The SingleAxisHingeJoint node belongs to the **RigidBodyPhysics** component and
 
 ### 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.
 
-### MFString [in, out] **forceOutput** "NONE" <small>["ALL","NONE",...]</small>
+#### Hint
+
+- [X3D Architecture 7.2.4 Metadata](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/core.html#Metadata){:target="_blank"}
+
+### MFString [in, out] **forceOutput** "NONE" <small>["ALL", "NONE", ...]</small>
 
 *forceOutput* controls which output fields are generated for the next frame. Values are ALL, NONE, or exact names of output fields updated at start of next frame.
 
-### SFVec3f [in, out] **anchorPoint** 0 0 0
+### SFVec3f [in, out] **anchorPoint** 0 0 0 <small>(-∞,∞)</small>
 
 *anchorPoint* is joint center, specified in world coordinates.
 
-### SFVec3f [in, out] **axis** 0 0 0
+### SFVec3f [in, out] **axis** 0 0 0 <small>(-∞,∞)</small>
 
 *axis* defines vector of joint connection between body1 and body2.
 
-### SFFloat [in, out] **minAngle** [-π,π)<small> <span class="red">not supported</span></small>
+### SFFloat [in, out] **minAngle** -π <small>[-π,π)</small> <small class="red">not supported</small>
 
 *minAngle* is minimum rotation angle for hinge.
 
-### SFFloat [in, out] **maxAngle** [-π,π) <small><span class="red">not supported</span></small>
+#### Hint
+
+- [Radian units for angular measure](https://en.wikipedia.org/wiki/Radian){:target="_blank"}
+
+### SFFloat [in, out] **maxAngle** π <small>[-π,π)</small> <small class="red">not supported</small>
 
 *maxAngle* is maximum rotation angle for hinge.
 
-### SFFloat [in, out] **stopBounce** 0 <small>[0,1] <span class="red">not supported</span>
-</small>
+#### Hint
+
+- [Radian units for angular measure](https://en.wikipedia.org/wiki/Radian){:target="_blank"}
+
+### SFFloat [in, out] **stopBounce** 0 <small>[0,1]</small> <small class="red">not supported</small>
 
-StopBounce is velocity factor for bounce back once stop point is reached.
+*stopBounce* is velocity factor for bounce back once stop point is reached.
 
 #### Hint
 
 - 0 means no bounce, 1 means return velocity matches.
 
-### SFFloat [in, out] **stopErrorCorrection** 0.8 <small>[0,1] <span class="red">not supported</span>
-</small>
+### SFFloat [in, out] **stopErrorCorrection** 0.8 <small>[0,1]</small> <small class="red">not supported</small>
 
-StopErrorCorrection is fraction of error correction performed during time step once stop point is reached.
+*stopErrorCorrection* is fraction of error correction performed during time step once stop point is reached.
 
 #### Hint
 
@@ -71,29 +81,29 @@ StopErrorCorrection is fraction of error correction performed during time step o
 
 ### SFVec3f [out] **body1AnchorPoint**
 
-Output field body1AnchorPoint.
+Output field *body1AnchorPoint*.
 
 ### SFVec3f [out] **body2AnchorPoint**
 
-Output field body2AnchorPoint.
+Output field *body2AnchorPoint*.
 
 ### SFFloat [out] **angle**
 
-Output field angle.
+Output field *angle*.
 
 ### SFFloat [out] **angleRate**
 
-Output field angleRate.
+Output field *angleRate*.
 
 ### SFNode [in, out] **body1** NULL <small>[RigidBody]</small>
 
-Input/Output field body1.
+The *body1* and body2 fields indicate the two RigidBody nodes connected by this joint.
 
 ### SFNode [in, out] **body2** NULL <small>[RigidBody]</small>
 
-Input/Output field body2.
+The body1 and *body2* fields indicate the two RigidBody nodes connected by this joint.
 
-## Description
+## Advisories
 
 ### Hint
 
@@ -103,6 +113,6 @@ Input/Output field body2.
 
 <x3d-canvas src="https://create3000.github.io/media/examples/RigidBodyPhysics/SingleAxisHingeJoint/SingleAxisHingeJoint.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of SingleAxisHingeJoint](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/rigidBodyPhysics.html#SingleAxisHingeJoint){:target="_blank"}
+- [X3D Specification of SingleAxisHingeJoint node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/rigidBodyPhysics.html#SingleAxisHingeJoint){:target="_blank"}

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

@@ -1,6 +1,6 @@
 ---
 title: SliderJoint
-date: 2022-01-07
+date: 2023-01-07
 nav: components-RigidBodyPhysics
 categories: [components, RigidBodyPhysics]
 tags: [SliderJoint, RigidBodyPhysics]
@@ -15,7 +15,7 @@ tags: [SliderJoint, RigidBodyPhysics]
 
 SliderJoint constrains all movement between body1 and body2 along a single axis. Contains two RigidBody nodes (containerField values body1, body2).
 
-The SliderJoint node belongs to the **RigidBodyPhysics** component and its default container field is *joints.* It is available since X3D version 3.2 or later.
+The SliderJoint node belongs to the **RigidBodyPhysics** component and its default container field is *joints.* It is available from X3D version 3.2 or higher.
 
 ## Hierarchy
 
@@ -29,13 +29,17 @@ The SliderJoint node belongs to the **RigidBodyPhysics** component and its defau
 
 ### 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.
 
-### MFString [in, out] **forceOutput** "NONE" <small>["ALL","NONE",...]</small>
+#### Hint
+
+- [X3D Architecture 7.2.4 Metadata](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/core.html#Metadata){:target="_blank"}
+
+### MFString [in, out] **forceOutput** "NONE" <small>["ALL", "NONE", ...]</small>
 
 *forceOutput* controls which output fields are generated for the next frame. Values are ALL, NONE, or exact names of output fields updated at start of next frame.
 
-### SFVec3f [in, out] **axis** 0 1 0
+### SFVec3f [in, out] **axis** 0 1 0 <small>(-∞,∞)</small>
 
 *axis* is normalized vector specifying direction of motion.
 
@@ -45,7 +49,7 @@ Metadata are not part of the X3D world and not interpreted by the X3D browser, b
 
 #### Hint
 
-- If (minSeparation is less than maxSeparation) then no stop is effective.
+- If (*minSeparation* is less than maxSeparation) then no stop is effective.
 
 ### SFFloat [in, out] **maxSeparation** 1 <small>[0,∞)</small>
 
@@ -53,13 +57,13 @@ Metadata are not part of the X3D world and not interpreted by the X3D browser, b
 
 #### Hint
 
-- If (minSeparation is less than maxSeparation) then no stop is effective.
+- If (minSeparation is less than *maxSeparation*) then no stop is effective.
 
-### SFFLoat [in, out] **sliderForce** 0 <span class="red"><small>not supported</small></span>
+### SFFloat [in, out] **sliderForce** 0 <small>[-∞,∞)</small> <small class="red">not supported</small>
 
-Input/Output field sliderForce.
+*sliderForce* value is used to apply a force (specified in force base units) along the axis of the slider in equal and opposite directions to the two bodies. A positive value applies a force such that the two bodies accelerate away from each other, while a negative value applies a force such that the two bodies accelerate toward each other.
 
-### SFFloat [in, out] **stopBounce** 0 <small>[0,1] <span class="red">not supported</span></small>
+### SFFloat [in, out] **stopBounce** 0 <small>[0,1]</small> <small class="red">not supported</small>
 
 *stopBounce* is velocity factor for bounce back once stop point is reached.
 
@@ -67,7 +71,7 @@ Input/Output field sliderForce.
 
 - 0 means no bounce, 1 means return velocity matches.
 
-### SFFloat [in, out] **stopErrorCorrection** 1 <small>[0,1] <span class="red">not supported</span></small>
+### SFFloat [in, out] **stopErrorCorrection** 1 <small>[0,1]</small> <small class="red">not supported</small>
 
 *stopErrorCorrection* is fraction of error correction performed during time step once stop point is reached.
 
@@ -75,23 +79,31 @@ Input/Output field sliderForce.
 
 - 0 means no error correction, 1 means all error corrected in single step.
 
-### SFFloat [out] **separation** <span class="red"><small>not supported</small></span>
+### SFFloat [out] **separation** <small class="red">not supported</small>
+
+*separation* indicates final *separation* distance between the two bodies.
 
-*separation* indicates final separation distance between the two bodies.
+#### Warning
 
-### SFFloat [out] **separationRate** <span class="red"><small>not supported</small></span>
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
+
+### SFFloat [out] **separationRate** <small class="red">not supported</small>
 
 *separationRate* indicates change in separation distance over time between the two bodies.
 
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
+
 ### SFNode [in, out] **body1** NULL <small>[RigidBody]</small>
 
-Input/Output field body1.
+The *body1* and body2 fields indicate the two RigidBody nodes connected by this joint.
 
 ### SFNode [in, out] **body2** NULL <small>[RigidBody]</small>
 
-Input/Output field body2.
+The body1 and *body2* fields indicate the two RigidBody nodes connected by this joint.
 
-## Description
+## Advisories
 
 ### Hint
 
@@ -101,6 +113,6 @@ Input/Output field body2.
 
 <x3d-canvas src="https://create3000.github.io/media/examples/RigidBodyPhysics/SliderJoint/SliderJoint.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of SliderJoint](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/rigidBodyPhysics.html#SliderJoint){:target="_blank"}
+- [X3D Specification of SliderJoint node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/rigidBodyPhysics.html#SliderJoint){:target="_blank"}

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

@@ -1,6 +1,6 @@
 ---
 title: UniversalJoint
-date: 2022-01-07
+date: 2023-01-07
 nav: components-RigidBodyPhysics
 categories: [components, RigidBodyPhysics]
 tags: [UniversalJoint, RigidBodyPhysics]
@@ -15,7 +15,7 @@ tags: [UniversalJoint, RigidBodyPhysics]
 
 UniversalJoint is like a BallJoint that constrains an extra degree of rotational freedom. Contains two RigidBody nodes (containerField values body1, body2).
 
-The UniversalJoint node belongs to the **RigidBodyPhysics** component and its default container field is *joints.* It is available since X3D version 3.2 or later.
+The UniversalJoint node belongs to the **RigidBodyPhysics** component and its default container field is *joints.* It is available from X3D version 3.2 or higher.
 
 ## Hierarchy
 
@@ -29,35 +29,43 @@ The UniversalJoint node belongs to the **RigidBodyPhysics** component and its de
 
 ### 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.
 
-### MFString [in, out] **forceOutput** "NONE" <small>["ALL","NONE",...]</small>
+#### Hint
+
+- [X3D Architecture 7.2.4 Metadata](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/core.html#Metadata){:target="_blank"}
+
+### MFString [in, out] **forceOutput** "NONE" <small>["ALL", "NONE", ...]</small>
 
 *forceOutput* controls which output fields are generated for the next frame. Values are ALL, NONE, or exact names of output fields updated at start of next frame.
 
-### SFVec3f [in, out] **anchorPoint** 0 0 0
+### SFVec3f [in, out] **anchorPoint** 0 0 0 <small>(-∞,∞)</small>
 
 *anchorPoint* is joint center, specified in world coordinates.
 
-### SFVec3f [in, out] **axis1** 0 0 0
+### SFVec3f [in, out] **axis1** 0 0 0 <small>(-∞,∞)</small>
 
 *axis1* defines axis vector of joint connection to body1.
 
 #### Hint
 
-- 0 0 0 means motor disabled.
+- 0 0 0 means motor disabled about this axis.
 
-### SFVec3f [in, out] **axis2** 0 0 0
+### SFVec3f [in, out] **axis2** 0 0 0 <small>(-∞,∞)</small>
 
 *axis2* defines axis vector of joint connection to body2.
 
 #### Hint
 
-- 0 0 0 means motor disabled.
+- 0 0 0 means motor disabled about this axis.
 
 ### SFFloat [in, out] **stop1Bounce** 0 <small>[0,1]</small>
 
-Input/Output field stop1Bounce.
+*stop1Bounce* is velocity factor for bounce back once stop point is reached.
+
+#### Hint
+
+- 0 means no bounce, 1 means return velocity matches.
 
 ### SFFloat [in, out] **stop2Bounce** 0 <small>[0,1]</small>
 
@@ -83,37 +91,37 @@ Input/Output field stop1Bounce.
 
 - 0 means no error correction, 1 means all error corrected in single step.
 
-### SFVec3f [out] **body1AnchorPoint**
+### SFVec3f [out] **body1Axis**
 
-Output field body1AnchorPoint.
+Output field *body1Axis*.
 
-### SFVec3f [out] **body2AnchorPoint**
+### SFVec3f [out] **body2Axis**
 
-Output field body2AnchorPoint.
+Output field *body2Axis*.
 
-### SFVec3f [out] **body1Axis**
+### SFVec3f [out] **body1AnchorPoint**
 
-Output field body1Axis.
+Output field *body1AnchorPoint*.
 
-### SFVec3f [out] **body2Axis**
+### SFVec3f [out] **body2AnchorPoint**
 
-Output field body2Axis.
+Output field *body2AnchorPoint*.
 
 ### SFNode [in, out] **body1** NULL <small>[RigidBody]</small>
 
-Input/Output field body1.
+The *body1* and body2 fields indicate the two RigidBody nodes connected by this joint.
 
 ### SFNode [in, out] **body2** NULL <small>[RigidBody]</small>
 
-Input/Output field body2.
+The body1 and *body2* fields indicate the two RigidBody nodes connected by this joint.
 
-## Description
+## Advisories
 
 ### Hints
 
 - Useful in combination with BallJoint.
 - RigidBodyPhysics component, level 2.
 
-## External Links
+## See Also
 
-- [X3D Specification of UniversalJoint](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/rigidBodyPhysics.html#UniversalJoint){:target="_blank"}
+- [X3D Specification of UniversalJoint node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/rigidBodyPhysics.html#UniversalJoint){:target="_blank"}

package/docs/_posts/components/Scripting/Script.md

@@ -1,6 +1,6 @@
 ---
 title: Script
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Scripting
 categories: [components, Scripting]
 tags: [Script, Scripting]
@@ -13,9 +13,9 @@ tags: [Script, Scripting]
 
 ## Overview
 
-Script provides programmed behavior for a scene. Define the script interface with `<field>` elements. Scripting code is embedded in a child CDATA node or (deprecated) in the url field. Optionally supported programming languages: ECMAScript (JavaScript) and (via url to a myNode.class file) Java.
+Script contains author-programmed event behaviors for a scene. Define the script input-output event interface by including \<field/\> elements. Scripting code is embedded in a child CDATA node or (deprecated) in the url field. Optionally supported programming languages are ECMAScript (JavaScript) and Java (via url to a myNode.class file).
 
-The Script node belongs to the **Scripting** component and its default container field is *children.* It is available since X3D version 2.0 or later.
+The Script node belongs to the **Scripting** component and its default container field is *children.* It is available from X3D version 2.0 or higher.
 
 ## Hierarchy
 
@@ -32,7 +32,11 @@ The Script node belongs to the **Scripting** 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"}
 
 ### SFString [in, out] **description** ""
 
@@ -40,34 +44,38 @@ Author-provided prose that describes intended purpose of the url asset.
 
 #### Hint
 
-- Many XML tools substitute XML character references for special characters automatically if needed within an attribute value (such as &amp;#38; for & ampersand character, or &amp;#34; for " quotation-mark character).
+- Many XML tools substitute XML character references for special characters automatically if needed within an attribute value (such as &amp;#38; for &amp; ampersand character, or &amp;#34; for " quotation-mark character).
 
 ### SFBool [in, out] **load** TRUE
 
-*load*=true means load immediately, load=false means defer loading or else unload a previously loaded asset.
+*load*=true means *load* immediately, *load*=false means defer loading or else unload a previously loaded scene.
 
 #### Hints
 
-- Allows author to design when ImageTextureAtlas loading occurs via user interaction, event chains or scripting.
+- Allows author to design when Inline loading occurs via user interaction, event chains or scripting.
 - Use a separate LoadSensor node to detect when loading is complete.
 
 ### MFString [in, out] **url** [ ] <small>[URI]</small>
 
-Points to a script file url. Also (as deprecated alternative to CDATA block) can contain ecmascript: source as a quoted SFString within the url array.
+List of address links for runnable script files.
 
-#### Hint
+#### Hints
 
-- If Script contains both external url reference and internal CDATA source then external url takes precedence, but will fall back to contained CDATA source if no external script is found.
+- Embedded ecmascript: source can also be contained in the sourceCode pseudo-field without escape characters, equivalent to last entry in the *url* list, when using other API codebases and file encodings.
+- Browsers are not required to support any particular scripting language, but ECMAScript (JavaScript) is widely supported.
+- Equivalent script code written in multiple programming languages can be provided for portability, the first runnable version is chosen at run time.
+- [X3D Scene Authoring Hints, Scripts](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Scripts){:target="_blank"}
+- If both *url* field and CDATA section are provided simultaneously, the *url* field is processed first. This approach allows utilization of update modifications or live queries in external scripts, while still providing reliable script source as a fallback alternative within the model itself.
+- [X3D XML Encoding, 4.3.13 Encapsulating Script node code](https://www.web3d.org/documents/specifications/19776-1/V3.3/Part01/concepts.html#EncapsulatingScriptNodeCode){:target="_blank"}
+- MFString arrays can have multiple values, so separate each individual string by quote marks "https://www.web3d.org" "https://www.web3d.org/about" "etc."
+- Alternative XML encoding for quotation mark " is &amp;quot; (which is an example of a character entity).
+- Can replace embedded blank(s) in *url* queries with %20 for each blank character.
+- [X3D Scene Authoring Hints, urls](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#urls){:target="_blank"}
 
 #### Warnings
 
-- Do not use the ecmascript: protocol prefix within external script files. Replace javascript: or vrmlscript: protocol prefix with ecmascript: for source code embedded within an X3D scene.
-
-#### See Also
-
-- [ECMAScript is the ISO standard version of JavaScript.](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#JavaScript){:target="_blank"}
-- [VrmlScript was a subset of JavaScript originally proposed for use with VRML 97.](https://www.bitmanagement.com/developer/spec/vrmlscript/vrmlscript.html){:target="_blank"}
-- [X3D Scene Authoring Hints, urls](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#urls){:target="_blank"}
+- Source code can be placed in *url* attribute but may be unparsable due to escaping of special characters and elimination of line breaks (causing comments to nullify follow-on code). Use contained CDATA section instead for embedding source code.
+- Strictly match directory and filename capitalization for http links! This is important for portability. Some operating systems are forgiving of capitalization mismatches, but http/https *url* addresses and paths in Unix-based operating systems are all case sensitive and intolerant of uppercase/lowercase mismatches.
 
 ### SFTime [in, out] **autoRefresh** 0 <small>[0,∞)</small>
 
@@ -96,28 +104,36 @@ Points to a script file url. Also (as deprecated alternative to CDATA block) can
 
 ### SFBool [ ] **directOutput** FALSE
 
-Set directOutput true if Script has field reference(s) of type SFNode/MFNode, and also uses direct access to modify attributes of a referenced node in the Scene.
+Set *directOutput* true if Script has field reference(s) of type SFNode/MFNode, and also uses direct access to modify attributes of a referenced node in the Scene.
 
 #### Hints
 
-- Set directOutput true if Script dynamically establishes or breaks ROUTEs. DirectOutput is a browser hint to avoid overoptimizing referenced nodes, since the Script may change their attribute values without ROUTEd events. DirectOutput false means Script cannot modify referenced nodes or change ROUTEs.
+- Set *directOutput* true if Script dynamically establishes or breaks ROUTEs.
+- *directOutput* is a browser hint to avoid overoptimizing referenced nodes, since a Script might directly change attribute values in referenced SFNode/MFNode fields, without a ROUTE connecting output events.
+- *directOutput* false means Script cannot modify referenced nodes or change ROUTEs.
 
 ### SFBool [ ] **mustEvaluate** FALSE
 
-If mustEvaluate false, then browser may delay sending input events to Script until outputs are needed. If mustEvaluate true, then Script must receive input events immediately without browser delays.
+If *mustEvaluate* false, then the X3D player may delay sending input events to Script until output events are needed. If *mustEvaluate* true, then Script must receive input events immediately without any event-aggregation delays.
 
 #### Hint
 
-- Set mustEvaluate true when sending/receiving values via the network.
+- Set *mustEvaluate* true when sending/receiving values via the network.
 
-## Description
+## Advisories
 
 ### Hints
 
-- Insert a CDATA node to contain source code embedded within an X3D scene.
-- CDATA blocks can protect literal characters (such as &amp; '<' and '>') in source code from unintended escape-character modifications by XML parsers.
+- Insert an XML Character Data (CDATA) block within the Script node to contain source code embedded within an X3D scene, avoiding the need for escape characters.
+- A contained XML Character Data (CDATA) block for source code protects whitespace, line breaks, and literal characters (such as &amp; for ampersand character, \< for less-than-sign character, and \> for greater-than-sign character) from unintended escape-character modifications by XML parsers.
+- [X3D Scene Authoring Hints, Scripts](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Scripts){:target="_blank"}
+- [Apply `containerField='watchList'` when parent node is LoadSensor.ECMAScript-262 specification](http://www.ecma-international.org/publications/standards/Ecma-262.htm){:target="_blank"}
+- Embedded ecmascript: source can also be contained in the sourceCode pseudo-field without escape characters, equivalent to last entry in the url list, when using other API codebases and file encodings.
 
-## External Links
+### Warning
 
-- [X3D Specification of Script](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/scripting.html#Script){:target="_blank"}
-- [X3D Scene Authoring Hints, Scripts](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Scripts){:target="_blank"}
+- Strict order is required for contained constructs: first field declarations (if any), then IS/connect statements (if any), and finally CDATA source-code block.
+
+## See Also
+
+- [X3D Specification of Script node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/scripting.html#Script){:target="_blank"}