x_ite 8.8.7 → 8.9.0

package/docs/_posts/components/ParticleSystems/SurfaceEmitter.md

@@ -1,6 +1,6 @@
 ---
 title: SurfaceEmitter
-date: 2022-01-07
+date: 2023-01-07
 nav: components-ParticleSystems
 categories: [components, ParticleSystems]
 tags: [SurfaceEmitter, ParticleSystems]
@@ -15,7 +15,7 @@ tags: [SurfaceEmitter, ParticleSystems]
 
 SurfaceEmitter generates particles from the surface of an object. New particles are generated by first randomly choosing a face on the tessellated geometry and then a random position on that face. Particles are generated with an initial direction of the normal to that point (including any normal averaging due to normalPerVertex and creaseAngle field settings).
 
-The SurfaceEmitter node belongs to the **ParticleSystems** component and its default container field is *emitter.* It is available since X3D version 3.2 or later.
+The SurfaceEmitter node belongs to the **ParticleSystems** component and its default container field is *emitter.* It is available from X3D version 3.2 or higher.
 
 ## Hierarchy
 
@@ -29,7 +29,11 @@ The SurfaceEmitter node belongs to the **ParticleSystems** component and its def
 
 ### 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] **on** TRUE
 
@@ -37,7 +41,7 @@ Enables/disables production of particles from this emitter node. If operating wh
 
 ### SFFloat [in, out] **speed** 0 <small>[0,∞)</small>
 
-Initial linear speed (default is m/s) imparted to all particles along their direction of movement.
+Initial linear *speed* (default is m/s) imparted to all particles along their direction of movement.
 
 ### SFFloat [in, out] **variation** 0.25 <small>[0,∞)</small>
 
@@ -45,15 +49,17 @@ Multiplier for the randomness used to control the range of possible output value
 
 #### Hint
 
-- Variation of zero does not allow any randomness.
+- *variation* of zero does not allow any randomness.
 
 ### SFFloat [ ] **mass** 0 <small>[0,∞)</small>
 
-Basic mass of each particle in mass base units (default is grams).
+Basic *mass* of each particle, defined in *mass* base units (default is kilograms).
 
-#### Hint
+#### Hints
 
-- Mass is needed if gravity or other force-related calculations are performed per-particle.
+- *mass* is needed if gravity or other force-related calculations are performed on a per-particle basis.
+- [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"}
 
 ### SFFloat [ ] **surfaceArea** 0 <small>[0,∞)</small>
 
@@ -61,21 +67,22 @@ Particle surface area in area base units (default is meters squared). Surface ar
 
 #### Hints
 
-- SurfaceArea value represents average frontal area presented to the wind. Assumes spherical model for each particle (i.e., surface area is the same regardless of direction).
+- *surfaceArea* value represents average frontal area presented to the wind.
+- Assumes spherical model for each particle (i.e., surface area is the same regardless of direction).
 
 ### SFNode [ ] **surface** NULL <small>[X3DGeometryNode]</small>
 
-The geometry node provides geometry used as the emitting surface.
+The geometry node provides geometry used as the emitting *surface*.
 
 #### Hint
 
-- If the surface is indicated as not being solid (solid field set to false), randomly choose from which side of the surface to emit, negating the normal direction when generating from the back side.
+- If the *surface* is indicated as not being solid (solid field set to false), randomly choose from which side of the *surface* to emit, negating the normal direction when generating from the back side.
 
 #### Warning
 
 - Only valid geometry shall be used.
 
-## Description
+## Advisories
 
 ### Hint
 
@@ -89,6 +96,6 @@ The geometry node provides geometry used as the emitting surface.
 
 <x3d-canvas src="https://create3000.github.io/media/examples/ParticleSystems/SurfaceEmitter/SurfaceEmitter.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of SurfaceEmitter](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/particleSystems.html#SurfaceEmitter){:target="_blank"}
+- [X3D Specification of SurfaceEmitter node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/particleSystems.html#SurfaceEmitter){:target="_blank"}

package/docs/_posts/components/ParticleSystems/VolumeEmitter.md

@@ -1,6 +1,6 @@
 ---
 title: VolumeEmitter
-date: 2022-01-07
+date: 2023-01-07
 nav: components-ParticleSystems
 categories: [components, ParticleSystems]
 tags: [VolumeEmitter, ParticleSystems]
@@ -15,7 +15,7 @@ tags: [VolumeEmitter, ParticleSystems]
 
 VolumeEmitter emits particles from a random position confined within the given closed geometry volume.
 
-The VolumeEmitter node belongs to the **ParticleSystems** component and its default container field is *emitter.* It is available since X3D version 3.2 or later.
+The VolumeEmitter node belongs to the **ParticleSystems** component and its default container field is *emitter.* It is available from X3D version 3.2 or higher.
 
 ## Hierarchy
 
@@ -29,15 +29,15 @@ The VolumeEmitter node belongs to the **ParticleSystems** component and its defa
 
 ### 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.
 
-### MFInt32 [in] **set_coordIndex** <small>[0,∞) or -1</small>
+#### Hint
 
-*coordIndex* indices provide the order in which coordinates are applied to construct each polygon face. Order starts at index 0, commas are optional between sets.
+- [X3D Architecture 7.2.4 Metadata](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/core.html#Metadata){:target="_blank"}
 
-#### Hint
+### MFInt32 [in] **set_coordIndex** <small>[0,∞) or -1</small>
 
-- Sentinel value -1 is used to separate indices for each successive polygon.
+Input field *set_coordIndex*.
 
 ### SFBool [in, out] **on** TRUE
 
@@ -49,11 +49,11 @@ TODO, X3D specification is undefined.
 
 ### SFVec3f [in, out] **direction** 0 1 0 <small>(-∞,∞)</small>
 
-Initial direction from which particles emanate.
+Initial *direction* from which particles emanate.
 
 ### SFFloat [in, out] **speed** 0 <small>[0,∞)</small>
 
-Initial linear speed (default is m/s) imparted to all particles along their direction of movement.
+Initial linear *speed* (default is m/s) imparted to all particles along their direction of movement.
 
 ### SFFloat [in, out] **variation** 0.25 <small>[0,∞)</small>
 
@@ -61,15 +61,17 @@ Multiplier for the randomness used to control the range of possible output value
 
 #### Hint
 
-- Variation of zero does not allow any randomness.
+- *variation* of zero does not allow any randomness.
 
 ### SFFloat [ ] **mass** 0 <small>[0,∞)</small>
 
-Basic mass of each particle in mass base units (default is grams).
+Basic *mass* of each particle, defined in *mass* base units (default is kilograms).
 
-#### Hint
+#### Hints
 
-- Mass is needed if gravity or other force-related calculations are performed per-particle.
+- *mass* is needed if gravity or other force-related calculations are performed on a per-particle basis.
+- [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"}
 
 ### SFFloat [ ] **surfaceArea** 0 <small>[0,∞)</small>
 
@@ -77,17 +79,22 @@ Particle surface area in area base units (default is meters squared). Surface ar
 
 #### Hints
 
-- SurfaceArea value represents average frontal area presented to the wind. Assumes spherical model for each particle (i.e., surface area is the same regardless of direction).
+- *surfaceArea* value represents average frontal area presented to the wind.
+- Assumes spherical model for each particle (i.e., surface area is the same regardless of direction).
 
 ### MFInt32 [ ] **coordIndex** -1 <small>[0,∞) or -1</small>
 
 *coordIndex* indices are applied to contained Coordinate values in order to define randomly generated initial geometry of the particles.
 
+#### Warning
+
+- *coordIndex* is required in order to connect contained coordinate point values.
+
 ### SFNode [in, out] **coord** NULL <small>[X3DCoordinateNode]</small>
 
-*coord*inates for the geometry used as the emitting volume.
+Coordinates for the geometry used as the emitting volume.
 
-## Description
+## Advisories
 
 ### Hint
 
@@ -97,6 +104,6 @@ Particle surface area in area base units (default is meters squared). Surface ar
 
 <x3d-canvas src="https://create3000.github.io/media/examples/ParticleSystems/VolumeEmitter/VolumeEmitter.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of VolumeEmitter](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/particleSystems.html#VolumeEmitter){:target="_blank"}
+- [X3D Specification of VolumeEmitter node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/particleSystems.html#VolumeEmitter){:target="_blank"}

package/docs/_posts/components/ParticleSystems/WindPhysicsModel.md

@@ -1,6 +1,6 @@
 ---
 title: WindPhysicsModel
-date: 2022-01-07
+date: 2023-01-07
 nav: components-ParticleSystems
 categories: [components, ParticleSystems]
 tags: [WindPhysicsModel, ParticleSystems]
@@ -15,7 +15,7 @@ tags: [WindPhysicsModel, ParticleSystems]
 
 WindPhysicsModel applies a wind effect to the particles. The wind includes a random variation factor to model gustiness.
 
-The WindPhysicsModel node belongs to the **ParticleSystems** component and its default container field is *physics.* It is available since X3D version 3.2 or later.
+The WindPhysicsModel node belongs to the **ParticleSystems** component and its default container field is *physics.* It is available from X3D version 3.2 or higher.
 
 ## Hierarchy
 
@@ -29,7 +29,11 @@ The WindPhysicsModel node belongs to the **ParticleSystems** component and its d
 
 ### 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,7 +45,7 @@ Enables/disables node operation.
 
 ### SFFloat [in, out] **speed** 0.1 <small>[0,∞)</small>
 
-Initial linear speed (default is m/s) imparted to all particles along their direction of movement.
+Initial linear *speed* (default is m/s) imparted to all particles along their direction of movement.
 
 ### SFFloat [in, out] **gustiness** 0.1 <small>[0,∞)</small>
 
@@ -57,12 +61,12 @@ Initial linear speed (default is m/s) imparted to all particles along their dire
 
 #### Hint
 
-- This is determined per-particle to model how each is effected by turbulence.
+- This is determined per-particle to model how each is effected by *turbulence*.
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/ParticleSystems/WindPhysicsModel/WindPhysicsModel.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of WindPhysicsModel](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/particleSystems.html#WindPhysicsModel){:target="_blank"}
+- [X3D Specification of WindPhysicsModel node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/particleSystems.html#WindPhysicsModel){:target="_blank"}

package/docs/_posts/components/Picking/LinePickSensor.md

@@ -1,6 +1,6 @@
 ---
 title: LinePickSensor
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Picking
 categories: [components, Picking]
 tags: [LinePickSensor, Picking]
@@ -15,7 +15,7 @@ tags: [LinePickSensor, Picking]
 
 LinePickSensor uses one or more pickingGeometry line segments to compute intersections with pickTarget shapes. As each line intersection generates a known point in space, useful event information is returned including normal, geometry and texCoord values.
 
-The LinePickSensor node belongs to the **Picking** component and its default container field is *children.* It is available since X3D version 3.2 or later.
+The LinePickSensor node belongs to the **Picking** component and its default container field is *children.* It is available from X3D version 3.2 or higher.
 
 ## Hierarchy
 
@@ -31,7 +31,11 @@ The LinePickSensor node belongs to the **Picking** component and its default con
 
 ### SFNode [in, out] **metadata** NULL <small>[X3DMetadataObject]</small>
 
-Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.
+Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.
+
+#### Hint
+
+- [X3D Architecture 7.2.4 Metadata](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/core.html#Metadata){:target="_blank"}
 
 ### SFBool [in, out] **enabled** TRUE
 
@@ -39,11 +43,12 @@ Enables/disables node operation.
 
 ### 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 of the corresponding PickableGroup 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".
 
 ### SFString [in, out] **matchCriterion** "MATCH_ANY" <small>["MATCH_ANY"|"MATCH_EVERY"|"MATCH_ONLY_ONE"]</small>
 
@@ -55,7 +60,7 @@ Defines whether the intersection test (i.e. pick) by this X3DPickSensorNode must
 
 #### Hint
 
-- IntersectionType constants may be extended by the browser to provide additional options.
+- *intersectionType* constants may be extended by the browser to provide additional options.
 
 #### Warning
 
@@ -63,7 +68,7 @@ Defines whether the intersection test (i.e. pick) by this X3DPickSensorNode must
 
 ### SFString [ ] **sortOrder** "CLOSEST" <small>["ANY"|"CLOSEST"|"ALL"|"ALL_SORTED"]</small>
 
-The sortOrder field determines the order provided for picked output events.
+The *sortOrder* field determines the order provided for picked output events. Example: ANY means any single object that can satisfy picking conditions for this pick sensor. Consistency of results is not guaranteed. Example: ALL means that every object that satisfies the picking conditions for this pick sensor shall be returned. Example: ALL_SORTED means that every object that satisfies the picking conditions for this pick sensor shall be returned with the order of the output fields provided in a distance-sorted order from closest to farthest away. The exact algorithm for sorting is defined by the individual node definitions. Example: CLOSEST means that the closest object by distance that satisfies the conditions of this pick sensor. *The exact algorithm for distance determination shall be defined by individual node definitions*.
 
 #### Hint
 
@@ -75,24 +80,37 @@ The sortOrder field determines the order provided for picked output events.
 
 ### SFBool [out] **isActive**
 
-*isActive* indicates when the intersecting object is picked by the picking geometry. Output event isActive=true gets sent once a picked item is found. Output event isActive=false gets sent once no picked item is found.
+*isActive* indicates when the intersecting object is picked by the picking geometry. Output event *isActive*=true gets sent once a picked item is found. Output event *isActive*=false gets sent once no picked item is found.
+
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
 
 ### MFVec3f [out] **pickedTextureCoordinate**
 
 Output event containing 3D texture coordinates of surfaces computed by the picking intersection computations. Picked texture coordinates are in three dimensions. If the target texture coordinate has two dimensions, the third coordinate (z component of an SFVec3f) shall be zero.
 
-#### Warning
+#### Warnings
 
 - If the target object has multiple textures defined, only texture coordinates for the first texture are returned and all other textures are ignored.
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
 
 ### MFVec3f [out] **pickedNormal**
 
 Output event containing surface normal vectors computed by the picking intersection computations.
 
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
+
 ### MFVec3f [out] **pickedPoint**
 
 Output event containing 3D points on surface of underlying pickingGeometry computed by the picking intersection computations, given in the local coordinate 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.
+
 ### SFNode [in, out] **pickingGeometry** NULL <small>[IndexedLineSet|LineSet]</small>
 
 *pickingGeometry* specifies the exact geometry coordinates that are used to perform the intersection testing of the picking operation.
@@ -105,14 +123,20 @@ Output event containing 3D points on surface of underlying pickingGeometry compu
 
 Output event containing the node or nodes that have been found to intersect with the picking geometry from the last time this node performed a picking operation, given in the local coordinate system.
 
-## 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
 
 - Sort order for line picking is based on each pair of coordinates that defining a line segment, with first declared vertex of the segment defined to be the start of the line to which the intersection points are closest.
+- [When the picking line segment intersects a coplanar polygon, computed intersection point(s) are illustrated in Figure 38.1](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/picking.html#f-LineIntersection){:target="_blank"}
 - Picking is performed between rendered frames of the event model. An author sets up the picking request in one frame by placing a LinePickSensor in the desired location. At the start of the next frame, any picking intersections are reported by the pick sensor.
 - Picking notification is performed at the start of the frame for all enabled pick sensors once all other sensors are processed.
-- IndexedLineSet or LineSet can be used for pickingGeometry node.
+- [Event timing details are explained in X3D Specification 4.4.8.3 Execution model](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/concepts.html#ExecutionModel){:target="_blank"}
+- IndexedLineSet or Lineset can be used for pickingGeometry node.
 
 ### Warning
 
@@ -122,8 +146,6 @@ Output event containing the node or nodes that have been found to intersect with
 
 <x3d-canvas src="https://create3000.github.io/media/examples/Picking/LinePickSensor/LinePickSensor.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of LinePickSensor](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/picking.html#LinePickSensor){:target="_blank"}
-- [When the picking line segment intersects a coplanar polygon, computed intersection point(s) are illustrated in Figure 38.1](https://www.web3d.org/files/specifications/19775-1/V3.3/Part01/components/picking.html#f-LineIntersection){:target="_blank"}
-- [Event timing details are explained in 4.4.8.3 Execution model](https://www.web3d.org/files/specifications/19775-1/V3.3/Part01/concepts.html#ExecutionModel){:target="_blank"}
+- [X3D Specification of LinePickSensor node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/picking.html#LinePickSensor){:target="_blank"}

package/docs/_posts/components/Picking/PickableGroup.md

@@ -1,6 +1,6 @@
 ---
 title: PickableGroup
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Picking
 categories: [components, Picking]
 tags: [PickableGroup, Picking]
@@ -15,7 +15,7 @@ tags: [PickableGroup, Picking]
 
 PickableGroup is a Grouping node that can contain most nodes. PickableGroup contains children that are marked as having a given classification of picking types, and can also enable or disable picking of the children.
 
-The PickableGroup node belongs to the **Picking** component and its default container field is *children.* It is available since X3D version 3.2 or later.
+The PickableGroup node belongs to the **Picking** component and its default container field is *children.* It is available from X3D version 3.2 or higher.
 
 ## Hierarchy
 
@@ -32,36 +32,41 @@ The PickableGroup node belongs to the **Picking** component and its default cont
 
 ### 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
 
-The pickable field determines whether pick traversal is performed on this node or its children.
+The *pickable* field determines whether pick traversal is performed on this node or its children.
 
 #### Hint
 
-- Pickable only affects children accessed through the transformation hierarchy of the parent.
+- *pickable* only affects children accessed through the transformation hierarchy of the parent.
 
 #### Warning
 
-- If one or more of the children of this instance is accessible through another transformation hierarchy through DEF/USE that still has picking enabled, they are still pickable through that path only.
+- If one or more of the children of this instance is accessible through another transformation hierarchy through DEF/USE that still has picking enabled, they are still *pickable* through that path only.
 
 ### 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.
 
-#### Hint
+#### Hints
 
-- The visible field has no effect on animation behaviors, event passing or other non-visual characteristics.
-- Content must be visible to be collidable and to be pickable.
+- The *visible* field has no effect on animation behaviors, event passing or other non-visual characteristics.
+- Content must be *visible* to be collidable and to be pickable.
 
 ### SFBool [in, out] **bboxDisplay** FALSE
 
@@ -75,36 +80,49 @@ 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>
 
-Grouping nodes contain a list of children nodes.
+Grouping nodes contain an ordered list of *children* nodes.
 
-#### Hint
+#### 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.
+- Each grouping node defines a coordinate space for its *children*, relative to the coordinate space of its parent node. Thus transformations accumulate down the scene graph hierarchy.
+- InputOnly MFNode addChildren field can append new X3DChildNode nodes via a ROUTE connection, duplicate input nodes (i.e. matching DEF, USE values) are ignored.
+- InputOnly MFNode removeChildren field can remove nodes from the *children* list, unrecognized input nodes (i.e. nonmatching DEF, USE values) are ignored.
+- [X3D Architecture 10.2.1 Grouping and *children* node types](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/grouping.html#GroupingAndChildrenNodes){:target="_blank"}
 
-## Description
+## Advisories
 
-### Hint
+### Hints
 
 - Insert a Shape node before adding geometry or Appearance.
+- Content must be visible to be collidable and to be pickable.
 
-## External Links
+## See Also
 
-- [X3D Specification of PickableGroup](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/picking.html#PickableGroup){:target="_blank"}
+- [X3D Specification of PickableGroup node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/picking.html#PickableGroup){:target="_blank"}

package/docs/_posts/components/Picking/PointPickSensor.md

@@ -1,6 +1,6 @@
 ---
 title: PointPickSensor
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Picking
 categories: [components, Picking]
 tags: [PointPickSensor, Picking]
@@ -15,7 +15,7 @@ tags: [PointPickSensor, Picking]
 
 PointPickSensor tests one or more pickingGeometry points in space as lying inside the provided pickTarget geometry. For each pickingGeometry PointSet coordinate point that lies inside the pickTarget geometry, a pickedPoint coordinate is returned along with a corresponding pickedGeometry node inside which the point lies.
 
-The PointPickSensor node belongs to the **Picking** component and its default container field is *children.* It is available since X3D version 3.2 or later.
+The PointPickSensor node belongs to the **Picking** component and its default container field is *children.* It is available from X3D version 3.2 or higher.
 
 ## Hierarchy
 
@@ -31,7 +31,11 @@ The PointPickSensor node belongs to the **Picking** component and its default co
 
 ### 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,11 +43,12 @@ Enables/disables node operation.
 
 ### 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 of the corresponding PickableGroup 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".
 
 ### SFString [in, out] **matchCriterion** "MATCH_ANY" <small>["MATCH_ANY"|"MATCH_EVERY"|"MATCH_ONLY_ONE"]</small>
 
@@ -55,7 +60,7 @@ Defines whether the intersection test (i.e. pick) by this X3DPickSensorNode must
 
 #### Hint
 
-- IntersectionType constants may be extended by the browser to provide additional options.
+- *intersectionType* constants may be extended by the browser to provide additional options.
 
 #### Warning
 
@@ -63,7 +68,7 @@ Defines whether the intersection test (i.e. pick) by this X3DPickSensorNode must
 
 ### SFString [ ] **sortOrder** "CLOSEST" <small>["CLOSEST"|"ALL"|"ALL_SORTED"]</small>
 
-The sortOrder field determines the order provided for picked output events.
+The *sortOrder* field determines the order provided for picked output events. Example: ANY means any single object that can satisfy picking conditions for this pick sensor. Consistency of results is not guaranteed. Example: ALL means that every object that satisfies the picking conditions for this pick sensor shall be returned. Example: ALL_SORTED means that every object that satisfies the picking conditions for this pick sensor shall be returned with the order of the output fields provided in a distance-sorted order from closest to farthest away. The exact algorithm for sorting is defined by the individual node definitions. Example: CLOSEST means that the closest object by distance that satisfies the conditions of this pick sensor. *The exact algorithm for distance determination shall be defined by individual node definitions*.
 
 #### Hint
 
@@ -75,12 +80,20 @@ The sortOrder field determines the order provided for picked output events.
 
 ### SFBool [out] **isActive**
 
-*isActive* indicates when the intersecting object is picked by the picking geometry. Output event isActive=true gets sent once a picked item is found. Output event isActive=false gets sent once no picked item is found.
+*isActive* indicates when the intersecting object is picked by the picking geometry. Output event *isActive*=true gets sent once a picked item is found. Output event *isActive*=false gets sent once no picked item is found.
+
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
 
 ### MFVec3f [out] **pickedPoint**
 
 Output event containing 3D points on surface of underlying pickingGeometry computed by the picking intersection computations, given in the local coordinate 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.
+
 ### SFNode [in, out] **pickingGeometry** NULL <small>[PointSet]</small>
 
 *pickingGeometry* specifies the exact geometry coordinates that are used to perform the intersection testing of the picking operation.
@@ -93,13 +106,18 @@ Output event containing 3D points on surface of underlying pickingGeometry compu
 
 Output event containing the node or nodes that have been found to intersect with the picking geometry from the last time this node performed a picking operation, given in the local coordinate system.
 
-## 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
 
 - Because points represent an infinitely small location in space, sortOrder values CLOSEST and ALL_SORTED are defined to mean ANY and ALL respectively.
 - Picking is performed between rendered frames of the event model. An author sets up the picking request in one frame by placing a LinePickSensor in the desired location. At the start of the next frame, any picking intersections are reported by the pick sensor.
 - Picking notification is performed at the start of the frame for all enabled pick sensors once all other sensors are processed.
+- [Event timing details are explained in X3D Specification 4.4.8.3 Execution model](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/concepts.html#ExecutionModel){:target="_blank"}
 - PointSet can be used for pickingGeometry node.
 
 ### Warning
@@ -110,7 +128,6 @@ Output event containing the node or nodes that have been found to intersect with
 
 <x3d-canvas src="https://create3000.github.io/media/examples/Picking/PointPickSensor/PointPickSensor.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of PointPickSensor](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/picking.html#PointPickSensor){:target="_blank"}
-- [Event timing details are explained in 4.4.8.3 Execution model](https://www.web3d.org/files/specifications/19775-1/V3.3/Part01/concepts.html#ExecutionModel){:target="_blank"}
+- [X3D Specification of PointPickSensor node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/picking.html#PointPickSensor){:target="_blank"}