x_ite 8.8.6 → 8.9.0

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

@@ -1,6 +1,6 @@
 ---
 title: HAnimSegment
-date: 2022-01-07
+date: 2023-01-07
 nav: components-HAnim
 categories: [components, HAnim]
 tags: [HAnimSegment, HAnim]
@@ -13,9 +13,9 @@ tags: [HAnimSegment, HAnim]
 
 ## Overview
 
-Each body segment is stored in an HAnimSegment node. HAnimSegment contains Coordinate/CoordinateDouble with containerField='coord', HAnimDisplacer with containerField='displacers' and Shape or grouping nodes with containerField='children'.
+HAnimSegment node contains Shape geometry for each body segment, providing a visual representation of the skeleton segment. Parent/child translation and rotation relationships are defined in ancestor/descendant HAnimSegment nodes. HAnimSegment contains Coordinate or CoordinateDouble with `containerField='coord',` HAnimDisplacer with `containerField='displacers'` and Shape or grouping nodes with `containerField='children'.`
 
-The HAnimSegment node belongs to the **HAnim** component and its default container field is *children.* It is available since X3D version 3.0 or later.
+The HAnimSegment 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,103 +30,143 @@ The HAnimSegment node belongs to the **HAnim** component and its default contain
 
 ### 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.
-
-### SFString [in, out] **description** ""
-
-Author-provided prose that describes intended purpose of the url asset.
+Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet 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).
+- [X3D Architecture 7.2.4 Metadata](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/core.html#Metadata){:target="_blank"}
 
-### SFBool [ ] **visible** TRUE
+### SFString [in, out] **description** ""
 
-Whether or not renderable content within this node is visually displayed.
+Author-provided prose that describes intended purpose of this node.
 
 #### Hint
 
-- 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.
+- 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).
 
-### SFBool [ ] **bboxDisplay** FALSE
+### SFString [in, out] **name** ""
 
-Whether to display bounding box for associated geometry, aligned with world coordinates.
+Unique *name* attribute must be defined so that HAnimSegment node can be identified at run time for animation purposes.
 
-#### Hint
+#### Hints
 
-- The bounding box is displayed regardless of whether contained content is visible.
+- For abitrary humanoids, HAnimSegment *name* can describe geometry between parent HAnimJoint and sibling HAnimJoint nodes (for example LeftHip_to_LeftKnee).
+- [HAnim Specification part 1, Humanoid Joint-Segment Hierarchy](https://www.web3d.org/documents/specifications/19774/V2.0/Architecture/concepts.html#Hierarchy){: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"}
 
-### SFVec3f [ ] **bboxSize** -1 -1 -1 <small>[0,∞) or −1 −1 −1</small>
+#### Warnings
 
-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.
+- *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. Examples: sacrum pelvis l_thigh l_calf etc. as listed in HAnim Specification.
 
-#### Hint
+### SFFloat [in, out] **mass** 0 <small>[0,∞)</small>
 
-- Can be useful for collision computations or inverse-kinematics (IK) engines.
+Total *mass* of the segment, 0 if not available, defined in *mass* base units (default is kilograms).
 
-### SFVec3f [ ] **bboxCenter** 0 0 0 <small>(-∞,∞)</small>
+#### Hints
 
-Bounding box center: optional hint for position offset from origin of local coordinate system.
+- [Kilogram](https://en.wikipedia.org/wiki/Kilogram){:target="_blank"}
+- [X3D Architecture 4.3.6 Standard units and coordinate system](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/concepts.html#Standardunitscoordinates){:target="_blank"}
 
-### MFNode [in] **addChildren**
+### SFVec3f [in, out] **centerOfMass** 0 0 0 <small>(-∞,∞)</small>
 
-Input field addChildren.
+Location within segment of center of mass.
 
-### MFNode [in] **removeChildren**
+### MFFloat [in, out] **momentsOfInertia** [ 0, 0, 0, 0, 0, 0, 0, 0, 0 ] <small>[0,∞)</small>
 
-Input field removeChildren.
+3x3 moments of inertia matrix. default: 0 0 0 0 0 0 0 0 0.
 
-### MFNode [in, out] **children** [ ] <small>[X3DChildNode]</small>
+### MFNode [in, out] **displacers** [ ] <small>[HAnimDisplacer]</small>
 
-Input/Output field children.
+The *displacers* field stores HAnimDisplacer objects for a particular HAnimSegment object.
 
-### SFVec3f [in, out] **centerOfMass** 0 0 0 <small>(-∞,∞)</small>
+#### Warning
 
-Location within segment of center of mass.
+- Index values for HanimHumanoid skin IndexedFaceSet, skinCoord and skinNormal nodes must all be consistently defined together with HAnimJoint HAnimSegment and HAnimDisplacer nodes for proper skin animation.
 
 ### SFNode [in, out] **coord** NULL <small>[X3DCoordinateNode]</small>
 
-Single contained Coordinate or CoordinateDouble node that can specify a list of vertex values.
+The *coord* field is used for HAnimSegment objects that have deformable meshes and shall contain coordinates referenced from the IndexedFaceSet for the paarent HAnimSegment object. The coordinates are given the same name as the HAnim Segment object, but with "_coords" appended to the name (for example, "skull_coords").
 
-### MFNode [in, out] **displacers** [ ] <small>[HAnimDisplacer]</small>
+#### Warning
 
-Input/Output field displacers.
+- Index values for HanimHumanoid skin IndexedFaceSet, skinCoord and skinNormal nodes must all be consistently defined together with HAnimJoint HAnimSegment and HAnimDisplacer nodes for proper skin animation.
 
-### SFFloat [in, out] **mass** 0 <small>[0,∞)</small>
+### SFBool [in, out] **visible** TRUE
 
-Total mass of the segment, 0 if not available.
+Whether or not renderable content within this node is visually displayed.
 
-### MFFloat [in, out] **momentsOfInertia** [ 0, 0, 0, 0, 0, 0, 0, 0, 0 ] <small>[0,∞)</small>
+#### Hints
 
-3x3 moments of inertia matrix. default: 0 0 0 0 0 0 0 0 0.
+- 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.
 
-### SFString [in, out] **name** ""
+### SFBool [in, out] **bboxDisplay** FALSE
 
-Unique name attribute must be defined so that HAnimSegment node can be identified at run time for animation purposes.
+Whether to display bounding box for associated geometry, aligned with world coordinates.
 
 #### Hint
 
-- For arbitrary humanoids, HAnimSegment name can describe geometry between parent HAnimJoint and sibling HAnimJoint nodes (for example LeftHip_to_LeftKnee).
+- The bounding box is displayed regardless of whether contained content is visible.
 
-#### Warning
+### SFVec3f [ ] **bboxSize** -1 -1 -1 <small>[0,∞) or −1 −1 −1</small>
+
+Bounding box size is usually omitted, and can easily be calculated automatically by an X3D player at scene-loading time with minimal computational cost. Bounding box size can also be defined as an optional authoring hint that suggests an optimization or constraint.
+
+#### 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 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*.
 
-- Name is not included if this instance is a USE node. Examples: sacrum pelvis l_thigh l_calf etc. as listed in HAnim Specification.
+### MFNode [in] **removeChildren**
+
+Input field *removeChildren*.
+
+### MFNode [in, out] **children** [ ] <small>[X3DChildNode]</small>
 
-#### See Also
+Grouping nodes contain an ordered list of *children* nodes.
 
-- [HAnim Humanoid Segment Names HAnim Specification, Humanoid Joint-Segment Hierarchy](https://www.web3d.org/x3d/content/examples/Basic/HumanoidAnimation/tables/HAnimSegmentNames19774V1.0.txt){:target="_blank"}
-- [HAnim Specification, Humanoid Joint-Segment Hierarchy](https://www.web3d.org/documents/specifications/19774-1/V2.0/HAnim/concepts.html#Hierarchy){:target="_blank"}
+#### Hints
 
-## Description
+- 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.
+- Place any geometry for parent HAnimJoint within a child Transform having the same translation value as the parent HAnimJoint center value.
+- 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
 
 - HAnimSegment displays geometry between parent HAnimJoint and sibling HAnimJoint nodes.
-- Include `<component name='HAnim' level='1'/>`
+- [HAnim Specification](https://www.web3d.org/documents/specifications/19774/V2.0){:target="_blank"}
+- [HAnim Specification part 1, Segment](https://www.web3d.org/documents/specifications/19774/V2.0/Architecture/ObjectInterfaces.html#Segment){:target="_blank"}
+- [X3D for Advanced Modeling (X3D4AM) slideset](https://x3dgraphics.com/slidesets/X3dForAdvancedModeling/HumanoidAnimation.pdf){:target="_blank"}
+
+### Warnings
+
+- 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 \<HAnimSegment USE='*' `containerField='segments'/>` nodes at top level of HAnimHumanoid needs to match the number of corresponding HAnimJoint node instances found within the preceding skeleton hierarchy.
 
-## External Links
+## See Also
 
-- [X3D Specification of HAnimSegment](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/hanim.html#HAnimSegment){:target="_blank"}
-- [HAnim Specification](https://www.web3d.org/documents/specifications/19774-1/V2.0/HAnim/HAnimArchitecture.html){:target="_blank"}
-- [HAnim Specification, Segment](https://www.web3d.org/documents/specifications/19774-1/V2.0/HAnim/ObjectInterfaces.html#Segment){:target="_blank"}
+- [X3D Specification of HAnimSegment node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/hanim.html#HAnimSegment){:target="_blank"}

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,104 +30,147 @@ 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).
 
-### SFBool [ ] **visible** TRUE
+### SFString [in, out] **name** ""
 
-Whether or not renderable content within this node is visually displayed.
+Unique *name* attribute must be defined so that HAnimSite node can be identified at run time for animation purposes.
 
-#### 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.
+- 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"}
 
-### SFBool [ ] **bboxDisplay** FALSE
+#### Warnings
 
-Whether to display bounding box for associated geometry, aligned with world coordinates.
+- *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.
 
-#### Hint
+### SFVec3f [in, out] **translation** 0 0 0 <small>(-∞,∞)</small>
 
-- The bounding box is displayed regardless of whether contained content is visible.
+Position of children relative to local coordinate system.
 
-### SFVec3f [ ] **bboxSize** -1 -1 -1 <small>[0,∞) or −1 −1 −1</small>
+#### Hints
 
-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.
+- 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.
 
-#### Hint
+### SFRotation [in, out] **rotation** 0 0 1 0 <small>(-∞,∞) or [-1,1]</small>
 
-- Can be useful for collision computations or inverse-kinematics (IK) engines.
+Orientation of children relative to local coordinate system.
 
-### SFVec3f [ ] **bboxCenter** 0 0 0 <small>(-∞,∞)</small>
+### SFVec3f [in, out] **scale** 1 1 1 <small>(0,∞)</small>
 
-Bounding box center: optional hint for position offset from origin of local coordinate system.
+Non-uniform x-y-z *scale* of child coordinate system, adjusted by center and scaleOrientation.
 
-### MFNode [in] **addChildren**
+### SFRotation [in, out] **scaleOrientation** 0 0 1 0 <small>(-∞,∞) or [-1,1]</small>
 
-Input field addChildren.
+Preliminary rotation of coordinate system before scaling (to allow scaling around arbitrary orientations).
 
-### MFNode [in] **removeChildren**
+### SFVec3f [in, out] **center** 0 0 0 <small>(-∞,∞)</small>
 
-Input field removeChildren.
+Default location of this HAnimSite, i.e. offset of *center* from origin of local coordinate system.
 
-### MFNode [in, out] **children** [ ] <small>[X3DChildNode]</small>
+#### Hint
 
-Input/Output field children.
+- *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.
 
-### SFVec3f [in, out] **center** 0 0 0 <small>(-∞,∞)</small>
+### SFBool [in, out] **visible** TRUE
 
-Translation offset from origin of local coordinate system.
+Whether or not renderable content within this node is visually displayed.
 
-### SFString [in, out] **name** ""
+#### 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.
+
+### SFBool [in, out] **bboxDisplay** FALSE
 
-Unique name attribute must be defined so that HAnimSite node can be identified at run time for animation purposes.
+Whether to display bounding box for associated geometry, aligned with world coordinates.
+
+#### Hint
+
+- The bounding box is displayed regardless of whether contained content is visible.
+
+### SFVec3f [ ] **bboxSize** -1 -1 -1 <small>[0,∞) or −1 −1 −1</small>
+
+Bounding box size is usually omitted, and can easily be calculated automatically by an X3D player at scene-loading time with minimal computational cost. Bounding box size can also be defined as an optional authoring hint that suggests an optimization or constraint.
 
 #### 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.
+- 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"}
 
-#### Warning
+### SFVec3f [ ] **bboxCenter** 0 0 0 <small>(-∞,∞)</small>
 
-- Name is not included if this instance is a USE node.
+Bounding box center accompanies bboxSize and provides an optional hint for bounding box position offset from origin of local coordinate system.
 
-#### See Also
+#### Hints
 
-- [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"}
+- 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"}
 
-### SFRotation [in, out] **rotation** 0 0 1 0 <small>(-∞,∞)|[-1,1]</small>
+### MFNode [in] **addChildren**
 
-Orientation of children relative to local coordinate system.
+Input field *addChildren*.
 
-### SFVec3f [in, out] **scale** 1 1 1 <small>(0,∞)</small>
+### MFNode [in] **removeChildren**
 
-Non-uniform x-y-z scale of child coordinate system, adjusted by center and scaleOrientation.
+Input field *removeChildren*.
 
-### SFRotation [in, out] **scaleOrientation** 0 0 1 0 <small>(-∞,∞)|[-1,1]</small>
+### MFNode [in, out] **children** [ ] <small>[X3DChildNode]</small>
 
-Preliminary rotation of coordinate system before scaling (to allow scaling around arbitrary orientations).
+Grouping nodes contain an ordered list of *children* nodes.
 
-### SFVec3f [in, out] **translation** 0 0 0 <small>(-∞,∞)|[-1,1]</small>
+#### Hints
 
-Position of children relative to local coordinate system.
+- 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
 
 ### 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"}