x_ite 8.8.6 → 8.9.0

package/docs/_posts/components/Interpolation/SquadOrientationInterpolator.md

@@ -1,6 +1,6 @@
 ---
 title: SquadOrientationInterpolator
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Interpolation
 categories: [components, Interpolation]
 tags: [SquadOrientationInterpolator, Interpolation]
@@ -15,7 +15,7 @@ tags: [SquadOrientationInterpolator, Interpolation]
 
 SquadOrientationInterpolator performs non-linear interpolation among paired lists of rotation values to produce an SFRotation value_changed output event.
 
-The SquadOrientationInterpolator node belongs to the **Interpolation** component and its default container field is *children.* It is available since X3D version 3.2 or later.
+The SquadOrientationInterpolator node belongs to the **Interpolation** component and its default container field is *children.* It is available from X3D version 3.2 or higher.
 
 ## Hierarchy
 
@@ -30,27 +30,44 @@ The SquadOrientationInterpolator node belongs to the **Interpolation** component
 
 ### 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"}
 
 ### SFFloat [in] **set_fraction** <small>(-∞,∞)</small>
 
 *set_fraction* selects input key for corresponding use of keyValue, keyVelocity values for output computation.
 
+#### Hint
+
+- *set_fraction* values are typically in same range interval as values in the key array. Response to an input *set_fraction* value less than minimum is equivalent to minimum key, and response to an input *set_fraction* value greater than maximum is equivalent to maximum key.
+
+#### Warning
+
+- It is an error to define this transient inputOnly field in an X3D file, instead only use it a destination for ROUTE events.
+
 ### SFBool [in, out] **closed** FALSE
 
-Input/Output field closed.
+Input/Output field *closed*.
 
 ### MFFloat [in, out] **key** [ ] <small>(-∞,∞)</small>
 
-Definition parameters for nonlinear-interpolation function time intervals, in increasing order and corresponding to keyValue, keyVelocity array values.
+Definition parameters for nonlinear-interpolation function time intervals, listed in non-decreasing order and corresponding to keyValue, keyVelocity array values.
 
-#### Warning
+#### Hint
+
+- Typical interval for values in *key* array is within range of 0 to 1, but larger intervals can be defined with arbitrary bounds.
+
+#### Warnings
 
 - Number of keys must match number of keyValues!
+- Values in *key* array shall be monotonically non-decreasing, meaning that each value is greater than or equal to the preceding value.
 
 ### MFRotation [in, out] **keyValue** [ ] <small>(-∞,∞)</small>
 
-Output values for nonlinear interpolation, each corresponding to time-fraction keys.
+Output values for nonlinear interpolation, each corresponding to an input-fraction value in the key array.
 
 #### Warning
 
@@ -60,19 +77,26 @@ Output values for nonlinear interpolation, each corresponding to time-fraction k
 
 Nonlinearly interpolated output value computed by using current time fraction along with corresponding key, keyValue and keyVelocity values.
 
-## Description
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
+
+## Advisories
 
 ### Hints
 
 - Squad is an acronym for Spherical Cubic Interpolation.
 - Typical input connection is ROUTE someTimeSensorDEF.fraction_changed TO thisInterpolatorDEF.set_fraction
 - Typical output connection is ROUTE thisInterpolatorDEF.value_changed TO someDestinationNodeDEF.set_someAttribute.
-- Include `<component name='Interpolation' level='5'/>`
+
+### Warning
+
+- Requires X3D `profile='Full'` or else include `<component name='Interpolation' level='5'/>`
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/Interpolation/SquadOrientationInterpolator/SquadOrientationInterpolator.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of SquadOrientationInterpolator](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/interpolators.html#SquadOrientationInterpolator){:target="_blank"}
+- [X3D Specification of SquadOrientationInterpolator node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/interpolators.html#SquadOrientationInterpolator){:target="_blank"}

package/docs/_posts/components/KeyDeviceSensor/KeySensor.md

@@ -1,6 +1,6 @@
 ---
 title: KeySensor
-date: 2022-01-07
+date: 2023-01-07
 nav: components-KeyDeviceSensor
 categories: [components, KeyDeviceSensor]
 tags: [KeySensor, KeyDeviceSensor]
@@ -13,9 +13,9 @@ tags: [KeySensor, KeyDeviceSensor]
 
 ## Overview
 
-KeySensor generates events as the user presses keys on the keyboard. Supports notion of "keyboard focus".
+KeySensor generates events as the user presses keys on the keyboard. Browser support includes the notion of "keyboard focus".
 
-The KeySensor node belongs to the **KeyDeviceSensor** component and its default container field is *children.* It is available since X3D version 3.0 or later.
+The KeySensor node belongs to the **KeyDeviceSensor** component and its default container field is *children.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -31,7 +31,11 @@ The KeySensor node belongs to the **KeyDeviceSensor** 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"}
 
 ### SFBool [in, out] **enabled** TRUE
 
@@ -41,38 +45,76 @@ Enables/disables node operation.
 
 *controlKey* generates true event when pressed, false event when released.
 
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
+
 ### SFBool [out] **shiftKey**
 
 *shiftKey* generates true event when pressed, false event when released.
 
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
+
 ### SFBool [out] **altKey**
 
 *altKey* generates true event when pressed, false event when released.
 
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
+
 ### SFInt32 [out] **actionKeyPress**
 
-Action key press gives following values: F1..F12 = 1...12 HOME=13 END=14 PGUP=15 PGDN=16 UP=17 DOWN=18 LEFT=19 RIGHT=20.
+Action key press gives following values: HOME=000 END=1001 PGUP=1002 PGDN=1003 UP=1004 DOWN=1005 LEFT=1006 RIGHT=1007 F1..F12 = 1008..1019.
+
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
 
 ### SFInt32 [out] **actionKeyRelease**
 
-Action key release gives following values: F1..F12 = 1...12 HOME=13 END=14 PGUP=15 PGDN=16 UP=17 DOWN=18 LEFT=19 RIGHT=20.
+Action key release gives following values: HOME=000 END=1001 PGUP=1002 PGDN=1003 UP=1004 DOWN=1005 LEFT=1006 RIGHT=1007 F1..F12 = 1008..1019.
+
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
 
 ### SFString [out] **keyPress**
 
 Events generated when user presses character-producing keys on keyboard produces integer UTF-8 character values.
 
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
+
 ### SFString [out] **keyRelease**
 
 Events generated when user releases character-producing keys on keyboard produces integer UTF-8 character values.
 
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
+
 ### SFBool [out] **isActive**
 
-When a key is pressed, the KeySensor sends an isActive event with value true. Once the key is released, the KeySensor sends an isActive event with value false.
+Select geometry by activating the pointing device (for example, clicking the mouse) to generate *isActive* events. Output event *isActive*=true is sent when geometry is selected (for example, when primary mouse button is pressed), output event *isActive*=false is sent when geometry is deselected (for example, when primary mouse button is released).
+
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
+
+## Advisories
+
+### Hint
+
+- [Example scenes and authoring assets](https://x3dgraphics.com/examples/X3dForWebAuthors/Chapter08UserInteractivity){:target="_blank"}
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/KeyDeviceSensor/KeySensor/KeySensor.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of KeySensor](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/keyboard.html#KeySensor){:target="_blank"}
+- [X3D Specification of KeySensor node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/keyboard.html#KeySensor){:target="_blank"}

package/docs/_posts/components/KeyDeviceSensor/StringSensor.md

@@ -1,6 +1,6 @@
 ---
 title: StringSensor
-date: 2022-01-07
+date: 2023-01-07
 nav: components-KeyDeviceSensor
 categories: [components, KeyDeviceSensor]
 tags: [StringSensor, KeyDeviceSensor]
@@ -13,9 +13,9 @@ tags: [StringSensor, KeyDeviceSensor]
 
 ## Overview
 
-StringSensor generates events as the user presses keys on the keyboard.
+StringSensor generates events as the user presses keys on the keyboard. Browser support includes the notion of "keyboard focus".
 
-The StringSensor node belongs to the **KeyDeviceSensor** component and its default container field is *children.* It is available since X3D version 3.0 or later.
+The StringSensor node belongs to the **KeyDeviceSensor** component and its default container field is *children.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -31,7 +31,11 @@ The StringSensor node belongs to the **KeyDeviceSensor** 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.
+
+#### 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
 
@@ -39,7 +43,7 @@ Enables/disables node operation.
 
 ### SFBool [in, out] **deletionAllowed** TRUE
 
-If deletionAllowed is true, then previously entered character in enteredText can be removed. If deletionAllowed is false, then characters may only be added to the string.
+If *deletionAllowed* is true, then previously entered character in enteredText can be removed. If *deletionAllowed* is false, then characters may only be added to the string.
 
 #### Hint
 
@@ -49,22 +53,40 @@ If deletionAllowed is true, then previously entered character in enteredText can
 
 Events generated as character-producing keys are pressed on keyboard.
 
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
+
 ### SFString [out] **finalText**
 
-Events generated when sequence of keystrokes matches keys in terminationText string when this condition occurs, enteredText is moved to finalText and enteredText is set to empty string.
+Events generated when sequence of keystrokes matches keys in terminationText string when this condition occurs, enteredText is moved to *finalText* and enteredText is set to empty string.
 
 #### Hint
 
 - Termination key is typically defined by local system.
 
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
+
 ### SFBool [out] **isActive**
 
-When the user begins typing, the StringSensor sends an isActive event with value true. When the string is terminated, the StringSensor sends an isActive event with value false.
+Select geometry by activating the pointing device (for example, clicking the mouse) to generate *isActive* events. Output event *isActive*=true is sent when geometry is selected (for example, when primary mouse button is pressed), output event *isActive*=false is sent when geometry is deselected (for example, when primary mouse button is released).
+
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
+
+## Advisories
+
+### Hint
+
+- [Example scenes and authoring assets](https://x3dgraphics.com/examples/X3dForWebAuthors/Chapter08UserInteractivity){:target="_blank"}
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/KeyDeviceSensor/StringSensor/StringSensor.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of StringSensor](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/keyboard.html#StringSensor){:target="_blank"}
+- [X3D Specification of StringSensor node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/keyboard.html#StringSensor){:target="_blank"}

package/docs/_posts/components/Layering/Layer.md

@@ -1,6 +1,6 @@
 ---
 title: Layer
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Layering
 categories: [components, Layering]
 tags: [Layer, Layering]
@@ -15,7 +15,7 @@ tags: [Layer, Layering]
 
 Layer contains a list of children nodes that define the contents of the layer.
 
-The Layer node belongs to the **Layering** component and its default container field is *layers.* It is available since X3D version 3.2 or later.
+The Layer node belongs to the **Layering** component and its default container field is *layers.* It is available from X3D version 3.2 or higher.
 
 ## Hierarchy
 
@@ -29,39 +29,64 @@ The Layer node belongs to the **Layering** component and its default container f
 
 ### 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.
 
-### SFBool [in, out] **isPickable** TRUE
+#### 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] **pickable** TRUE
+
+*pickable* determines whether pick traversal is performed for this layer.
+
+### MFString [in, out] **objectType** "ALL" <small>["ALL", "NONE", "TERRAIN", ...]</small>
+
+The *objectType* field specifies a set of labels used in the picking process. Each string specified is treated as an independent label that needs to be matched against the same type in one of the pick sensor instances. Example: labeling a PickableGroup with the *objectType* value "WATER" and then attempting to intersect a pick sensor with *objectType* value "GROUND" fails since the *objectType* values do not match. Example: the special value "ALL" means that each node is available for picking regardless of the type specified by the pick sensor. Example: the special value "NONE" effectively disables all picking for this node and is the equivalent of setting the pickable field to false.
 
-*isPickable* determines whether pick traversal is performed for this layer.
+#### Hints
+
+- Authors may define any value for *objectType*.
+- MFString arrays can have multiple values, so "separate each individual string" "by using quote marks".
+
+### SFBool [in, out] **visible** TRUE
+
+Whether or not renderable content within this node is visually displayed.
+
+#### 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.
 
 ### SFNode [in, out] **viewport** NULL <small>[X3DViewportNode]</small>
 
-The viewport field is a single Viewport node that constrains layer output to a sub-region of the render surface.
+The *viewport* field is a single Viewport node that constrains layer output to a sub-region of the render surface.
 
 ### MFNode [in] **addChildren**
 
-Input field addChildren.
+Input field *addChildren*.
 
 ### MFNode [in] **removeChildren**
 
-Input field removeChildren.
+Input field *removeChildren*.
 
 ### MFNode [in, out] **children** [ ] <small>[X3DChildNode]</small>
 
 Nodes making up this layer.
 
-#### Hint
+#### Hints
 
-- No transformations are possible above each Layerset/Layer combination in the scene graph hierarchy.
+- No transformations are possible above each LayerSet/Layer combination in the scene graph hierarchy.
+- InputOnly MFNode addChildren field can append new X3DChildNode nodes via a ROUTE connection, duplicate input nodes (i.e. matching DEF, USE values) are ignored.
+- InputOnly MFNode removeChildren field can remove nodes from the *children* list, unrecognized input nodes (i.e. nonmatching DEF, USE values) are ignored.
+- [X3D Architecture 10.2.1 Grouping and *children* node types](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/grouping.html#GroupingAndChildrenNodes){:target="_blank"}
 
-## Description
+## Advisories
 
 ### Hints
 
-- No transformations are possible above each Layerset/Layer combination in the scene graph hierarchy.
+- No transformations are possible above each LayerSet/Layer combination in the scene graph hierarchy.
 - Each Layer node contains its own binding stacks and thus has its own viewpoints and navigation.
 
-## External Links
+## See Also
 
-- [X3D Specification of Layer](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/layering.html#Layer){:target="_blank"}
+- [X3D Specification of Layer node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/layering.html#Layer){:target="_blank"}

package/docs/_posts/components/Layering/LayerSet.md

@@ -1,6 +1,6 @@
 ---
 title: LayerSet
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Layering
 categories: [components, Layering]
 tags: [LayerSet, Layering]
@@ -15,7 +15,7 @@ tags: [LayerSet, Layering]
 
 LayerSet defines a list of layers and a rendering order. The rendering order is specified by the order field.
 
-The LayerSet node belongs to the **Layering** component and its default container field is *children.* It is available since X3D version 3.2 or later.
+The LayerSet node belongs to the **Layering** component and its default container field is *children.* It is available from X3D version 3.2 or higher.
 
 ## Hierarchy
 
@@ -28,9 +28,13 @@ The LayerSet node belongs to the **Layering** component and its default containe
 
 ### 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.
 
-### SFInt32 [in, out] **activeLayer** <small>(0,∞)</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"}
+
+### SFInt32 [in, out] **activeLayer** 0 <small>(0,∞)</small>
 
 *activeLayer* field specifies the layer in which navigation takes place.
 
@@ -38,31 +42,34 @@ Metadata are not part of the X3D world and not interpreted by the X3D browser, b
 
 - Nodes that are not part of a layer are considered to be in layer 0.
 
-### MFInt32 [in, out] **order** <small>(0,∞)</small>
+### MFInt32 [in, out] **order** [ 0 ] <small>(0,∞)</small>
 
-The order list defines the order in which layers are rendered. Each value corresponds to the ordinals of the layers.
+The *order* list defines the *order* in which layers are rendered. Each value corresponds to the ordinals of the layers.
 
 #### Hint
 
-- The order list may contain repetitions of ordinal values, in which case the layer is rendered again.
+- The *order* list may contain repetitions of ordinal values, in which case the layer is rendered again.
 
 #### Warnings
 
-- If order contains number values that are not ordinals assigned to layers, such numbers are ignored. Layers that are not included in the order list are not rendered.
+- If *order* contains number values that are not ordinals assigned to layers, such numbers are ignored.
+- Layers that are not included in the *order* list are not rendered.
 
 ### MFNode [in, out] **layers** [ ] <small>[X3DLayerNode]</small>
 
-The layers list defines a list of Layer nodes that contain the constituent parts of the scene. Each layer is assigned an ordinal number depending on its position in this contained list of nodes.
+The *layers* list defines a list of Layer nodes that contain the constituent parts of the scene. Each layer is assigned an ordinal number depending on its position in this contained list of nodes.
 
 #### Hints
 
-- Ordinal values start with the numeral 1 representing the first item in the list. Nodes that are not part of a layer are considered to be in layer 0.
+- Ordinal values start with the numeral 1 representing the first item in the list.
+- Nodes that are not part of a layer are considered to be in layer 0.
 
-## Description
+## Advisories
 
-### Hint
+### Hints
 
 - The layer first specified in the order field is the first layer rendered and appears below any other layers. The layer last specified in the order field is the last layer rendered and correspondingly appears on top of all other layers.
+- [X3D Architecture 35.2.1 Overview of layering](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/layering.html#OverviewOfLayering){:target="_blank"}
 
 ### Warning
 
@@ -72,7 +79,6 @@ The layers list defines a list of Layer nodes that contain the constituent parts
 
 <x3d-canvas src="https://create3000.github.io/media/examples/Layering/LayerSet/LayerSet.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of LayerSet](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/layering.html#LayerSet){:target="_blank"}
-- [X3D Abstract Specification 35.2.1 Overview of layering](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/layering.html#OverviewOfLayering){:target="_blank"}
+- [X3D Specification of LayerSet node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/layering.html#LayerSet){:target="_blank"}

package/docs/_posts/components/Layering/Viewport.md

@@ -1,6 +1,6 @@
 ---
 title: Viewport
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Layering
 categories: [components, Layering]
 tags: [Viewport, Layering]
@@ -15,7 +15,7 @@ tags: [Viewport, Layering]
 
 Viewport is a Grouping node that can contain most nodes. Viewport specifies a set of rectangular clip boundaries against which the children nodes are clipped as they are rendered.
 
-The Viewport node belongs to the **Layering** component and its default container field is *viewport.* It is available since X3D version 3.2 or later.
+The Viewport node belongs to the **Layering** component and its default container field is *viewport.* It is available from X3D version 3.2 or higher.
 
 ## Hierarchy
 
@@ -33,7 +33,11 @@ The Viewport node belongs to the **Layering** component and its default containe
 
 ### 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"}
 
 ### MFFloat [in, out] **clipBoundary** [ 0, 1, 0, 1 ] <small>[0,1]</small>
 
@@ -43,16 +47,16 @@ Metadata are not part of the X3D world and not interpreted by the X3D browser, b
 
 - Default value 0 1 0 1 indicates 0-1 left-to-right and 0-1 bottom-to-top, meaning full view.
 
-### SFBool [ ] **visible** TRUE
+### 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 [ ] **bboxDisplay** FALSE
+### SFBool [in, out] **bboxDisplay** FALSE
 
 Whether to display bounding box for associated geometry, aligned with world coordinates.
 
@@ -60,38 +64,50 @@ Whether to display bounding box for associated geometry, aligned with world coor
 
 - The bounding box is displayed regardless of whether contained content is visible.
 
-### SFVec3f [ ] **bboxSize** -1 -1 -1 <small>(0,∞) or -1 -1 -1</small>
+### SFVec3f [ ] **bboxSize** -1 -1 -1 <small>[0,∞) or −1 −1 −1</small>
 
 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"}
 
 ### MFNode [in] **addChildren**
 
-Input field addChildren.
+Input field *addChildren*.
 
 ### MFNode [in] **removeChildren**
 
-Input field removeChildren.
+Input field *removeChildren*.
 
 ### MFNode [in, out] **children** [ ] <small>[X3DChildNode]</small>
 
-Grouping nodes contain a list of children nodes.
+Grouping nodes contain an ordered list of *children* nodes.
 
-#### Hint
+#### Hints
 
-- Each grouping node defines a coordinate space for its children, relative to the coordinate space of its parent node. Thus transformations accumulate down the scene graph hierarchy.
+- Each grouping node defines a coordinate space for its *children*, relative to the coordinate space of its parent node. Thus transformations accumulate down the scene graph hierarchy.
+- InputOnly MFNode addChildren field can append new X3DChildNode nodes via a ROUTE connection, duplicate input nodes (i.e. matching DEF, USE values) are ignored.
+- InputOnly MFNode removeChildren field can remove nodes from the *children* list, unrecognized input nodes (i.e. nonmatching DEF, USE values) are ignored.
+- [X3D Architecture 10.2.1 Grouping and *children* node types](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/grouping.html#GroupingAndChildrenNodes){:target="_blank"}
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/Layering/Viewport/Viewport.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of Viewport](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/layering.html#Viewport){:target="_blank"}
+- [X3D Specification of Viewport node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/layering.html#Viewport){:target="_blank"}