x_ite 8.8.7 → 8.9.1

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

@@ -1,6 +1,6 @@
 ---
 title: SplinePositionInterpolator2D
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Interpolation
 categories: [components, Interpolation]
 tags: [SplinePositionInterpolator2D, Interpolation]
@@ -15,7 +15,7 @@ tags: [SplinePositionInterpolator2D, Interpolation]
 
 SplinePositionInterpolator2D performs non-linear interpolation among paired lists of 2-tuple values and velocities to produce an SFVec2f value_changed output event.
 
-The SplinePositionInterpolator2D node belongs to the **Interpolation** component and its default container field is *children.* It is available since X3D version 3.2 or later.
+The SplinePositionInterpolator2D node belongs to the **Interpolation** component and its default container field is *children.* It is available from X3D version 3.2 or higher.
 
 ## Hierarchy
 
@@ -30,31 +30,49 @@ The SplinePositionInterpolator2D node belongs to the **Interpolation** component
 
 ### 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 use of keyValue, keyVelocity values for output computation.
 
+#### 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.
+
 ### SFBool [in, out] **closed** FALSE
 
-Whether or not the curve is closed (i.e. matching end values), with continuous velocity vectors as the interpolator transitions from the last key to the first key.
+Whether or not the curve is *closed* (i.e. matching end values), with continuous velocity vectors as the interpolator transitions from the last key to the first key.
 
 #### Warnings
 
-- If velocity vectors at first and last keys are specified, the closed field is ignored. If keyValues at first and last key are not identical, the closed field is ignored.
+- If velocity vectors at first and last keys are specified, the *closed* field is ignored.
+- If keyValues at first and last key are not identical, the *closed* field is ignored.
 
 ### MFFloat [in, out] **key** [ ] <small>(-∞,∞)</small>
 
-Definition parameters for nonlinear-interpolation function time intervals, in increasing order and corresponding to keyValue, keyVelocity array values.
+Definition parameters for nonlinear-interpolation function time intervals, listed in non-decreasing order and corresponding to keyValue, keyVelocity array values.
 
-#### Warning
+#### 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.
 
 ### MFVec2f [in, out] **keyValue** [ ] <small>(-∞,∞)</small>
 
-Output values for nonlinear interpolation, each corresponding to time-fraction keys.
+Output values for nonlinear interpolation, each corresponding to an input-fraction value in the key array.
 
 #### Warning
 
@@ -62,32 +80,39 @@ Output values for nonlinear interpolation, each corresponding to time-fraction k
 
 ### MFVec2f [in, out] **keyVelocity** [ ] <small>(-∞,∞)</small>
 
-Output values for nonlinear interpolation, each corresponding to time-fraction keys.
+Output values for nonlinear interpolation, each corresponding to an input-fraction value in the key array.
 
 #### Warning
 
-- Number of keys must match number of keyVelocity values!
+- Number of keys must match number of *keyVelocity* values!
 
 ### SFBool [in, out] **normalizeVelocity** FALSE
 
 *normalizeVelocity* field specifies whether the velocity vectors are normalized to produce smooth speed transitions, or transformed into tangency vectors.
 
-#### See Also
+#### Hint
 
-- [X3D 19.2.3 Non-linear interpolation](https://www.web3d.org/files/specifications/19775-1/V3.3/Part01/components/interpolators.html#NonlinearInterpolation){:target="_blank"}
+- [X3D 19.2.3 Non-linear interpolation](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/interpolators.html#NonlinearInterpolation){:target="_blank"}
 
 ### SFVec2f [out] **value_changed**
 
 Nonlinearly interpolated output value computed by using current time fraction along with corresponding key, keyValue and keyVelocity values.
 
-## 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='4'/>`
 
-## External Links
+### Warning
+
+- Requires X3D `profile='Full'` or else include `<component name='Interpolation' level='4'/>`
+
+## See Also
 
-- [X3D Specification of SplinePositionInterpolator2D](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/interpolators.html#SplinePositionInterpolator2D){:target="_blank"}
+- [X3D Specification of SplinePositionInterpolator2D node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/interpolators.html#SplinePositionInterpolator2D){:target="_blank"}

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

@@ -1,6 +1,6 @@
 ---
 title: SplineScalarInterpolator
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Interpolation
 categories: [components, Interpolation]
 tags: [SplineScalarInterpolator, Interpolation]
@@ -15,7 +15,7 @@ tags: [SplineScalarInterpolator, Interpolation]
 
 SplineScalarInterpolator performs non-linear interpolation among paired lists of float values and velocities to produce an SFFloat value_changed output event.
 
-The SplineScalarInterpolator node belongs to the **Interpolation** component and its default container field is *children.* It is available since X3D version 3.2 or later.
+The SplineScalarInterpolator node belongs to the **Interpolation** component and its default container field is *children.* It is available from X3D version 3.2 or higher.
 
 ## Hierarchy
 
@@ -30,31 +30,49 @@ The SplineScalarInterpolator 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 use of keyValue, keyVelocity values for output computation.
 
+#### 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.
+
 ### SFBool [in, out] **closed** FALSE
 
-Whether or not the curve is closed (i.e. matching end values), with continuous velocity vectors as the interpolator transitions from the last key to the first key.
+Whether or not the curve is *closed* (i.e. matching end values), with continuous velocity vectors as the interpolator transitions from the last key to the first key.
 
 #### Warnings
 
-- If velocity vectors at first and last keys are specified, the closed field is ignored. If keyValues at first and last key are not identical, the closed field is ignored.
+- If velocity vectors at first and last keys are specified, the *closed* field is ignored.
+- If keyValues at first and last key are not identical, the *closed* field is ignored.
 
 ### MFFloat [in, out] **key** [ ] <small>(-∞,∞)</small>
 
-Definition parameters for nonlinear-interpolation function time intervals, in increasing order and corresponding to keyValue, keyVelocity array values.
+Definition parameters for nonlinear-interpolation function time intervals, listed in non-decreasing order and corresponding to keyValue, keyVelocity array values.
 
-#### Warning
+#### 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.
 
 ### MFFloat [in, out] **keyValue** [ ] <small>(-∞,∞)</small>
 
-Output values for nonlinear interpolation, each corresponding to time-fraction keys.
+Output values for nonlinear interpolation, each corresponding to an input-fraction value in the key array.
 
 #### Warning
 
@@ -62,45 +80,43 @@ Output values for nonlinear interpolation, each corresponding to time-fraction k
 
 ### MFFloat [in, out] **keyVelocity** [ ] <small>(-∞,∞)</small>
 
-Output values for nonlinear interpolation, each corresponding to time-fraction keys.
+Output values for nonlinear interpolation, each corresponding to an input-fraction value in the key array.
 
 #### Warning
 
-- Number of keys must match number of keyVelocity values!
+- Number of keys must match number of *keyVelocity* values!
 
 ### SFBool [in, out] **normalizeVelocity** FALSE
 
 *normalizeVelocity* field specifies whether the velocity vectors are normalized to produce smooth speed transitions, or transformed into tangency vectors.
 
-#### See Also
+#### Hint
 
-- [X3D 19.2.3 Non-linear interpolation](https://www.web3d.org/files/specifications/19775-1/V3.3/Part01/components/interpolators.html#NonlinearInterpolation){:target="_blank"}
+- [X3D 19.2.3 Non-linear interpolation](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/interpolators.html#NonlinearInterpolation){:target="_blank"}
 
 ### SFFloat [out] **value_changed**
 
 Nonlinearly interpolated output value computed by using current time fraction along with corresponding key, keyValue and keyVelocity values.
 
-## 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='4'/>`
 
-## Example
+### Warning
 
-<x3d-canvas src="https://create3000.github.io/media/examples/Interpolation/SplineScalarInterpolator/SplineScalarInterpolator.x3d" update="auto"></x3d-canvas>
+- Requires X3D `profile='Full'` or else include `<component name='Interpolation' level='4'/>`
 
-<table class="x3d-widgets"><tbody><tr><td><input id="key-velocity" type="checkbox" value="true"></input><label for="key-velocity">Key Velocity</label></td><td><input id="normalize-velocity" type="checkbox" value="true"></input><label for="normalize-velocity">Normalize Key Velocity
-</label></td></tr></tbody></table>
+## Example
 
-- [/c3-source-example]
+<x3d-canvas src="https://create3000.github.io/media/examples/Interpolation/SplineScalarInterpolator/SplineScalarInterpolator.x3d" update="auto"></x3d-canvas>
 
 ## See Also
 
-- [ScalarInterpolator](/x_ite/components/interpolation/scalarinterpolator)
-
-## External Links
-
-- [X3D Specification of SplineScalarInterpolator](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/interpolators.html#SplineScalarInterpolator){:target="_blank"}
+- [X3D Specification of SplineScalarInterpolator node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/interpolators.html#SplineScalarInterpolator){:target="_blank"}

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

@@ -1,6 +1,6 @@
 ---
 title: SquadOrientationInterpolator
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Interpolation
 categories: [components, Interpolation]
 tags: [SquadOrientationInterpolator, Interpolation]
@@ -15,7 +15,7 @@ tags: [SquadOrientationInterpolator, Interpolation]
 
 SquadOrientationInterpolator performs non-linear interpolation among paired lists of rotation values to produce an SFRotation value_changed output event.
 
-The SquadOrientationInterpolator node belongs to the **Interpolation** component and its default container field is *children.* It is available since X3D version 3.2 or later.
+The SquadOrientationInterpolator node belongs to the **Interpolation** component and its default container field is *children.* It is available from X3D version 3.2 or higher.
 
 ## Hierarchy
 
@@ -30,27 +30,44 @@ The SquadOrientationInterpolator node belongs to the **Interpolation** component
 
 ### 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 use of keyValue, keyVelocity values for output computation.
 
+#### 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.
+
 ### SFBool [in, out] **closed** FALSE
 
-Input/Output field closed.
+Input/Output field *closed*.
 
 ### MFFloat [in, out] **key** [ ] <small>(-∞,∞)</small>
 
-Definition parameters for nonlinear-interpolation function time intervals, in increasing order and corresponding to keyValue, keyVelocity array values.
+Definition parameters for nonlinear-interpolation function time intervals, listed in non-decreasing order and corresponding to keyValue, keyVelocity array values.
 
-#### Warning
+#### 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.
 
 ### MFRotation [in, out] **keyValue** [ ] <small>(-∞,∞)</small>
 
-Output values for nonlinear interpolation, each corresponding to time-fraction keys.
+Output values for nonlinear interpolation, each corresponding to an input-fraction value in the key array.
 
 #### Warning
 
@@ -60,19 +77,26 @@ Output values for nonlinear interpolation, each corresponding to time-fraction k
 
 Nonlinearly interpolated output value computed by using current time fraction along with corresponding key, keyValue and keyVelocity values.
 
-## 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
 
 - Squad is an acronym for Spherical Cubic Interpolation.
 - 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='5'/>`
+
+### Warning
+
+- Requires X3D `profile='Full'` or else include `<component name='Interpolation' level='5'/>`
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/Interpolation/SquadOrientationInterpolator/SquadOrientationInterpolator.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of SquadOrientationInterpolator](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/interpolators.html#SquadOrientationInterpolator){:target="_blank"}
+- [X3D Specification of SquadOrientationInterpolator node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/interpolators.html#SquadOrientationInterpolator){:target="_blank"}

package/docs/_posts/components/KeyDeviceSensor/KeySensor.md

@@ -1,6 +1,6 @@
 ---
 title: KeySensor
-date: 2022-01-07
+date: 2023-01-07
 nav: components-KeyDeviceSensor
 categories: [components, KeyDeviceSensor]
 tags: [KeySensor, KeyDeviceSensor]
@@ -13,9 +13,9 @@ tags: [KeySensor, KeyDeviceSensor]
 
 ## Overview
 
-KeySensor generates events as the user presses keys on the keyboard. Supports notion of "keyboard focus".
+KeySensor generates events as the user presses keys on the keyboard. Browser support includes the notion of "keyboard focus".
 
-The KeySensor node belongs to the **KeyDeviceSensor** component and its default container field is *children.* It is available since X3D version 3.0 or later.
+The KeySensor node belongs to the **KeyDeviceSensor** component and its default container field is *children.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -31,7 +31,11 @@ The KeySensor node belongs to the **KeyDeviceSensor** component and its default
 
 ### SFNode [in, out] **metadata** NULL <small>[X3DMetadataObject]</small>
 
-Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.
+Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.
+
+#### Hint
+
+- [X3D Architecture 7.2.4 Metadata](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/core.html#Metadata){:target="_blank"}
 
 ### SFBool [in, out] **enabled** TRUE
 
@@ -41,38 +45,76 @@ Enables/disables node operation.
 
 *controlKey* generates true event when pressed, false event when released.
 
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
+
 ### SFBool [out] **shiftKey**
 
 *shiftKey* generates true event when pressed, false event when released.
 
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
+
 ### SFBool [out] **altKey**
 
 *altKey* generates true event when pressed, false event when released.
 
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
+
 ### SFInt32 [out] **actionKeyPress**
 
-Action key press gives following values: F1..F12 = 1...12 HOME=13 END=14 PGUP=15 PGDN=16 UP=17 DOWN=18 LEFT=19 RIGHT=20.
+Action key press gives following values: HOME=000 END=1001 PGUP=1002 PGDN=1003 UP=1004 DOWN=1005 LEFT=1006 RIGHT=1007 F1..F12 = 1008..1019.
+
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
 
 ### SFInt32 [out] **actionKeyRelease**
 
-Action key release gives following values: F1..F12 = 1...12 HOME=13 END=14 PGUP=15 PGDN=16 UP=17 DOWN=18 LEFT=19 RIGHT=20.
+Action key release gives following values: HOME=000 END=1001 PGUP=1002 PGDN=1003 UP=1004 DOWN=1005 LEFT=1006 RIGHT=1007 F1..F12 = 1008..1019.
+
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
 
 ### SFString [out] **keyPress**
 
 Events generated when user presses character-producing keys on keyboard produces integer UTF-8 character values.
 
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
+
 ### SFString [out] **keyRelease**
 
 Events generated when user releases character-producing keys on keyboard produces integer UTF-8 character values.
 
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
+
 ### SFBool [out] **isActive**
 
-When a key is pressed, the KeySensor sends an isActive event with value true. Once the key is released, the KeySensor sends an isActive event with value false.
+Select geometry by activating the pointing device (for example, clicking the mouse) to generate *isActive* events. Output event *isActive*=true is sent when geometry is selected (for example, when primary mouse button is pressed), output event *isActive*=false is sent when geometry is deselected (for example, when primary mouse button is released).
+
+#### 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
+
+### Hint
+
+- [Example scenes and authoring assets](https://x3dgraphics.com/examples/X3dForWebAuthors/Chapter08UserInteractivity){:target="_blank"}
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/KeyDeviceSensor/KeySensor/KeySensor.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of KeySensor](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/keyboard.html#KeySensor){:target="_blank"}
+- [X3D Specification of KeySensor node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/keyboard.html#KeySensor){:target="_blank"}

package/docs/_posts/components/KeyDeviceSensor/StringSensor.md

@@ -1,6 +1,6 @@
 ---
 title: StringSensor
-date: 2022-01-07
+date: 2023-01-07
 nav: components-KeyDeviceSensor
 categories: [components, KeyDeviceSensor]
 tags: [StringSensor, KeyDeviceSensor]
@@ -13,9 +13,9 @@ tags: [StringSensor, KeyDeviceSensor]
 
 ## Overview
 
-StringSensor generates events as the user presses keys on the keyboard.
+StringSensor generates events as the user presses keys on the keyboard. Browser support includes the notion of "keyboard focus".
 
-The StringSensor node belongs to the **KeyDeviceSensor** component and its default container field is *children.* It is available since X3D version 3.0 or later.
+The StringSensor node belongs to the **KeyDeviceSensor** component and its default container field is *children.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -31,7 +31,11 @@ The StringSensor node belongs to the **KeyDeviceSensor** component and its defau
 
 ### 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] **enabled** TRUE
 
@@ -39,7 +43,7 @@ Enables/disables node operation.
 
 ### SFBool [in, out] **deletionAllowed** TRUE
 
-If deletionAllowed is true, then previously entered character in enteredText can be removed. If deletionAllowed is false, then characters may only be added to the string.
+If *deletionAllowed* is true, then previously entered character in enteredText can be removed. If *deletionAllowed* is false, then characters may only be added to the string.
 
 #### Hint
 
@@ -49,22 +53,40 @@ If deletionAllowed is true, then previously entered character in enteredText can
 
 Events generated as character-producing keys are pressed on keyboard.
 
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
+
 ### SFString [out] **finalText**
 
-Events generated when sequence of keystrokes matches keys in terminationText string when this condition occurs, enteredText is moved to finalText and enteredText is set to empty string.
+Events generated when sequence of keystrokes matches keys in terminationText string when this condition occurs, enteredText is moved to *finalText* and enteredText is set to empty string.
 
 #### Hint
 
 - Termination key is typically defined by local system.
 
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
+
 ### SFBool [out] **isActive**
 
-When the user begins typing, the StringSensor sends an isActive event with value true. When the string is terminated, the StringSensor sends an isActive event with value false.
+Select geometry by activating the pointing device (for example, clicking the mouse) to generate *isActive* events. Output event *isActive*=true is sent when geometry is selected (for example, when primary mouse button is pressed), output event *isActive*=false is sent when geometry is deselected (for example, when primary mouse button is released).
+
+#### 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
+
+### Hint
+
+- [Example scenes and authoring assets](https://x3dgraphics.com/examples/X3dForWebAuthors/Chapter08UserInteractivity){:target="_blank"}
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/KeyDeviceSensor/StringSensor/StringSensor.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of StringSensor](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/keyboard.html#StringSensor){:target="_blank"}
+- [X3D Specification of StringSensor node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/keyboard.html#StringSensor){:target="_blank"}

package/docs/_posts/components/Layering/Layer.md

@@ -1,6 +1,6 @@
 ---
 title: Layer
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Layering
 categories: [components, Layering]
 tags: [Layer, Layering]
@@ -15,7 +15,7 @@ tags: [Layer, Layering]
 
 Layer contains a list of children nodes that define the contents of the layer.
 
-The Layer node belongs to the **Layering** component and its default container field is *layers.* It is available since X3D version 3.2 or later.
+The Layer node belongs to the **Layering** component and its default container field is *layers.* It is available from X3D version 3.2 or higher.
 
 ## Hierarchy
 
@@ -29,7 +29,11 @@ The Layer node belongs to the **Layering** component and its default container f
 
 ### 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] **pickable** TRUE
 
@@ -37,43 +41,52 @@ Metadata are not part of the X3D world and not interpreted by the X3D browser, b
 
 ### MFString [in, out] **objectType** "ALL" <small>["ALL", "NONE", "TERRAIN", ...]</small>
 
-The objectType field specifies a set of labels used in the picking process. Each string specified is treated as an independent label that needs to be matched against the same type in one of the pick sensor instances.
+The *objectType* field specifies a set of labels used in the picking process. Each string specified is treated as an independent label that needs to be matched against the same type in one of the pick sensor instances. Example: labeling a PickableGroup with the *objectType* value "WATER" and then attempting to intersect a pick sensor with *objectType* value "GROUND" fails since the *objectType* values do not match. Example: the special value "ALL" means that each node is available for picking regardless of the type specified by the pick sensor. Example: the special value "NONE" effectively disables all picking for this node and is the equivalent of setting the pickable field to false.
 
 #### Hints
 
-- Authors may define any value for objectType. MFString arrays can have multiple values, so "separate each individual string" "by using quote marks".
+- Authors may define any value for *objectType*.
+- MFString arrays can have multiple values, so "separate each individual string" "by using quote marks".
 
 ### SFBool [in, out] **visible** TRUE
 
 Whether or not renderable content within this node is visually displayed.
 
+#### 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.
+
 ### SFNode [in, out] **viewport** NULL <small>[X3DViewportNode]</small>
 
-The viewport field is a single Viewport node that constrains layer output to a sub-region of the render surface.
+The *viewport* field is a single Viewport node that constrains layer output to a sub-region of the render surface.
 
 ### 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>
 
 Nodes making up this layer.
 
-#### Hint
+#### Hints
 
-- No transformations are possible above each Layerset/Layer combination in the scene graph hierarchy.
+- No transformations are possible above each LayerSet/Layer combination in 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
 
-- No transformations are possible above each Layerset/Layer combination in the scene graph hierarchy.
+- No transformations are possible above each LayerSet/Layer combination in the scene graph hierarchy.
 - Each Layer node contains its own binding stacks and thus has its own viewpoints and navigation.
 
-## External Links
+## See Also
 
-- [X3D Specification of Layer](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/layering.html#Layer){:target="_blank"}
+- [X3D Specification of Layer node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/layering.html#Layer){:target="_blank"}