x_ite 8.8.7 → 8.9.0

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

@@ -1,6 +1,6 @@
 ---
 title: GeoLocation
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Geospatial
 categories: [components, Geospatial]
 tags: [GeoLocation, Geospatial]
@@ -15,7 +15,7 @@ tags: [GeoLocation, Geospatial]
 
 GeoLocation positions a regular X3D model onto earth's surface. GeoLocation can contain children and GeoOrigin nodes.
 
-The GeoLocation node belongs to the **Geospatial** component and its default container field is *children.* It is available since X3D version 3.0 or later.
+The GeoLocation node belongs to the **Geospatial** component and its default container field is *children.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -30,38 +30,58 @@ The GeoLocation node belongs to the **Geospatial** component and its default con
 
 ### 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).
+
 ### SFVec3d [in, out] **geoCoords** 0 0 0 <small>(-∞,∞)</small>
 
-Input/Output field geoCoords.
+Geographic location (specified in current geoSystem coordinates) for children geometry (specified in relative coordinate system, in meters).
+
+#### Hint
+
+- [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'/>`
 
 ### 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
 
@@ -75,36 +95,54 @@ 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 [in] **addChildren**
 
-Input field addChildren.
+Input field *addChildren*.
 
 ### MFNode [in] **removeChildren**
 
-Input field removeChildren.
+Input field *removeChildren*.
 
 ### MFNode [in, out] **children** [ ] <small>[X3DChildNode]</small>
 
-Input/Output field children.
+Grouping nodes contain an ordered list of *children* nodes.
+
+#### 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.
+- 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
 
-### Hint
+### Hints
 
-- Include `<component name='Geospatial' level='1'/>`
+- [X3D for Advanced Modeling (X3D4AM) slideset](https://x3dgraphics.com/slidesets/X3dForAdvancedModeling/GeospatialComponentX3dEarth.pdf){:target="_blank"}
+- GeoLocation adjusts orientation of children models appropriately: +Y axis is up direction for that local area (i.e. normal to tangent plane on the geospatial ellipsoid), -Z axis points towards north pole, and +X axis points east.
 
-### Warning
+### Warnings
 
-- Avoid having GeoLocation or GeoTransform as a parent of ancestor node, since multiple geospatial transformations then occur with unpredictable results.
+- Requires X3D `profile='Full'` or else include `<component name='Geospatial' level='1'/>`
+- Avoid having GeoLocation or GeoTransform as a parent or ancestor node of each other, since multiple geospatial transformations then occur with unpredictable results.
 
-## External Links
+## See Also
 
-- [X3D Specification of GeoLocation](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/geospatial.html#GeoLocation){:target="_blank"}
+- [X3D Specification of GeoLocation node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/geospatial.html#GeoLocation){:target="_blank"}

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

@@ -1,6 +1,6 @@
 ---
 title: GeoMetadata
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Geospatial
 categories: [components, Geospatial]
 tags: [GeoMetadata, Geospatial]
@@ -15,7 +15,7 @@ tags: [GeoMetadata, Geospatial]
 
 GeoMetadata includes a generic subset of metadata about the geographic data.
 
-The GeoMetadata node belongs to the **Geospatial** component and its default container field is *children.* It is available since X3D version 3.0 or later.
+The GeoMetadata node belongs to the **Geospatial** component and its default container field is *children.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -32,15 +32,19 @@ The GeoMetadata node belongs to the **Geospatial** component and its default con
 
 ### 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] **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>
@@ -49,15 +53,14 @@ Hypertext link to an external, complete metadata description.
 
 #### Hints
 
-- MFString arrays can have multiple values, so separate each individual string by quote marks "https://www.web3d.org" "https://www.web3d.org/about" "etc." XML encoding for quotation mark " is &amp;quot; (which is called a character entity). Can replace embedded blank(s) in url queries with %20 for each blank character.
+- 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"}
 
 #### Warning
 
-- 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 and other operating systems are not.
-
-#### See Also
-
-- [X3D Scene Authoring Hints, urls](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#urls){:target="_blank"}
+- 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>
 
@@ -86,26 +89,29 @@ Hypertext link to an external, complete metadata description.
 
 ### MFString [in, out] **summary** [ ]
 
-The summary string array contains a set of keyword/value pairs, with each keyword and its subsequent value contained in separate strings.
+The *summary* string array contains a set of keyword/value pairs, with each keyword and its subsequent value contained in separate strings.
 
 #### Hints
 
-- Example `<GeoMetadata summary=' "title" "San Francisco, California USA" '/>`. There should always be an even (or zero) number of strings to match key-value pairs.
+- Example `<GeoMetadata summary=' "title" "San Francisco, California USA" '/>`.
+- [Table 25.5, GeoMetadata keywords and values](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/geospatial.html#t-keywordsandvalues){:target="_blank"}
+- There should always be an even (or zero) number of strings to match key-value paired strings.
 
-#### See Also
+### MFNode [in, out] **data** [ ]
 
-- [Table 25.5, GeoMetadata keywords and values](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/geospatial.html#t-keywordsandvalues){:target="_blank"}
+#IMPLIED] DEF list of all nodes that implement this *data*. If no specific geospatial nodes are identified, then this GeoMetadata node pertains to entire scene.
 
-### MFNode [in, out] **data** [ ]
+## Advisories
 
-DEF list of all nodes that implement this data. If no specific geospatial nodes are identified, then this GeoMetadata node pertains to entire scene.
+### Hints
 
-## Description
+- [X3D for Advanced Modeling (X3D4AM) slideset](https://x3dgraphics.com/slidesets/X3dForAdvancedModeling/GeospatialComponentX3dEarth.pdf){:target="_blank"}
+- [When parent node is LoadSensor, apply `containerField='children'` (X3Dv4) or `containerField='watchList'` (X3Dv3).](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#fieldNameChanges){:target="_blank"}
 
-### Hint
+### Warning
 
-- Include `<component name='Geospatial' level='1'/>`
+- Requires X3D `profile='Full'` or else include `<component name='Geospatial' level='1'/>`
 
-## External Links
+## See Also
 
-- [X3D Specification of GeoMetadata](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/geospatial.html#GeoMetadata){:target="_blank"}
+- [X3D Specification of GeoMetadata node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/geospatial.html#GeoMetadata){:target="_blank"}

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

@@ -1,6 +1,6 @@
 ---
 title: GeoOrigin
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Geospatial
 categories: [components, Geospatial]
 tags: [GeoOrigin, Geospatial]
@@ -13,9 +13,9 @@ tags: [GeoOrigin, Geospatial]
 
 ## Overview
 
-GeoOrigin specifies a local coordinate system for increased geographic precision.
+GeoOrigin specifies local geospatial coordinate system for parent node, enabling increased geographic precision during scene rendering (by mitigating potential floating-point roundoff errors). GeoOrigin can be contained by other Geospatial component nodes, typically via DEF/USE to ensure consistency.
 
-The GeoOrigin node belongs to the **Geospatial** component and its default container field is *geoOrigin.* It is available since X3D version 3.0 or later.
+The GeoOrigin node belongs to the **Geospatial** component and its default container field is *geoOrigin.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -28,42 +28,57 @@ The GeoOrigin node belongs to the **Geospatial** 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"}
 
 ### 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.
 
-#### Warning
+#### Hints
 
-- Deprecated values are GDC (use GD) and GCC (use GC).
+- [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"}
 
-#### See Also
+#### Warning
 
-- [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"}
-- [UTM is Universal Transverse Mercator coordinate system](https://en.wikipedia.org/wiki/Universal_Transverse_Mercator_coordinate_system){:target="_blank"}
+- Deprecated values are GDC (replaced by GD) and GCC (replaced by GC).
 
 ### SFVec3d [in, out] **geoCoords** 0 0 0 <small>(-∞,∞)</small>
 
-Input/Output field geoCoords.
+Defines absolute geographic location (and implicit local coordinate frame).
+
+#### Hint
+
+- [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'/>`
 
 ### SFBool [ ] **rotateYUp** FALSE
 
-Whether to rotate coordinates of nodes using this GeoOrigin so that local-up direction aligns with VRML Y axis rotateYUp false means local up-direction is relative to planet surface rotateYUp true allows proper operation of NavigationInfo modes FLY, WALK.
+Whether to rotate coordinates of nodes using this GeoOrigin so that local-up direction aligns with VRML Y axis *rotateYUp* false means local up-direction is relative to planet surface *rotateYUp* true allows proper operation of NavigationInfo modes FLY, WALK.
 
-## Description
+## Advisories
 
 ### Hints
 
-- Only one coordinate system allowed per scene thus USE-ing only one GeoOrigin node per scene is recommended.
-- Include `<component name='Geospatial' level='1'/>`
+- Only one geospatial coordinate system is allowed per scene, thus DEF-ing and later USE-ing only one GeoOrigin node per scene is recommended.
+- [X3D for Advanced Modeling (X3D4AM) slideset](https://x3dgraphics.com/slidesets/X3dForAdvancedModeling/GeospatialComponentX3dEarth.pdf){:target="_blank"}
 - GeoOrigin is likely to be restored in X3D v4.0 for special use on devices with limited floating-point resolution.
+- [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
+### Warnings
 
-- GeoOrigin is deprecated and discouraged (but nevertheless allowed) in X3D v3.3.
+- Requires X3D `profile='Full'` or else include `<component name='Geospatial' level='1'/>`
+- GeoOrigin is deprecated, discouraged and not legal in X3D v3.3. GeoOrigin can be ignored in X3D v3.2 and below.
+- XML validation requires placement as first child node following contained metadata nodes (if any).
 
-## External Links
+## See Also
 
-- [X3D Specification of GeoOrigin](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/geospatial.html#GeoOrigin){:target="_blank"}
+- [X3D Specification of GeoOrigin node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/geospatial.html#GeoOrigin){:target="_blank"}

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

@@ -1,6 +1,6 @@
 ---
 title: GeoPositionInterpolator
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Geospatial
 categories: [components, Geospatial]
 tags: [GeoPositionInterpolator, Geospatial]
@@ -15,7 +15,7 @@ tags: [GeoPositionInterpolator, Geospatial]
 
 GeoPositionInterpolator animates objects within a geographic coordinate system. GeoPositionInterpolator can contain a GeoOrigin node.
 
-The GeoPositionInterpolator node belongs to the **Geospatial** component and its default container field is *children.* It is available since X3D version 3.0 or later.
+The GeoPositionInterpolator node belongs to the **Geospatial** component and its default container field is *children.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -30,41 +30,70 @@ The GeoPositionInterpolator node belongs to the **Geospatial** component and its
 
 ### 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).
+
 ### SFFloat [in] **set_fraction** <small>(-∞,∞)</small>
 
 *set_fraction* selects input key for corresponding keyValue output.
 
-### MFFloat [in, out] **key** [ ] <small>(-∞,∞)</small>
+#### Hint
 
-Definition parameters for linear-interpolation function time intervals, in increasing order and corresponding to keyValues.
+- *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.
+
+### MFFloat [in, out] **key** [ ] <small>(-∞,∞)</small>
+
+Definition values for linear-interpolation function input intervals, listed in non-decreasing order and corresponding to a value in the keyValue array.
+
+#### 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.
 
 ### MFVec3d [in, out] **keyValue** [ ]
 
-Output values for linear interpolation, each corresponding to time-fraction keys.
+Output values for linear interpolation, each corresponding to an input-fraction value in the key array.
+
+#### Hint
+
+- [Identical adjacent entries in *keyValue* array have the effect of defining constant-value step functions.](https://en.wikipedia.org/wiki/Step_function){:target="_blank"}
 
 #### Warning
 
@@ -74,22 +103,39 @@ Output values for linear interpolation, each corresponding to time-fraction keys
 
 Linearly interpolated output value determined by current key time and corresponding keyValue pair.
 
+#### Hint
+
+- X3D players might not send unchanging intermediate values, thus avoiding excessive superfluous events that have no effect.
+
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
+
 ### SFVec3d [out] **geovalue_changed**
 
 Interpolated coordinate in the geographic coordinate system specified by geoSystem
 
 #### Hint
 
-- Include `<component name='Geospatial' level='1'/>`
+- [X3D for Advanced Modeling (X3D4AM) slideset](https://x3dgraphics.com/slidesets/X3dForAdvancedModeling/GeospatialComponentX3dEarth.pdf){:target="_blank"}
 
-## Description
+#### Warnings
+
+- Requires X3D `profile='Full'` or else include `<component name='Geospatial' level='1'/>`
+- 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
 
 - 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='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 GeoPositionInterpolator](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/geospatial.html#GeoPositionInterpolator){:target="_blank"}
+- [X3D Specification of GeoPositionInterpolator node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/geospatial.html#GeoPositionInterpolator){:target="_blank"}