x_ite 8.8.7 → 8.9.1

package/docs/_posts/components/HAnim/HAnimSite.md

@@ -1,6 +1,6 @@
 ---
 title: HAnimSite
-date: 2022-01-07
+date: 2023-01-07
 nav: components-HAnim
 categories: [components, HAnim]
 tags: [HAnimSite, HAnim]
@@ -13,9 +13,9 @@ tags: [HAnimSite, HAnim]
 
 ## Overview
 
-An HAnimSite node serves three purposes: (a) define an "end effector" location which can be used by an inverse kinematics system, (b) define an attachment point for accessories such as jewelry and clothing, and (c) define a location for a virtual camera in the reference frame of an HAnimSegment (such as a view "through the eyes" of the humanoid for use in multi-user worlds).
+An HAnimSite node serves three purposes: (a) define an "end effector" location which can be used by an inverse kinematics system, (b) define an attachment point for accessories such as jewelry and clothing, and (c) define a location for a Viewpoint virtual camera in the reference frame of an HAnimSegment (such as a view "through the eyes" of the humanoid for use in multi-user worlds).
 
-The HAnimSite node belongs to the **HAnim** component and its default container field is *children.* It is available since X3D version 3.0 or later.
+The HAnimSite node belongs to the **HAnim** component and its default container field is *children.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -30,44 +30,59 @@ The HAnimSite node belongs to the **HAnim** component and its default container
 
 ### SFNode [in, out] **metadata** NULL <small>[X3DMetadataObject]</small>
 
-Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.
+Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.
+
+#### Hint
+
+- [X3D Architecture 7.2.4 Metadata](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/core.html#Metadata){:target="_blank"}
 
 ### SFString [in, out] **description** ""
 
-Author-provided prose that describes intended purpose of the url asset.
+Author-provided prose that describes intended purpose of this node.
 
 #### Hint
 
-- Many XML tools substitute XML character references for special characters automatically if needed within an attribute value (such as &amp;#38; for & ampersand character, or &amp;#34; for " quotation-mark character).
+- Many XML tools substitute XML character references for special characters automatically if needed within an attribute value (such as &amp;#38; for &amp; ampersand character, or &amp;#34; for " quotation-mark character).
 
 ### SFString [in, out] **name** ""
 
-Unique name attribute must be defined so that HAnimSite node can be identified at run time for animation purposes.
+Unique *name* attribute must be defined so that HAnimSite node can be identified at run time for animation purposes.
 
 #### Hints
 
-- HAnimSite nodes used as end effectors have '\_tip' suffix appended to the name. HAnimSite nodes containing a Viewpoint location have '\_view' suffix appended to the name. HAnimSite nodes serving other purposes have '\_pt' suffix appended to the name. Examples: cervicale l_infraorbitale supramenton etc. as listed in HAnim Specification.
+- HAnimSite names are typically based on feature point names, though other author-defined names are also allowed.
+- Https://www.web3d.org/documents/specifications/19774/V2.0/Architecture/FeaturePoints.html
+- HAnimSite nodes used as end effectors have '_tip' suffix appended to the *name*.
+- HAnimSite nodes containing a Viewpoint location have '_view' suffix appended to the *name*.
+- HAnimSite nodes serving other purposes have '_pt' suffix appended to the *name*.
+- Additional example *name* bases (such as cervicale l_infraorbitale supramenton etc.) are listed in HAnim Specification.
+- [HAnim Specification part 1, LOA-3 default Site object translations](https://www.web3d.org/documents/specifications/19774/V2.0/Architecture/BodyDimensionsAndLOAs.html#LOA3DefaultSiteTranslations){:target="_blank"}
+- Well-defined names can simplify design and debugging through improved author understanding.
+- [X3D Scene Authoring Hints, Naming Conventions](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions){:target="_blank"}
+- [HAnim2 Names HAnim1 Alias Tables](https://www.web3d.org/x3d/content/examples/HumanoidAnimation/HAnim2NameHAnim1AliasTables.txt){:target="_blank"}
 
-#### Warning
+#### Warnings
 
-- Name is not included if this instance is a USE node.
-
-#### See Also
-
-- [HAnim Humanoid Site Names LOA-3](https://www.web3d.org/x3d/content/examples/Basic/HumanoidAnimation/tables/HAnimSiteLoa3Names19774V1.0.txt){:target="_blank"}
-- [HAnim Specification, LOA-3 default Site object translations](https://www.web3d.org/documents/specifications/19774-1/V2.0/HAnim/BodyDimensionsAndLOAs.html#LOA3DefaultSiteTranslations){:target="_blank"}
+- *name* prefix must match ancestor HAnimHumanoid *name* followed by underscore character, if more than one humanoid appears within a scene file. For example, 'Nancy_' prepended before location *name*.
+- *name* field is not included if this instance is a USE node, in order to avoid potential mismatches.
+- HAnimSite *name* must end in '_tip' or '_view' or '_pt' suffix.
 
 ### SFVec3f [in, out] **translation** 0 0 0 <small>(-∞,∞)</small>
 
 Position of children relative to local coordinate system.
 
+#### Hints
+
+- Since default pose faces along +Z axis, -x values are right side and +x values are left side within HAnimHumanoid.
+- Center field indicates default origin relative to overall humanoid body and is rarely modified. For HAnimSite animation, ROUTE position-change events to *translation* field instead.
+
 ### SFRotation [in, out] **rotation** 0 0 1 0 <small>(-∞,∞) or [-1,1]</small>
 
 Orientation of children relative to local coordinate system.
 
 ### SFVec3f [in, out] **scale** 1 1 1 <small>(0,∞)</small>
 
-Non-uniform x-y-z scale of child coordinate system, adjusted by center and scaleOrientation.
+Non-uniform x-y-z *scale* of child coordinate system, adjusted by center and scaleOrientation.
 
 ### SFRotation [in, out] **scaleOrientation** 0 0 1 0 <small>(-∞,∞) or [-1,1]</small>
 
@@ -75,16 +90,20 @@ Preliminary rotation of coordinate system before scaling (to allow scaling aroun
 
 ### SFVec3f [in, out] **center** 0 0 0 <small>(-∞,∞)</small>
 
-Translation offset from origin of local coordinate system.
+Default location of this HAnimSite, i.e. offset of *center* from origin of local coordinate system.
+
+#### Hint
+
+- *center* field indicates default origin relative to overall humanoid body and is rarely modified. For HAnimSite animation, ROUTE position-change events to translation field instead.
 
 ### 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
 
@@ -98,36 +117,60 @@ 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.
 
-## Description
+#### 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"}
+
+## Advisories
 
 ### Hints
 
 - HAnimSite nodes are stored as children of an HAnimSegment node.
-- Include `<component name='HAnim' level='1'/>`
+- [HAnim Specification](https://www.web3d.org/documents/specifications/19774/V2.0){:target="_blank"}
+- [HAnim Specification part 1, Site](https://www.web3d.org/documents/specifications/19774/V2.0/Architecture/ObjectInterfaces.html#Site){:target="_blank"}
+- [HAnim Specification part 1, Annex B, Feature points for the human body](https://www.web3d.org/documents/specifications/19774/V2.0/Architecture/FeaturePoints.html){:target="_blank"}
+- [X3D for Advanced Modeling (X3D4AM) slideset](https://x3dgraphics.com/slidesets/X3dForAdvancedModeling/HumanoidAnimation.pdf){:target="_blank"}
+- [HAnim2 default values for Joint and Site (feature point) nodes](https://www.web3d.org/x3d/content/examples/HumanoidAnimation/HAnim2DefaultValuesJointsFeaturePoints.txt){:target="_blank"}
+
+### Warnings
+
+- Ensure that visible HAnimSite locations are not inadvertently obscured by skin animation.
+- Requires X3D `profile='Full'` or else include `<component name='HAnim' level='1'/>`
+- For X3D3 HAnim1, spelling of component name is 'H-Anim' (including hyphen).
+- The number of contained \<HAnimSite USE='*' `containerField='sites,` skeleton or viewpoints'/\> nodes at top level of HAnimHumanoid needs to match the number of corresponding HAnimSite node instances found within the preceding skeleton hierarchy.
 
-## External Links
+## See Also
 
-- [X3D Specification of HAnimSite](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/hanim.html#HAnimSite){:target="_blank"}
-- [HAnim Specification](https://www.web3d.org/documents/specifications/19774-1/V2.0/HAnim/HAnimArchitecture.html){:target="_blank"}
-- [HAnim Specification, Site](https://www.web3d.org/documents/specifications/19774-1/V2.0/HAnim/ObjectInterfaces.html#Site){:target="_blank"}
-- [HAnim Specification, Annex B, Feature points for the human body](https://www.web3d.org/documents/specifications/19774-1/V2.0/HAnim/FeaturePoints.html){:target="_blank"}
+- [X3D Specification of HAnimSite node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/hanim.html#HAnimSite){:target="_blank"}

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

@@ -1,6 +1,6 @@
 ---
 title: ColorInterpolator
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Interpolation
 categories: [components, Interpolation]
 tags: [ColorInterpolator, Interpolation]
@@ -13,9 +13,9 @@ tags: [ColorInterpolator, Interpolation]
 
 ## Overview
 
-ColorInterpolator generates a range of Color values that can be ROUTEd to a `<Color>` node's color attribute.
+ColorInterpolator generates a range of color values. Authors can ROUTE value_changed output events to various color fields of Material or Color nodes.
 
-The ColorInterpolator node belongs to the **Interpolation** component and its default container field is *children.* It is available since X3D version 2.0 or later.
+The ColorInterpolator node belongs to the **Interpolation** component and its default container field is *children.* It is available from X3D version 2.0 or higher.
 
 ## Hierarchy
 
@@ -30,23 +30,44 @@ The ColorInterpolator node belongs to the **Interpolation** component and its de
 
 ### SFNode [in, out] **metadata** NULL <small>[X3DMetadataObject]</small>
 
-Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.
+Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.
+
+#### 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 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.
 
 ### MFColor [in, out] **keyValue** [ ] <small>[0,1]</small>
 
-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
 
@@ -56,18 +77,27 @@ Output values for linear interpolation, each corresponding to time-fraction keys
 
 Linearly interpolated output value determined by current key time and corresponding keyValue pair.
 
-## Description
+#### 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.
+
+## 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.
+- [X3D Scene Authoring Hints, Color](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color){:target="_blank"}
+- [Example scenes and authoring assets](https://x3dgraphics.com/examples/X3dForWebAuthors/Chapter07EventAnimationInterpolation){:target="_blank"}
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/Interpolation/ColorInterpolator/ColorInterpolator.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of ColorInterpolator](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/interpolators.html#ColorInterpolator){:target="_blank"}
-- [X3D Scene Authoring Hints, Color](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color){:target="_blank"}
+- [X3D Specification of ColorInterpolator node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/interpolators.html#ColorInterpolator){:target="_blank"}

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

@@ -1,6 +1,6 @@
 ---
 title: CoordinateInterpolator
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Interpolation
 categories: [components, Interpolation]
 tags: [CoordinateInterpolator, Interpolation]
@@ -13,9 +13,9 @@ tags: [CoordinateInterpolator, Interpolation]
 
 ## Overview
 
-CoordinateInterpolator generates a series of Coordinate values that can be ROUTEd to a `<Coordinate>` node's 'point' attribute or another Vector3FloatArray attribute.
+CoordinateInterpolator linearly interpolates among a list of 3-tuple MFVec3f arrays, producing a single MFVec3f array that is fractional average between two nearest arrays in the list. Authors can ROUTE value_changed output events (an array of 3-tuple SFVec3f values) to a Coordinate node's point field, or to another MFVec3f field.
 
-The CoordinateInterpolator node belongs to the **Interpolation** component and its default container field is *children.* It is available since X3D version 2.0 or later.
+The CoordinateInterpolator node belongs to the **Interpolation** component and its default container field is *children.* It is available from X3D version 2.0 or higher.
 
 ## Hierarchy
 
@@ -30,47 +30,73 @@ The CoordinateInterpolator node belongs to the **Interpolation** component and i
 
 ### SFNode [in, out] **metadata** NULL <small>[X3DMetadataObject]</small>
 
-Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.
+Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.
+
+#### Hint
+
+- [X3D Architecture 7.2.4 Metadata](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/core.html#Metadata){:target="_blank"}
 
 ### SFFloat [in] **set_fraction** <small>(-∞,∞)</small>
 
 *set_fraction* selects input key for corresponding keyValue output.
 
+#### 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.
+
 ### MFFloat [in, out] **key** [ ] <small>(-∞,∞)</small>
 
-Definition parameters for linear-interpolation function time intervals, in increasing order and corresponding to keyValues.
+Definition values for linear-interpolation function input intervals, listed in non-decreasing order and corresponding to a value in the keyValue array.
 
 #### Hints
 
-- Number of keyValues must be an integer multiple of the number of keys! KeyValue/key integer multiple defines how many coordinates are sent in value_changed outputOnlys.
+- Number of keyValues must be an integer multiple of the number of keys!
+- KeyValue/*key* integer multiple defines how many coordinates are sent in value_changed outputOnlys.
+- Typical interval for values in *key* array is within range of 0 to 1, but larger intervals can be defined with arbitrary bounds.
+
+#### Warning
+
+- Values in *key* array shall be monotonically non-decreasing, meaning that each value is greater than or equal to the preceding value.
 
 ### MFVec3f [in, out] **keyValue** [ ] <small>(-∞,∞)</small>
 
-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.
 
 #### Hints
 
-- Number of keyValues must be an integer multiple of the number of keys! KeyValue/key integer multiple defines how many coordinates are sent in value_changed outputOnlys.
+- [Identical adjacent entries in *keyValue* array have the effect of defining constant-value step functions.](https://en.wikipedia.org/wiki/Step_function){:target="_blank"}
+- Number of keyValues must be an integer multiple of the number of keys!
+- *keyValue*/key integer multiple defines how many coordinates are sent in value_changed outputOnlys.
 
 ### MFVec3f [out] **value_changed**
 
 Linearly interpolated output value determined by current key time and corresponding keyValue pair.
 
-#### Hint
+#### Hints
+
+- X3D players might not send unchanging intermediate values, thus avoiding excessive superfluous events that have no effect.
+- KeyValue/key integer multiple defines how many coordinates are sent in *value_changed* outputOnlys.
+
+#### Warning
 
-- KeyValue/key integer multiple defines how many coordinates are sent in value_changed outputOnlys.
+- 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
 
 - Typical input connection is ROUTE someTimeSensorDEF.fraction_changed TO thisInterpolatorDEF.set_fraction.
 - Typical output connection is ROUTE thisInterpolatorDEF.value_changed TO someDestinationNodeDEF.set_someAttribute.
+- [Example scenes and authoring assets](https://x3dgraphics.com/examples/X3dForWebAuthors/Chapter07EventAnimationInterpolation){:target="_blank"}
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/Interpolation/CoordinateInterpolator/CoordinateInterpolator.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of CoordinateInterpolator](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/interpolators.html#CoordinateInterpolator){:target="_blank"}
+- [X3D Specification of CoordinateInterpolator node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/interpolators.html#CoordinateInterpolator){:target="_blank"}

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

@@ -1,6 +1,6 @@
 ---
 title: CoordinateInterpolator2D
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Interpolation
 categories: [components, Interpolation]
 tags: [CoordinateInterpolator2D, Interpolation]
@@ -13,9 +13,9 @@ tags: [CoordinateInterpolator2D, Interpolation]
 
 ## Overview
 
-CoordinateInterpolator2D generates a series of SFVec2f or MFVec2f 2-tuple float values that can be ROUTEd to a SFVec2f or MFVec2f attribute.
+CoordinateInterpolator2D generates a series of SFVec2f or MFVec2f 2-tuple float values. Authors can ROUTE value_changed output events to a SFVec2f or MFVec2f attribute.
 
-The CoordinateInterpolator2D node belongs to the **Interpolation** component and its default container field is *children.* It is available since X3D version 3.0 or later.
+The CoordinateInterpolator2D node belongs to the **Interpolation** component and its default container field is *children.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -30,44 +30,73 @@ The CoordinateInterpolator2D node belongs to the **Interpolation** component and
 
 ### SFNode [in, out] **metadata** NULL <small>[X3DMetadataObject]</small>
 
-Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.
+Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.
+
+#### 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 keyValue output.
 
+#### 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.
+
 ### MFFloat [in, out] **key** [ ] <small>(-∞,∞)</small>
 
-Definition parameters for linear-interpolation function time intervals, in increasing order and corresponding to keyValues.
+Definition values for linear-interpolation function input intervals, listed in non-decreasing order and corresponding to a value in the keyValue array.
 
 #### Hints
 
-- Number of keyValues must be an integer multiple of the number of keys! KeyValue/key integer multiple defines how many coordinates are sent in value_changed outputOnlys.
+- Number of keyValues must be an integer multiple of the number of keys!
+- KeyValue/*key* integer multiple defines how many coordinates are sent in value_changed outputOnlys.
+- Typical interval for values in *key* array is within range of 0 to 1, but larger intervals can be defined with arbitrary bounds.
+
+#### Warning
+
+- Values in *key* array shall be monotonically non-decreasing, meaning that each value is greater than or equal to the preceding value.
 
 ### MFVec2f [in, out] **keyValue** [ ] <small>(-∞,∞)</small>
 
-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.
 
 #### Hints
 
-- Number of keyValues must be an integer multiple of the number of keys! KeyValue/key integer multiple defines how many coordinates are sent in value_changed outputOnlys.
+- [Identical adjacent entries in *keyValue* array have the effect of defining constant-value step functions.](https://en.wikipedia.org/wiki/Step_function){:target="_blank"}
+- Number of keyValues must be an integer multiple of the number of keys!
+- *keyValue*/key integer multiple defines how many coordinates are sent in value_changed outputOnlys.
 
 ### MFVec2f [out] **value_changed**
 
 Linearly interpolated output value determined by current key time and corresponding keyValue pair.
 
-#### Hint
+#### Hints
 
-- KeyValue/key integer multiple defines how many coordinates are sent in value_changed outputOnlys.
+- X3D players might not send unchanging intermediate values, thus avoiding excessive superfluous events that have no effect.
+- KeyValue/key integer multiple defines how many coordinates are sent in *value_changed* outputOnlys.
 
-## 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
 
 - 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='3'/>`
+- [Example scenes and authoring assets](https://x3dgraphics.com/examples/X3dForWebAuthors/Chapter07EventAnimationInterpolation){:target="_blank"}
+
+### Warning
+
+- Requires X3D `profile='Full'` or else include `<component name='Interpolation' level='3'/>`
 
-## External Links
+## See Also
 
-- [X3D Specification of CoordinateInterpolator2D](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/interpolators.html#CoordinateInterpolator2D){:target="_blank"}
+- [X3D Specification of CoordinateInterpolator2D node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/interpolators.html#CoordinateInterpolator2D){:target="_blank"}

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

@@ -1,6 +1,6 @@
 ---
 title: EaseInEaseOut
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Interpolation
 categories: [components, Interpolation]
 tags: [EaseInEaseOut, Interpolation]
@@ -13,9 +13,9 @@ tags: [EaseInEaseOut, Interpolation]
 
 ## Overview
 
-EaseInEaseOut enables gradual animation transitions by modifying TimeSensor fraction outputs. Output values are modified fractions that can be ROUTEd to an interpolator, a sequencer, or another SFFloat attribute.
+EaseInEaseOut enables gradual animation transitions by modifying TimeSensor fraction outputs. Output values are modified fractions. Authors can ROUTE value_changed output events to an interpolator, a sequencer, or another SFFloat attribute.
 
-The EaseInEaseOut node belongs to the **Interpolation** component and its default container field is *children.* It is available since X3D version 3.2 or later.
+The EaseInEaseOut node belongs to the **Interpolation** component and its default container field is *children.* It is available from X3D version 3.2 or higher.
 
 ## Hierarchy
 
@@ -28,19 +28,36 @@ The EaseInEaseOut node belongs to the **Interpolation** 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"}
 
 ### SFFloat [in] **set_fraction** <small>(-∞,∞)</small>
 
-*set_fraction* selects input fraction for computation of corresponding easeInEaseOut output value, modifiedFraction_changed.
+*set_fraction* selects input *fraction* for computation of corresponding easeInEaseOut output value, modifiedFraction_changed.
+
+#### 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.
 
 ### MFFloat [in, out] **key** [ ] <small>(-∞,∞)</small>
 
-Definition parameters for linear-interpolation function time intervals, in increasing order and corresponding to easeInEaseOut array.
+Definition values for linear-interpolation function input intervals, listed in non-decreasing order and corresponding to easeInEaseOut array.
 
-#### Hint
+#### Hints
 
 - Number of keys must be one more than the number of easeInEaseOut values!
+- Typical interval for values in *key* array is within range of 0 to 1, but larger intervals can be defined with arbitrary bounds.
+
+#### Warning
+
+- Values in *key* array shall be monotonically non-decreasing, meaning that each value is greater than or equal to the preceding value.
 
 ### MFVec2f [in, out] **easeInEaseOut** [ ] <small>(-∞,∞)</small>
 
@@ -48,20 +65,27 @@ Array of paired values for easeOut fraction and easeIn fraction within each key
 
 #### Hint
 
-- Number of easeInEaseOut values must be one less than the number of keys.
+- Number of *easeInEaseOut* values must be one less than the number of keys.
 
 ### SFFloat [out] **modifiedFraction_changed**
 
 Interpolated output value determined by current key time, corresponding easeInEaseOut smoothing intervals, and corresponding key pair.
 
-## 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
 
 - Typical input connection is ROUTE someTimeSensorDEF.fraction_changed TO thisEaseInEaseOutDEF.set_fraction
 - Typical output connection is ROUTE thisEaseInEaseOutDEF.modifiedFraction_changed TO someDestinationNodeDEF.set_fraction.
-- Include `<component name='Interpolation' level='3'/>`
 
-## External Links
+### Warning
+
+- Requires X3D `profile='Full'` or else include `<component name='Interpolation' level='3'/>`
+
+## See Also
 
-- [X3D Specification of EaseInEaseOut](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/interpolators.html#EaseInEaseOut){:target="_blank"}
+- [X3D Specification of EaseInEaseOut node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/interpolators.html#EaseInEaseOut){:target="_blank"}