x_ite 8.8.7 → 8.9.0

package/docs/_posts/components/Geospatial/GeoCoordinate.md

@@ -1,6 +1,6 @@
 ---
 title: GeoCoordinate
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Geospatial
 categories: [components, Geospatial]
 tags: [GeoCoordinate, Geospatial]
@@ -15,7 +15,7 @@ tags: [GeoCoordinate, Geospatial]
 
 GeoCoordinate builds geometry as a set of geographic 3D coordinates. These are transformed into a geocentric, curved-earth representation. GeoCoordinate is only used by IndexedFaceSet, IndexedLineSet, LineSet and PointSet. GeoCoordinate can contain a GeoOrigin node.
 
-The GeoCoordinate node belongs to the **Geospatial** component and its default container field is *coord.* It is available since X3D version 3.0 or later.
+The GeoCoordinate node belongs to the **Geospatial** component and its default container field is *coord.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -30,36 +30,52 @@ The GeoCoordinate node belongs to the **Geospatial** component and its default c
 
 ### 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"}
 
 ### SFNode [ ] **geoOrigin** NULL <small>[GeoOrigin] (deprecated)</small>
 
-Field geoOrigin.
+Single contained GeoOrigin node that can specify a local coordinate frame for extended precision.
 
-### MFString [ ] **geoSystem** [ "GD", "WE" ]
+#### Hint
 
-Identifies spatial reference frame: Geodetic (GD), Geocentric (GC), Universal Transverse Mercator (UTM). Supported values: "GD" "UTM" or "GC" followed by additional quoted string parameters as appropriate for the type.
+- [X3D Architecture 25.2.5 Dealing with high-precision coordinates](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/geospatial.html#high-precisioncoords){:target="_blank"}
 
 #### Warning
 
-- Deprecated values are GDC (use GD) and GCC (use GC).
+- XML validation requires placement as first child node following contained metadata nodes (if any).
 
-#### See Also
+### MFString [ ] **geoSystem** [ "GD", "WE" ]
+
+Identifies spatial reference frame: Geodetic (GD), Geocentric (GC), Universal Transverse Mercator (UTM). Supported values: "GD" "UTM" or "GC" followed by additional quoted string parameters as appropriate for the type.
 
-- [See X3D Specification 25.2.2 Spatial reference frames](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/geospatial.html#Spatialreferenceframes){:target="_blank"}
-- [See X3D Specification 25.2.4 Specifying geospatial coordinates](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/geospatial.html#Specifyinggeospatialcoords){:target="_blank"}
+#### Hints
+
+- [X3D Architecture 25.2.2 Spatial reference frames](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/geospatial.html#Spatialreferenceframes){:target="_blank"}
+- [X3D Architecture 25.2.4 Specifying geospatial coordinates](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/geospatial.html#Specifyinggeospatialcoords){:target="_blank"}
 - [UTM is Universal Transverse Mercator coordinate system](https://en.wikipedia.org/wiki/Universal_Transverse_Mercator_coordinate_system){:target="_blank"}
 
+#### Warning
+
+- Deprecated values are GDC (replaced by GD) and GCC (replaced by GC).
+
 ### MFVec3d [in, out] **point** [ ] <small>(-∞,∞)</small>
 
 *point* contains a set of actual 3D geographic coordinates, provided in geoSystem format can split strings if desired: "x1 y1 z1 x2 y2 z2" or "x1 y1 z1", "x2 y2 z2"
 
-## Description
+## Advisories
 
 ### Hint
 
-- Include `<component name='Geospatial' level='1'/>`
+- [X3D for Advanced Modeling (X3D4AM) slideset](https://x3dgraphics.com/slidesets/X3dForAdvancedModeling/GeospatialComponentX3dEarth.pdf){:target="_blank"}
+
+### Warning
+
+- Requires X3D `profile='Full'` or else include `<component name='Geospatial' level='1'/>`
 
-## External Links
+## See Also
 
-- [X3D Specification of GeoCoordinate](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/geospatial.html#GeoCoordinate){:target="_blank"}
+- [X3D Specification of GeoCoordinate node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/geospatial.html#GeoCoordinate){:target="_blank"}

package/docs/_posts/components/Geospatial/GeoElevationGrid.md

@@ -1,6 +1,6 @@
 ---
 title: GeoElevationGrid
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Geospatial
 categories: [components, Geospatial]
 tags: [GeoElevationGrid, Geospatial]
@@ -15,7 +15,7 @@ tags: [GeoElevationGrid, Geospatial]
 
 GeoElevationGrid is a geometry node defining a rectangular height field, with default values for a 1m by 1m square at height 0. Vertices corresponding to GeoElevationGrid height values define quadrilaterals, which are placed above or below a curved geospatial surface using geographic coordinates.
 
-The GeoElevationGrid node belongs to the **Geospatial** component and its default container field is *geometry.* It is available since X3D version 3.0 or later.
+The GeoElevationGrid node belongs to the **Geospatial** component and its default container field is *geometry.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -29,26 +29,38 @@ The GeoElevationGrid node belongs to the **Geospatial** component and its defaul
 
 ### 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"}
 
 ### SFNode [ ] **geoOrigin** NULL <small>[GeoOrigin] (deprecated)</small>
 
-Field geoOrigin.
+Single contained GeoOrigin node that can specify a local coordinate frame for extended precision.
 
-### MFString [ ] **geoSystem** [ "GD", "WE" ]
+#### Hint
 
-Identifies spatial reference frame: Geodetic (GD), Geocentric (GC), Universal Transverse Mercator (UTM). Supported values: "GD" "UTM" or "GC" followed by additional quoted string parameters as appropriate for the type.
+- [X3D Architecture 25.2.5 Dealing with high-precision coordinates](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/geospatial.html#high-precisioncoords){:target="_blank"}
 
 #### Warning
 
-- Deprecated values are GDC (use GD) and GCC (use GC).
+- XML validation requires placement as first child node following contained metadata nodes (if any).
+
+### MFString [ ] **geoSystem** [ "GD", "WE" ]
+
+Identifies spatial reference frame: Geodetic (GD), Geocentric (GC), Universal Transverse Mercator (UTM). Supported values: "GD" "UTM" or "GC" followed by additional quoted string parameters as appropriate for the type.
 
-#### See Also
+#### Hints
 
-- [See X3D Specification 25.2.2 Spatial reference frames](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/geospatial.html#Spatialreferenceframes){:target="_blank"}
-- [See X3D Specification 25.2.4 Specifying geospatial coordinates](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/geospatial.html#Specifyinggeospatialcoords){:target="_blank"}
+- [X3D Architecture 25.2.2 Spatial reference frames](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/geospatial.html#Spatialreferenceframes){:target="_blank"}
+- [X3D Architecture 25.2.4 Specifying geospatial coordinates](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/geospatial.html#Specifyinggeospatialcoords){:target="_blank"}
 - [UTM is Universal Transverse Mercator coordinate system](https://en.wikipedia.org/wiki/Universal_Transverse_Mercator_coordinate_system){:target="_blank"}
 
+#### Warning
+
+- Deprecated values are GDC (replaced by GD) and GCC (replaced by GC).
+
 ### SFVec3d [ ] **geoGridOrigin** 0 0 0 <small>(-∞,∞)</small>
 
 Geographic coordinate for southwest (lower-left) corner of height dataset.
@@ -59,7 +71,11 @@ Number of elements in the height array along east-west X direction.
 
 #### Hint
 
-- Total horizontal x-axis distance equals (xDimension-1) \* xSpacing.
+- Total horizontal x-axis distance equals (*xDimension*-1) * xSpacing.
+
+#### Warning
+
+- *xDimension* \< 2 means that GeoElevationGrid contains no quadrilaterals.
 
 ### SFInt32 [ ] **zDimension** 0 <small>(0,∞)</small>
 
@@ -67,7 +83,11 @@ Number of elements in the height array along north-south Z direction.
 
 #### Hint
 
-- Total lateral z-axis distance equals (zDimension-1) \* zSpacing.
+- Total lateral z-axis distance equals (*zDimension*-1) * zSpacing.
+
+#### Warning
+
+- *zDimension* \< 2 means that GeoElevationGrid contains no quadrilaterals.
 
 ### SFDouble [ ] **xSpacing** 1 <small>[0,∞)</small>
 
@@ -75,7 +95,8 @@ Distance between grid-array vertices along east-west X direction.
 
 #### Hints
 
-- When geoSystem is GDC, xSpacing is number of degrees of longitude. When geoSystem is UTM, xSpacing is number of eastings (meters).
+- When geoSystem is GDC, *xSpacing* is number of degrees of longitude.
+- When geoSystem is UTM, *xSpacing* is number of eastings (meters).
 
 ### SFDouble [ ] **zSpacing** 1 <small>[0,∞)</small>
 
@@ -83,7 +104,8 @@ Distance between grid-array vertices along north-south Z direction.
 
 #### Hints
 
-- When geoSystem is GDC, zSpacing is number of degrees of latitude. When geoSystem is UTM, zSpacing is number of northings (meters).
+- When geoSystem is GDC, *zSpacing* is number of degrees of latitude.
+- When geoSystem is UTM, *zSpacing* is number of northings (meters).
 
 ### SFFloat [in, out] **yScale** 1 <small>[0,∞)</small>
 
@@ -91,11 +113,13 @@ Vertical exaggeration of displayed data produced from the height array.
 
 ### SFBool [ ] **solid** TRUE
 
-Setting solid true means draw only one side of polygons (backface culling on), setting solid false means draw both sides of polygons (backface culling off).
+Setting *solid* true means draw only one side of polygons (backface culling on), setting *solid* false means draw both sides of polygons (backface culling off).
 
-#### Hint
+#### Hints
 
-- If in doubt, use solid='false' for maximum visibility.
+- Mnemonic "this geometry is *solid* like a brick" (you don't render the inside of a brick).
+- If in doubt, use *solid*='false' for maximum visibility.
+- (X3D version 4.0 draft) accessType relaxed to inputOutput in order to support animation and visualization.
 
 #### Warning
 
@@ -103,39 +127,49 @@ Setting solid true means draw only one side of polygons (backface culling on), s
 
 ### SFBool [ ] **ccw** TRUE
 
-*ccw* = counterclockwise: ordering of vertex coordinates orientation.
+*ccw* defines clockwise/counterclockwise ordering of vertex coordinates, which in turn defines front/back orientation of polygon normals according to Right-Hand Rule (RHR).
 
-#### Hint
+#### Hints
+
+- A good debugging technique for problematic polygons is to try changing the value of *ccw*, which can reverse solid effects (single-sided backface culling) and normal-vector direction.
+- [Clockwise](https://en.wikipedia.org/wiki/Clockwise){:target="_blank"}
 
-- *ccw* false can reverse solid (backface culling) and normal-vector orientation.
+#### Warning
+
+- Consistent and correct ordering of left-handed or right-handed point sequences is important throughout the coord array of point values.
 
 ### SFDouble [ ] **creaseAngle** 0 <small>[0,∞)</small>
 
-*creaseAngle* defines angle (in radians) for determining whether adjacent polygons are drawn with sharp edges or smooth shading. If angle between normals of two adjacent polygons is less than creaseAngle, smooth shading is rendered across the shared line segment.
+*creaseAngle* defines angle (in radians) for determining whether adjacent polygons are drawn with sharp edges or smooth shading. If angle between normals of two adjacent polygons is less than *creaseAngle*, smooth shading is rendered across the shared line segment.
 
-#### Hint
+#### Hints
 
-- CreaseAngle=0 means render all edges sharply, creaseAngle=3.14159 means render all edges smoothly.
+- *creaseAngle*=0 means render all edges sharply, *creaseAngle*=3.14159 means render all edges smoothly.
+- [Radian units for angular measure](https://en.wikipedia.org/wiki/Radian){:target="_blank"}
 
 #### Warning
 
-- Note type double, unlike ElevationGrid creaseAngle.
+- Note type double, unlike ElevationGrid *creaseAngle*.
 
 ### SFBool [ ] **colorPerVertex** TRUE
 
-Whether Color node color values are applied to each vertex (true) or per quadrilateral (false).
+Whether Color node color values are applied to each point vertex (true) or per quadrilateral (false).
 
-#### See Also
+#### Hint
 
 - [X3D Scene Authoring Hints, Color](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color){:target="_blank"}
 
 ### SFBool [ ] **normalPerVertex** TRUE
 
-Whether Normal node vector values are applied to each vertex (true) or per quadrilateral (false).
+Whether Normal node vector values are applied to each point vertex (true) or per quadrilateral (false).
+
+#### Hint
+
+- If no child Normal node is provided, the X3D browser shall automatically generate normals, using creaseAngle to determine smoothed shading across shared vertices.
 
 ### SFNode [in, out] **color** NULL <small>[X3DColorNode]</small>
 
-Single contained Color or ColorRGBA node that can specify color values applied to corresponding vertices according to colorIndex and colorPerVertex fields.
+Single contained Color or ColorRGBA node that can specify *color* values applied to corresponding vertices according to colorPerVertex field.
 
 ### SFNode [in, out] **texCoord** NULL <small>[X3DTextureCoordinateNode]</small>
 
@@ -149,32 +183,43 @@ Single contained Normal node that can specify perpendicular vectors for correspo
 
 - Useful for special effects. Normal vector computation by 3D graphics hardware is quite fast so adding normals to a scene is typically unnecessary.
 
+#### Warning
+
+- *normal* vectors increase file size, typically doubling geometry definitions.
+
 ### MFDouble [in, out] **height** [ 0, 0 ] <small>(-∞,∞)</small>
 
-Contains xDimension rows \* zDimension columns floating-point values for elevation above ellipsoid.
+Contains xDimension rows * zDimension columns floating-point values for elevation above ellipsoid.
 
 #### Hints
 
-- Height array values are in row-major order from west to east, south to north. GeoGridOrigin is in southwest (lower-left) corner of height dataset.
+- *height* array values are in row-major order from west to east, south to north.
+- GeoGridOrigin is in southwest (lower-left) corner of *height* dataset.
+
+#### Warning
+
+- *height* array values are not retained or available at run time since a browser is permitted to condense geometry.
 
-## Description
+## Advisories
 
 ### Hints
 
-- The height array defines (xDimension-1)\*(zDimension-1) quadrilaterals.
+- The height array defines (xDimension-1)*(zDimension-1) quadrilaterals.
 - Positive direction for normal of each triangle is on same side of the quadrilateral. Triangles are defined either counterclockwise or clockwise depending on value of ccw field.
-- GeoElevationGrid can contain GeoOrigin, Color/ColorRGBA, Normal and TextureCoordinate nodes.
+- GeoElevationGrid can contain GeoOrigin, Color or ColorRGBA, Normal and TextureCoordinate nodes.
 - Insert a Shape node before adding geometry or Appearance.
-- Include `<component name='Geospatial' level='1'/>`
+- [X3D for Advanced Modeling (X3D4AM) slideset](https://x3dgraphics.com/slidesets/X3dForAdvancedModeling/GeospatialComponentX3dEarth.pdf){:target="_blank"}
 
-### Warning
+### Warnings
 
 - Generated quadrilaterals can be nonplanar. Tessellation splits quadrilaterals into triangles along seam starting at initial vertex of the quadrilateral and proceeding to opposite vertex.
+- Requires X3D `profile='Full'` or else include `<component name='Geospatial' level='1'/>`
+- Avoid having GeoLocation or GeoTransform as a parent or ancestor node of GeoElevationGrid, since multiple geospatial transformations then occur with unpredictable results.
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/Geospatial/GeoElevationGrid/GeoElevationGrid.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of GeoElevationGrid](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/geospatial.html#GeoElevationGrid){:target="_blank"}
+- [X3D Specification of GeoElevationGrid node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/geospatial.html#GeoElevationGrid){:target="_blank"}

package/docs/_posts/components/Geospatial/GeoLOD.md

@@ -1,6 +1,6 @@
 ---
 title: GeoLOD
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Geospatial
 categories: [components, Geospatial]
 tags: [GeoLOD, Geospatial]
@@ -15,7 +15,7 @@ tags: [GeoLOD, Geospatial]
 
 GeoLOD provides quadtree level-of-detail loading/unloading for multi-resolution terrains. GeoLOD can contain children and GeoOrigin nodes.
 
-The GeoLOD node belongs to the **Geospatial** component and its default container field is *children.* It is available since X3D version 3.0 or later.
+The GeoLOD node belongs to the **Geospatial** component and its default container field is *children.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -31,29 +31,45 @@ The GeoLOD node belongs to the **Geospatial** 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"}
 
 ### SFNode [ ] **geoOrigin** NULL <small>[GeoOrigin] (deprecated)</small>
 
-Field geoOrigin.
+Single contained GeoOrigin node that can specify a local coordinate frame for extended precision.
 
-### MFString [ ] **geoSystem** [ "GD", "WE" ]
+#### Hint
 
-Identifies spatial reference frame: Geodetic (GD), Geocentric (GC), Universal Transverse Mercator (UTM). Supported values: "GD" "UTM" or "GC" followed by additional quoted string parameters as appropriate for the type.
+- [X3D Architecture 25.2.5 Dealing with high-precision coordinates](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/geospatial.html#high-precisioncoords){:target="_blank"}
 
 #### Warning
 
-- Deprecated values are GDC (use GD) and GCC (use GC).
+- XML validation requires placement as first child node following contained metadata nodes (if any).
 
-#### See Also
+### MFString [ ] **geoSystem** [ "GD", "WE" ]
 
-- [See X3D Specification 25.2.2 Spatial reference frames](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/geospatial.html#Spatialreferenceframes){:target="_blank"}
-- [See X3D Specification 25.2.4 Specifying geospatial coordinates](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/geospatial.html#Specifyinggeospatialcoords){:target="_blank"}
+Identifies spatial reference frame: Geodetic (GD), Geocentric (GC), Universal Transverse Mercator (UTM). Supported values: "GD" "UTM" or "GC" followed by additional quoted string parameters as appropriate for the type.
+
+#### Hints
+
+- [X3D Architecture 25.2.2 Spatial reference frames](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/geospatial.html#Spatialreferenceframes){:target="_blank"}
+- [X3D Architecture 25.2.4 Specifying geospatial coordinates](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/geospatial.html#Specifyinggeospatialcoords){:target="_blank"}
 - [UTM is Universal Transverse Mercator coordinate system](https://en.wikipedia.org/wiki/Universal_Transverse_Mercator_coordinate_system){:target="_blank"}
 
+#### Warning
+
+- Deprecated values are GDC (replaced by GD) and GCC (replaced by GC).
+
 ### MFString [ ] **rootUrl** [ ] <small>[URI]</small>
 
-Use either rootNode or rootUrl to specify root geometry, not both.
+Url for scene providing geometry for the root tile.
+
+#### Warning
+
+- Either rootNode or *rootUrl* can specify root tile, but specifying both is an error.
 
 ### MFString [ ] **child1Url** [ ] <small>[URI]</small>
 
@@ -73,28 +89,32 @@ Quadtree geometry loaded when viewer is within range.
 
 ### SFVec3d [ ] **center** 0 0 0 <small>(-∞,∞)</small>
 
-Viewer range from geographic-coordinates center triggers quadtree loading/unloading.
+Viewer range from geographic-coordinates *center* triggers quadtree loading/unloading.
 
 ### SFFloat [ ] **range** 10 <small>[0,∞)</small>
 
-Viewer range from geographic-coordinates center triggers quadtree loading/unloading.
+Viewer *range* from geographic-coordinates center triggers quadtree loading/unloading.
 
 #### Hint
 
-- Not setting range values indicates that level switching can be optimized automatically based on performance.
+- Not setting *range* values indicates that level switching can be optimized automatically based on performance.
 
 ### SFInt32 [out] **level_changed**
 
-Output field level_changed.
+Output event that reports when the new children outputOnly event is generated, with value 0 or 1, where 0 indicates the rootNode field and 1 indicates the nodes specified by the child1Url, child2Url, child3Url, and child4Url fields.
+
+#### 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 [in, out] **visible** TRUE
 
 Whether or not renderable content within this node is visually displayed.
 
-#### Hint
+#### Hints
 
-- The visible field has no effect on animation behaviors, event passing or other non-visual characteristics.
-- Content must be visible to be collidable and to be pickable.
+- The *visible* field has no effect on animation behaviors, event passing or other non-visual characteristics.
+- Content must be *visible* to be collidable and to be pickable.
 
 ### SFBool [in, out] **bboxDisplay** FALSE
 
@@ -108,38 +128,57 @@ Whether to display bounding box for associated geometry, aligned with world coor
 
 Bounding box size is usually omitted, and can easily be calculated automatically by an X3D player at scene-loading time with minimal computational cost. Bounding box size can also be defined as an optional authoring hint that suggests an optimization or constraint.
 
-#### Hint
+#### Hints
 
 - Can be useful for collision computations or inverse-kinematics (IK) engines.
+- Precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
+- [X3D Architecture, 10.2.2 Bounding boxes](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/grouping.html#BoundingBoxes){:target="_blank"}
+- [X3D Architecture, 10.3.1 X3DBoundedObject](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/grouping.html#X3DBoundedObject){:target="_blank"}
 
 ### SFVec3f [ ] **bboxCenter** 0 0 0 <small>(-∞,∞)</small>
 
-Bounding box center: optional hint for position offset from origin of local coordinate system.
+Bounding box center accompanies bboxSize and provides an optional hint for bounding box position offset from origin of local coordinate system.
+
+#### Hints
+
+- Precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
+- [X3D Architecture, 10.2.2 Bounding boxes](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/grouping.html#BoundingBoxes){:target="_blank"}
+- [X3D Architecture, 10.3.1 X3DBoundedObject](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/grouping.html#X3DBoundedObject){:target="_blank"}
 
 ### MFNode [ ] **rootNode** [ ] <small>[X3DChildNode]</small>
 
-Field rootNode.
+Geometry for the root tile.
+
+#### Warning
+
+- Either *rootNode* or rootUrl can specify root tile, but specifying both is an error.
 
 ### MFNode [out] **children**
 
-Output field children.
+The outputOnly *children* field exposes a portion of the scene graph for the currently loaded set of nodes. The value returned as an event is an MFNode containing the currently selected tile. This will either be the node specified by the rootNode field or the nodes specified by the child1Url, child2Url, child3Url, and child4Url fields. The GeoLOD node shall generate a new *children* output event each time the scene graph is changed (EXAMPLE whenever nodes are loaded or unloaded).
+
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
 
-## Description
+## Advisories
 
 ### Hints
 
 - Children nodes expose the scene graph for the currently loaded set of nodes.
 - RootNode specifies the geometry of the root tile.
-- Include `<component name='Geospatial' level='1'/>`
+- [X3D for Advanced Modeling (X3D4AM) slideset](https://x3dgraphics.com/slidesets/X3dForAdvancedModeling/GeospatialComponentX3dEarth.pdf){:target="_blank"}
 
-### Warning
+### Warnings
 
 - Do not use rootUrl and rootNode simultaneously, since each specifies the root tile.
+- Requires X3D `profile='Full'` or else include `<component name='Geospatial' level='1'/>`
+- Nested LOD (and/or GeoLOD) nodes with overlapping range intervals can lead to unexpected or undefined behavior.
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/Geospatial/GeoLOD/GeoLOD.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of GeoLOD](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/geospatial.html#GeoLOD){:target="_blank"}
+- [X3D Specification of GeoLOD node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/geospatial.html#GeoLOD){:target="_blank"}