x_ite 8.8.7 → 8.9.0

package/docs/_posts/components/Navigation/OrthoViewpoint.md

@@ -1,6 +1,6 @@
 ---
 title: OrthoViewpoint
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Navigation
 categories: [components, Navigation]
 tags: [OrthoViewpoint, Navigation]
@@ -15,7 +15,7 @@ tags: [OrthoViewpoint, Navigation]
 
 OrthoViewpoint provides an orthographic perspective-free view of a scene from a specific location and direction.
 
-The OrthoViewpoint node belongs to the **Navigation** component and its default container field is *children.* It is available since X3D version 3.0 or later.
+The OrthoViewpoint node belongs to the **Navigation** component and its default container field is *children.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -31,23 +31,39 @@ The OrthoViewpoint node belongs to the **Navigation** 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] **set_bind**
 
-Sending event set_bind=true makes this node active. Sending event set_bind=false makes this node inactive. Thus setting set_bind to true/false will pop/push (enable/disable) this Viewpoint.
+Sending event *set_bind*=true makes this node active. Sending event *set_bind*=false makes this node inactive. Thus setting *set_bind* to true/false will pop/push (enable/disable) this Viewpoint.
+
+#### Hint
+
+- Paired node operations can be established by connecting *set_bind* and isBound fields of corresponding bindable nodes.
+
+#### Warning
+
+- It is an error to define this transient inputOnly field in an X3D file, instead only use it a destination for ROUTE events.
 
 ### SFString [in, out] **description** ""
 
-Text description or navigation hint to identify this Viewpoint.
+Text *description* or navigation hint to describe the significance of this model Viewpoint.
 
 #### Hints
 
-- Use spaces, make descriptions clear and readable. Many XML tools substitute XML character references automatically if needed (such as &amp;#38; for &amp; ampersand, or &amp;#34; for " quotation mark).
+- A sequence of good Viewpoints with understandable descriptions can provide a guided tour of a model.
+- The currently bound NavigationInfo node has a major effect on how a user might change viewing position and orientation after reaching this Viewpoint.
+- Consider paired Viewpoint/NavigationInfo node combinations by defining ROUTE connections between corresponding isBound/set_bind fields.
+- Include space characters since a *description* is not a DEF identifier. Write short phrases that make descriptions clear and readable.
+- 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).
 
 #### Warning
 
-- Without description, this OrthoViewpoint is unlikely to appear on browser Viewpoints menu.
+- Without *description*, this OrthoViewpoint is unlikely to appear on browser Viewpoint menus.
 
 ### SFVec3f [in, out] **position** 0 0 10 <small>(-∞,∞)</small>
 
@@ -59,7 +75,12 @@ Rotation (axis, angle in radians) of Viewpoint, relative to default -Z axis dire
 
 #### Hints
 
-- This is orientation \_change\_ from default direction (0 0 -1). Complex rotations can be accomplished axis-by-axis using parent Transforms.
+- This is *orientation* _change_ from default direction (0 0 -1).
+- Complex rotations can be accomplished axis-by-axis using parent Transforms.
+
+#### Warning
+
+- For VR/AR/MAR users wearing a head-mounted display (HMD), animating this field may induce motion sickness.
 
 ### SFVec3f [in, out] **centerOfRotation** 0 0 0 <small>(-∞,∞)</small>
 
@@ -69,41 +90,42 @@ Rotation (axis, angle in radians) of Viewpoint, relative to default -Z axis dire
 
 Minimum and maximum extents of view in units of local coordinate system. Small field of view roughly corresponds to a telephoto lens, large field of view roughly corresponds to a wide-angle lens.
 
-#### Hint
+#### Hints
 
+- Validation type SFVec3f is stricter than specification legacy value in order to detect illegal values.
 - Rectangular display width/height = (maxX-minX) / (maxY-minY)
 
 #### Warning
 
-- Minimum corner must remain less than maximum corner.
+- Minimum corner values must remain less than maximum corner values.
 
 ### SFFloat [in, out] **nearDistance** -1 <small>-1 or (0,∞)</small>
 
-nearDistance defines minimum clipping plane distance necessary for object display.
+*nearDistance* defines minimum clipping plane distance necessary for object display.
 
 #### Hints
 
-- overrides bound NavigationInfo visibilityLimit value, if any.
-- default value -1 means no effect on currently defined view frustum boundaries.
+- Overrides bound NavigationInfo avatarSize value, if any.
+- Default value -1 means no effect on currently defined view frustum boundaries.
 - [Aliasing](https://en.wikipedia.org/wiki/Aliasing){:target="_blank"} and [Clipping](https://en.wikipedia.org/wiki/Clipping_(computer_graphics)){:target="_blank"}
 
-#### Warnings
+#### Warning
 
-- nearDistance must be less than farDistance.
+- *nearDistance* must be less than farDistance.
 
 ### SFFloat [in, out] **farDistance** -1 <small>-1 or (0,∞)</small>
 
-farDistance defines maximum clipping plane distance allowed for object display.
+*farDistance* defines maximum clipping plane distance allowed for object display.
 
 #### Hints
 
-- overrides bound NavigationInfo visibilityLimit value, if any.
-- default value -1 means no effect on currently defined view frustum boundaries.
+- Overrides bound NavigationInfo visibilityLimit value, if any.
+- Default value -1 means no effect on currently defined view frustum boundaries.
 - [Aliasing](https://en.wikipedia.org/wiki/Aliasing){:target="_blank"} and [Clipping](https://en.wikipedia.org/wiki/Clipping_(computer_graphics)){:target="_blank"}
 
-#### Warnings
+#### Warning
 
-- nearDistance must be less than farDistance.
+- NearDistance must be less than *farDistance*.
 
 ### SFBool [in, out] **viewAll** FALSE
 
@@ -111,20 +133,25 @@ Viewpoint is automatically adjusted to view all visible geometry. Typically cent
 
 #### Hints
 
-- no collision detection or proximity sensing occurs when zooming.
-- when the value of the viewAll field is changed from TRUE to FALSE, no change in the current view occurs.
+- No collision detection or proximity sensing occurs when zooming.
+- When the value of the *viewAll* field is changed from TRUE to FALSE, no change in the current view occurs.
 
 #### Warning
 
-- if needed, near and far clipping planes shall be adjusted to allow viewing the entire scene.
+- If needed, near and far clipping planes shall be adjusted to allow viewing the entire scene.
 
 ### SFBool [in, out] **jump** TRUE
 
-Transition instantly by jumping, or smoothly adjust offsets in place when changing to this Viewpoint.
+Transition instantly by jumping, otherwise smoothly adjust offsets in place when changing to this Viewpoint.
 
-#### Hint
+#### Hints
+
+- See NavigationInfo.transitionType for the manner in which animated Viewpoint transistions occur.
+- Set *jump*=true for instantaneous camera motion when going to this viewpoint.
+
+#### Warning
 
-- Set jump=true for smooth camera motion when going to this viewpoint.
+- For VR/AR/MAR users wearing head-mounted displays, animating transitions between viewpoints may induce motion sickness.
 
 ### SFBool [in, out] **retainUserOffsets** FALSE
 
@@ -132,35 +159,51 @@ Retain (true) or reset to zero (false) any prior user navigation offsets from de
 
 ### SFBool [out] **isBound**
 
-Event true sent when node becomes active, event false sent when unbound by another node.
+Output event true gets sent when node becomes bound and activated, otherwise output event false gets sent when node becomes unbound and deactivated.
+
+#### Hint
+
+- Paired node operations can be established by connecting set_bind and *isBound* fields of corresponding bindable nodes.
+
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
 
 ### SFTime [out] **bindTime**
 
-Event sent when node becomes active/inactive.
+Event sent reporting timestamp when node becomes active/inactive.
+
+#### 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] **navigationInfo** NULL <small>[NavigationInfo]</small>
 
-The navigationInfo field defines a dedicated NavigationInfo node for this X3DViewpointNode. The specified NavigationInfo node receives a set_bind TRUE event at the time when the parent node is bound and receives a set_bind FALSE at the time when the parent node is unbound.
+The *navigationInfo* field defines a dedicated NavigationInfo node for this X3DViewpointNode. The specified NavigationInfo node receives a set_bind TRUE event at the time when the parent node is bound and receives a set_bind FALSE at the time when the parent node is unbound.
 
 #### Hint
 
 - Allows simple integration of custom navigation associated with each Viewpoint according to user needs at that location.
 
-## Description
+## Advisories
 
-### Hint
+### Hints
 
-- NavigationInfo, Background, TextureBackground, Fog, OrthoViewpoint and Viewpoint are bindable nodes, meaning that no more than one of each node type can be active at a given time.
+- Background, Fog, GeoViewpoint, NavigationInfo, OrthoViewpoint, TextureBackground and Viewpoint are bindable nodes, meaning that no more than one of each node type can be active at a given time.
+- GeoViewpoint OrthoViewpoint and Viewpoint share the same binding stack, so no more than one of these nodes can be bound and active at a given time.
+- Regardless of viewpoint jump value at bind time, the relative viewing transformation between user's view and defined position/orientation is stored for later use when un-jumping (returning to the viewpoint when subsequent viewpoint is unbound).
+- Customizable design pattern for dedicated Viewpoint/NavigationInfo pair: \<Viewpoint DEF='SpecialView'/\> \<NavigationInfo DEF='SpecialNav'/\> \<ROUTE fromNode='SpecialView' fromField='isBound' toNode='SpecialNav' toField='set_bind'/\>
+- [X3D Scene Authoring Hints, Viewpoints](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Viewpoints){:target="_blank"}
 
-### Warning
+### Warnings
 
-- Do not include Viewpoint or OrthoViewpoint as a child of LOD or Switch, instead use ViewpointGroup as parent to constrain location proximity where the viewpoint is available to user.
+- Results are undefined if a bindable node (Background, Fog, NavigationInfo, OrthoViewpoint, TextureBackground, Viewpoint) is a contained descendant node of either LOD or Switch. Avoid this authoring pattern.
+- Do not include GeoViewpoint OrthoViewpoint or Viewpoint as a child of LOD or Switch, instead use ViewpointGroup as parent to constrain location proximity where the viewpoint is available to user.
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/Navigation/OrthoViewpoint/OrthoViewpoint.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of OrthoViewpoint](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/navigation.html#OrthoViewpoint){:target="_blank"}
-- [X3D Scene Authoring Hints, Viewpoints](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Viewpoints){:target="_blank"}
+- [X3D Specification of OrthoViewpoint node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/navigation.html#OrthoViewpoint){:target="_blank"}

package/docs/_posts/components/Navigation/Viewpoint.md

@@ -1,6 +1,6 @@
 ---
 title: Viewpoint
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Navigation
 categories: [components, Navigation]
 tags: [Viewpoint, Navigation]
@@ -13,9 +13,9 @@ tags: [Viewpoint, Navigation]
 
 ## Overview
 
-Viewpoint provides a specific location and direction where the user may view the scene.
+Viewpoint provides a specific location and direction where the user may view the scene. Viewpoints are the primary way for a user to navigate within a scene, and for an author to show critical aspects of a model.
 
-The Viewpoint node belongs to the **Navigation** component and its default container field is *children.* It is available since X3D version 2.0 or later.
+The Viewpoint node belongs to the **Navigation** component and its default container field is *children.* It is available from X3D version 2.0 or higher.
 
 ## Hierarchy
 
@@ -31,23 +31,39 @@ The Viewpoint node belongs to the **Navigation** component and its default conta
 
 ### 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] **set_bind**
 
-Sending event set_bind=true makes this node active. Sending event set_bind=false makes this node inactive. Thus setting set_bind to true/false will pop/push (enable/disable) this Viewpoint.
+Sending event *set_bind*=true makes this node active. Sending event *set_bind*=false makes this node inactive. Thus setting *set_bind* to true/false will pop/push (enable/disable) this Viewpoint.
+
+#### Hint
+
+- Paired node operations can be established by connecting *set_bind* and isBound fields of corresponding bindable nodes.
+
+#### Warning
+
+- It is an error to define this transient inputOnly field in an X3D file, instead only use it a destination for ROUTE events.
 
 ### SFString [in, out] **description** ""
 
-Text description or navigation hint to identify this Viewpoint.
+Text *description* or navigation hint to describe the significance of this model Viewpoint.
 
 #### Hints
 
-- Use spaces, make descriptions clear and readable. Many XML tools substitute XML character references automatically if needed (such as &amp;#38; for &amp; ampersand, or &amp;#34; for " quotation mark).
+- A sequence of good Viewpoints with understandable descriptions can provide a guided tour of a model.
+- The currently bound NavigationInfo node has a major effect on how a user might change viewing position and orientation after reaching this Viewpoint.
+- Consider paired Viewpoint/NavigationInfo node combinations by defining ROUTE connections between corresponding isBound/set_bind fields.
+- Include space characters since a *description* is not a DEF identifier. Write short phrases that make descriptions clear and readable.
+- 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).
 
 #### Warning
 
-- Without description, this Viewpoint is unlikely to appear on browser Viewpoints menu.
+- Without *description*, this Viewpoint is unlikely to appear on browser Viewpoint menus.
 
 ### SFVec3f [in, out] **position** 0 0 10 <small>(-∞,∞)</small>
 
@@ -59,7 +75,12 @@ Rotation (axis, angle in radians) of Viewpoint, relative to default -Z axis dire
 
 #### Hints
 
-- This is orientation \_change\_ from default direction (0 0 -1). Complex rotations can be accomplished axis-by-axis using parent Transforms.
+- This is *orientation* _change_ from default direction (0 0 -1).
+- Complex rotations can be accomplished axis-by-axis using parent Transforms.
+
+#### Warning
+
+- For VR/AR/MAR users wearing a head-mounted display (HMD), animating this field may induce motion sickness.
 
 ### SFVec3f [in, out] **centerOfRotation** 0 0 0 <small>(-∞,∞)</small>
 
@@ -67,43 +88,44 @@ Rotation (axis, angle in radians) of Viewpoint, relative to default -Z axis dire
 
 ### SFFloat [in, out] **fieldOfView** π/4 <small>(0,π)</small>
 
-Preferred minimum viewing angle from this viewpoint in radians. Small field of view roughly corresponds to a telephoto lens, large field of view roughly corresponds to a wide-angle lens.
+Preferred minimum viewing angle from this viewpoint in radians, providing minimum height or minimum width (whichever is smaller). Small field of view roughly corresponds to a telephoto lens, large field of view roughly corresponds to a wide-angle lens.
 
 #### Hint
 
 - Modifying Viewpoint distance to object may be better for zooming.
 
-#### Warning
+#### Warnings
 
-- *fieldOfView* may not be correct for different window sizes and aspect ratios. Interchange profile hint: this field may be ignored, applying the default value regardless.
+- *fieldOfView* may not be correct for different window sizes and aspect ratios.
+- For VR/AR/MAR users wearing a head-mounted display (HMD), animating this field may induce motion sickness. Interchange profile hint: this field may be ignored, applying the default value regardless.
 
 ### SFFloat [in, out] **nearDistance** -1 <small>-1 or (0,∞)</small>
 
-nearDistance defines minimum clipping plane distance necessary for object display.
+*nearDistance* defines minimum clipping plane distance necessary for object display.
 
 #### Hints
 
-- overrides bound NavigationInfo visibilityLimit value, if any.
-- default value -1 means no effect on currently defined view frustum boundaries.
+- Overrides bound NavigationInfo avatarSize value, if any.
+- Default value -1 means no effect on currently defined view frustum boundaries.
 - [Aliasing](https://en.wikipedia.org/wiki/Aliasing){:target="_blank"} and [Clipping](https://en.wikipedia.org/wiki/Clipping_(computer_graphics)){:target="_blank"}
 
-#### Warnings
+#### Warning
 
-- nearDistance must be less than farDistance.
+- *nearDistance* must be less than farDistance.
 
 ### SFFloat [in, out] **farDistance** -1 <small>-1 or (0,∞)</small>
 
-farDistance defines maximum clipping plane distance allowed for object display.
+*farDistance* defines maximum clipping plane distance allowed for object display.
 
 #### Hints
 
-- overrides bound NavigationInfo visibilityLimit value, if any.
-- default value -1 means no effect on currently defined view frustum boundaries.
+- Overrides bound NavigationInfo visibilityLimit value, if any.
+- Default value -1 means no effect on currently defined view frustum boundaries.
 - [Aliasing](https://en.wikipedia.org/wiki/Aliasing){:target="_blank"} and [Clipping](https://en.wikipedia.org/wiki/Clipping_(computer_graphics)){:target="_blank"}
 
-#### Warnings
+#### Warning
 
-- nearDistance must be less than farDistance.
+- NearDistance must be less than *farDistance*.
 
 ### SFBool [in, out] **viewAll** FALSE
 
@@ -111,20 +133,25 @@ Viewpoint is automatically adjusted to view all visible geometry. Typically cent
 
 #### Hints
 
-- no collision detection or proximity sensing occurs when zooming.
-- when the value of the viewAll field is changed from TRUE to FALSE, no change in the current view occurs.
+- No collision detection or proximity sensing occurs when zooming.
+- When the value of the *viewAll* field is changed from TRUE to FALSE, no change in the current view occurs.
 
 #### Warning
 
-- if needed, near and far clipping planes shall be adjusted to allow viewing the entire scene.
+- If needed, near and far clipping planes shall be adjusted to allow viewing the entire scene.
 
 ### SFBool [in, out] **jump** TRUE
 
-Transition instantly by jumping, or smoothly adjust offsets in place when changing to this Viewpoint.
+Transition instantly by jumping, otherwise smoothly adjust offsets in place when changing to this Viewpoint.
 
-#### Hint
+#### Hints
 
-- Set jump=true for smooth camera motion when going to this viewpoint.
+- See NavigationInfo.transitionType for the manner in which animated Viewpoint transistions occur.
+- Set *jump*=true for instantaneous camera motion when going to this viewpoint.
+
+#### Warning
+
+- For VR/AR/MAR users wearing head-mounted displays, animating transitions between viewpoints may induce motion sickness.
 
 ### SFBool [in, out] **retainUserOffsets** FALSE
 
@@ -132,35 +159,55 @@ Retain (true) or reset to zero (false) any prior user navigation offsets from de
 
 ### SFBool [out] **isBound**
 
-Event true sent when node becomes active, event false sent when unbound by another node.
+Output event true gets sent when node becomes bound and activated, otherwise output event false gets sent when node becomes unbound and deactivated.
+
+#### Hint
+
+- Paired node operations can be established by connecting set_bind and *isBound* fields of corresponding bindable nodes.
+
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
 
 ### SFTime [out] **bindTime**
 
-Event sent when node becomes active/inactive.
+Event sent reporting timestamp when node becomes active/inactive.
+
+#### 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] **navigationInfo** NULL <small>[NavigationInfo]</small>
 
-The navigationInfo field defines a dedicated NavigationInfo node for this X3DViewpointNode. The specified NavigationInfo node receives a set_bind TRUE event at the time when the parent node is bound and receives a set_bind FALSE at the time when the parent node is unbound.
+The *navigationInfo* field defines a dedicated NavigationInfo node for this X3DViewpointNode. The specified NavigationInfo node receives a set_bind TRUE event at the time when the parent node is bound and receives a set_bind FALSE at the time when the parent node is unbound.
 
 #### Hint
 
 - Allows simple integration of custom navigation associated with each Viewpoint according to user needs at that location.
 
-## Description
+## Advisories
 
-### Hint
+### Hints
 
-- NavigationInfo, Background, TextureBackground, Fog, OrthoViewpoint and Viewpoint are bindable nodes, meaning that no more than one of each node type can be active at a given time.
+- A sequence of good Viewpoints with understandable descriptions can provide a guided tour of a model.
+- The currently bound NavigationInfo node has a major effect on how a user might change viewing position and orientation after reaching this Viewpoint.
+- Consider paired Viewpoint/NavigationInfo node combinations by defining ROUTE connections between corresponding isBound/set_bind fields.
+- Consider how users might interact with the current X3D model, either standalone or as an Inline within a larger parent scene.
+- Background, Fog, GeoViewpoint, NavigationInfo, OrthoViewpoint, TextureBackground and Viewpoint are bindable nodes, meaning that no more than one of each node type can be active at a given time.
+- GeoViewpoint OrthoViewpoint and Viewpoint share the same binding stack, so no more than one of these nodes can be bound and active at a given time.
+- Regardless of viewpoint jump value at bind time, the relative viewing transformation between user's view and defined position/orientation is stored for later use when un-jumping (returning to the viewpoint when subsequent viewpoint is unbound).
+- Customizable design pattern for dedicated Viewpoint/NavigationInfo pair: \<Viewpoint DEF='SpecialView'/\> \<NavigationInfo DEF='SpecialNav'/\> \<ROUTE fromNode='SpecialView' fromField='isBound' toNode='SpecialNav' toField='set_bind'/\>
+- [X3D Scene Authoring Hints, Viewpoints](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Viewpoints){:target="_blank"}
 
-### Warning
+### Warnings
 
-- Do not include Viewpoint or OrthoViewpoint as a child of LOD or Switch, instead use ViewpointGroup as parent to constrain location proximity where the viewpoint is available to user.
+- Results are undefined if a bindable node (Background, Fog, NavigationInfo, OrthoViewpoint, TextureBackground, Viewpoint) is a contained descendant node of either LOD or Switch. Avoid this authoring pattern.
+- Do not include GeoViewpoint OrthoViewpoint or Viewpoint as a child of LOD or Switch, instead use ViewpointGroup as parent to constrain location proximity where the viewpoint is available to user.
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/Navigation/Viewpoint/Viewpoint.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of Viewpoint](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/navigation.html#Viewpoint){:target="_blank"}
-- [X3D Scene Authoring Hints, Viewpoints](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Viewpoints){:target="_blank"}
+- [X3D Specification of Viewpoint node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/navigation.html#Viewpoint){:target="_blank"}

package/docs/_posts/components/Navigation/ViewpointGroup.md

@@ -1,6 +1,6 @@
 ---
 title: ViewpointGroup
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Navigation
 categories: [components, Navigation]
 tags: [ViewpointGroup, Navigation]
@@ -13,9 +13,9 @@ tags: [ViewpointGroup, Navigation]
 
 ## Overview
 
-ViewpointGroup collects Viewpoint, OrthoViewpoint and other ViewpointGroup nodes for better user-navigation support with a shared description on the viewpoint list.
+ViewpointGroup can contain Viewpoint, OrthoViewpoint, GeoViewpoint and other ViewpointGroup nodes for better user-navigation support with a shared description on the viewpoint list.
 
-The ViewpointGroup node belongs to the **Navigation** component and its default container field is *children.* It is available since X3D version 3.2 or later.
+The ViewpointGroup node belongs to the **Navigation** component and its default container field is *children.* It is available from X3D version 3.2 or higher.
 
 ## Hierarchy
 
@@ -29,23 +29,28 @@ The ViewpointGroup node belongs to the **Navigation** 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"}
 
 ### SFString [in, out] **description** ""
 
-Text description or navigation hint to identify this ViewpointGroup.
+Text *description* or navigation hint to identify this ViewpointGroup.
 
 #### Hints
 
-- Use spaces, make descriptions clear and readable. Many XML tools substitute XML character references automatically if needed (such as &amp;#38; for &amp; ampersand, or &amp;#34; for " quotation mark).
+- Include space characters since a *description* is not a DEF identifier. Write short phrases that make descriptions clear and readable.
+- 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).
 
 #### Warning
 
-- Without description, this ViewpointGroup is unlikely to appear on browser Viewpoints menu.
+- Without *description*, this ViewpointGroup is unlikely to appear on browser Viewpoint menus.
 
 ### SFBool [in, out] **displayed** TRUE
 
-*displayed* determines whether this ViewpointGroup is displayed in the current viewpoint list.
+*displayed* determines whether this ViewpointGroup is *displayed* in the current viewpoint list.
 
 ### SFBool [in, out] **retainUserOffsets** FALSE
 
@@ -53,28 +58,34 @@ Retain (true) or reset to zero (false) any prior user navigation offsets from de
 
 ### SFVec3f [in, out] **size** 0 0 0 <small>(-∞,∞)</small>
 
-*size* of proximity box around center location within which ViewpointGroup is usable and displayed on viewpoint list.
+Size of proximity box around center location within which ViewpointGroup is usable and displayed on viewpoint list.
 
 #### Hint
 
-- Size 0 0 0 specifies that ViewpointGroup is always usable and displayable.
+- *size* 0 0 0 specifies that ViewpointGroup is always usable and displayable.
 
 ### SFVec3f [in, out] **center** 0 0 0 <small>(-∞,∞)</small>
 
-*center* specifies center point of proximity box within which ViewpointGroup is usable and displayed on viewpoint list.
+*center* specifies *center* point of proximity box within which ViewpointGroup is usable and displayed on viewpoint list.
 
 ### MFNode [in, out] **children** [ ] <small>[X3DViewpointNode | ViewpointGroup]</small>
 
-Input/Output field children.
+ViewpointGroup contains Viewpoint, OrthoViewpoint, GeoViewpoint and other ViewpointGroup nodes that each have `containerField='children'` default value.
+
+#### Hints
+
+- 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
 
-- Use ViewpointGroup as parent for Viewpoint and OrthoViewpoint to constrain location proximity where contained viewpoints are available to user.
+- Use ViewpointGroup as parent for Viewpoint, OrthoViewpoint, GeoViewpoint and other ViewpointGroup nodes to constrain location proximity where contained viewpoints are available to user.
 - ViewpointGroup and OrthoViewpoint require Navigation component level 3, which is higher than CADInterchange profile.
-- Viewpoint and ViewpointGroup descriptions together build simple menu/submenu lists for simple user navigation.
+- Viewpoint and ViewpointGroup descriptions together build simple menu/submenu lists for simple user navigation. ViewpointGroup is not an X3DGroupingNode, and can only contain a Metadata* node, Viewpoint, OrthoViewpoint, GeoViewpoint and other ViewpointGroup nodes.
 
-## External Links
+## See Also
 
-- [X3D Specification of ViewpointGroup](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/navigation.html#ViewpointGroup){:target="_blank"}
+- [X3D Specification of ViewpointGroup node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/navigation.html#ViewpointGroup){:target="_blank"}