x_ite 8.4.3 → 8.5.3

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

@@ -0,0 +1,94 @@
+---
+title: PolylineEmitter
+date: 2022-01-07
+nav: components-ParticleSystems
+categories: [components, ParticleSystems]
+tags: [PolylineEmitter, ParticleSystems]
+---
+<style>
+.post h3 {
+  word-spacing: 0.2em;
+}
+</style>
+
+## Overview
+
+PolylineEmitter emits particles along a single polyline. The coordinates for the line along which particles should be randomly generated are taken from a combination of the coord and coordIndex fields. The starting point for generating particles is randomly distributed along this line and given the initial speed and direction.
+
+The PolylineEmitter node belongs to the **ParticleSystems** component and its default container field is *emitter.* It is available since X3D version 3.2 or later.
+
+## Hierarchy
+
+```
++ X3DNode
+  + X3DParticleEmitterNode
+    + PolylineEmitter
+```
+
+## Fields
+
+### 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.
+
+### SFVec3f [in, out] **direction** 0 1 0 <small>[-1,1]</small>
+
+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.
+
+### SFFloat [in, out] **variation** 0.25 <small>[0,∞)</small>
+
+Multiplier for the randomness used to control the range of possible output values. The bigger the value, the more random the output and the bigger the range of possible initial values possible.
+
+#### Hint
+
+- 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).
+
+#### Hint
+
+- Mass is needed if gravity or other force-related calculations are performed per-particle.
+
+### SFFloat [ ] **surfaceArea** 0 <small>[0,∞)</small>
+
+Particle surface area in area base units (default is meters squared). Surface area is used for calculations such as wind effects per particle.
+
+#### 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).
+
+### MFInt32 [in, out] **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
+
+- If no coordinates are available, PolylineEmitter acts like a point source located at local origin.
+
+### SFNode [in, out] **coord** NULL <small>[X3DCoordinateNode]</small>
+
+*coord*inates for the line along which particles are randomly generated.
+
+#### Warning
+
+- If no coordinates are available, PolylineEmitter acts like a point source located at local origin.
+
+## Description
+
+### Hint
+
+- If no coordinates are available, PolylineEmitter acts like a point source located at local origin.
+
+## Example
+
+<x3d-canvas src="https://create3000.github.io/media/examples/ParticleSystems/PolylineEmitter/PolylineEmitter.x3d"></x3d-canvas>
+
+## External Links
+
+- [X3D Specification of PolylineEmitter](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/particleSystems.html#PolylineEmitter){:target="_blank"}

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

@@ -0,0 +1,90 @@
+---
+title: SurfaceEmitter
+date: 2022-01-07
+nav: components-ParticleSystems
+categories: [components, ParticleSystems]
+tags: [SurfaceEmitter, ParticleSystems]
+---
+<style>
+.post h3 {
+  word-spacing: 0.2em;
+}
+</style>
+
+## Overview
+
+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.
+
+## Hierarchy
+
+```
++ X3DNode
+  + X3DParticleEmitterNode
+    + SurfaceEmitter
+```
+
+## Fields
+
+### 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.
+
+### SFFloat [in, out] **speed** 0 <small>[0,∞)</small>
+
+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>
+
+Multiplier for the randomness used to control the range of possible output values. The bigger the value, the more random the output and the bigger the range of possible initial values possible.
+
+#### Hint
+
+- 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).
+
+#### Hint
+
+- Mass is needed if gravity or other force-related calculations are performed per-particle.
+
+### SFFloat [ ] **surfaceArea** 0 <small>[0,∞)</small>
+
+Particle surface area in area base units (default is meters squared). Surface area is used for calculations such as wind effects per particle.
+
+#### 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).
+
+### SFNode [ ] **surface** NULL <small>[X3DGeometryNode]</small>
+
+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.
+
+#### Warning
+
+- Only valid geometry shall be used.
+
+## Description
+
+### Hint
+
+- Ff surface is not solid (solid=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.
+
+## Example
+
+<x3d-canvas src="https://create3000.github.io/media/examples/ParticleSystems/SurfaceEmitter/SurfaceEmitter.x3d"></x3d-canvas>
+
+## External Links
+
+- [X3D Specification of SurfaceEmitter](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/particleSystems.html#SurfaceEmitter){:target="_blank"}

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

@@ -0,0 +1,90 @@
+---
+title: VolumeEmitter
+date: 2022-01-07
+nav: components-ParticleSystems
+categories: [components, ParticleSystems]
+tags: [VolumeEmitter, ParticleSystems]
+---
+<style>
+.post h3 {
+  word-spacing: 0.2em;
+}
+</style>
+
+## Overview
+
+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.
+
+## Hierarchy
+
+```
++ X3DNode
+  + X3DParticleEmitterNode
+    + VolumeEmitter
+```
+
+## Fields
+
+### 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.
+
+### SFBool [ ] **internal** TRUE
+
+TODO, X3D specification is undefined.
+
+### SFVec3f [in, out] **direction** 0 1 0 <small>[-1,1]</small>
+
+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.
+
+### SFFloat [in, out] **variation** 0.25 <small>[0,∞)</small>
+
+Multiplier for the randomness used to control the range of possible output values. The bigger the value, the more random the output and the bigger the range of possible initial values possible.
+
+#### Hint
+
+- 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).
+
+#### Hint
+
+- Mass is needed if gravity or other force-related calculations are performed per-particle.
+
+### SFFloat [ ] **surfaceArea** 0 <small>[0,∞)</small>
+
+Particle surface area in area base units (default is meters squared). Surface area is used for calculations such as wind effects per particle.
+
+#### 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).
+
+### MFInt32 [in, out] **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.
+
+### SFNode [in, out] **coord** NULL <small>[X3DCoordinateNode]</small>
+
+*coord*inates for the geometry used as the emitting volume.
+
+## Description
+
+### Hint
+
+- Otherwise, a VolumeEmitter node acts like a PolylineEmitter node.
+
+## Example
+
+<x3d-canvas src="https://create3000.github.io/media/examples/ParticleSystems/VolumeEmitter/VolumeEmitter.x3d"></x3d-canvas>
+
+## External Links
+
+- [X3D Specification of VolumeEmitter](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/particleSystems.html#VolumeEmitter){:target="_blank"}

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

@@ -0,0 +1,68 @@
+---
+title: WindPhysicsModel
+date: 2022-01-07
+nav: components-ParticleSystems
+categories: [components, ParticleSystems]
+tags: [WindPhysicsModel, ParticleSystems]
+---
+<style>
+.post h3 {
+  word-spacing: 0.2em;
+}
+</style>
+
+## Overview
+
+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.
+
+## Hierarchy
+
+```
++ X3DNode
+  + X3DParticlePhysicsModelNode
+    + WindPhysicsModel
+```
+
+## Fields
+
+### 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.
+
+### SFBool [in, out] **enabled** TRUE
+
+Enables/disables node operation.
+
+### SFVec3f [in, out] **direction** 0 0 0 <small>(∞,∞)</small>
+
+*direction* in which wind is travelling in the form of a normalized, unit vector.
+
+### 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.
+
+### SFFloat [in, out] **gustiness** 0.1 <small>[0,∞)</small>
+
+*gustiness* specifies how much wind speed varies from the average speed.
+
+#### Hint
+
+- Wind speed variation is calculated once per frame and applied equally to all particles.
+
+### SFFloat [in, out] **turbulence** 0 <small>[0,1]</small>
+
+*turbulence* field specifies how much the wind acts directly in line with the direction, and how much variation is applied in directions other than the wind direction.
+
+#### Hint
+
+- 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"></x3d-canvas>
+
+## External Links
+
+- [X3D Specification of WindPhysicsModel](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/particleSystems.html#WindPhysicsModel){:target="_blank"}

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

@@ -0,0 +1,125 @@
+---
+title: LinePickSensor
+date: 2022-01-07
+nav: components-Picking
+categories: [components, Picking]
+tags: [LinePickSensor, Picking]
+---
+<style>
+.post h3 {
+  word-spacing: 0.2em;
+}
+</style>
+
+## Overview
+
+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.
+
+## Hierarchy
+
+```
++ X3DNode
+  + X3DChildNode
+    + X3DSensorNode
+      + X3DPickSensorNode
+        + LinePickSensor
+```
+
+## Fields
+
+### 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.
+
+### SFBool [in, out] **enabled** TRUE
+
+Enables/disables node operation.
+
+### 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.
+
+### 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.
+
+#### Hints
+
+- Authors may define any value for objectType. MFString arrays can have multiple values, so "separate each individual string" "by using quote marks".
+
+### 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.
+
+### MFNode [in, out] **pickTarget** [ ] <small>[X3DGroupingNode|X3DShapeNode|Inline]</small>
+
+*pickTarget* specifies the list of nodes against which picking operations are performed. All nodes declared in this field and their descendents are evaluated for intersections.
+
+### MFNode [out] **pickedGeometry**
+
+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.
+
+### SFString [ ] **intersectionType** "BOUNDS" <small>["GEOMETRY"|"BOUNDS"|...]</small>
+
+*intersectionType* specifies precision of the collision computation.
+
+#### Hint
+
+- IntersectionType constants may be extended by the browser to provide additional options.
+
+#### Warning
+
+- Do not wrap extra quotation marks around these SFString enumeration values, since "quotation" "marks" are only used for MFString values.
+
+### SFString [ ] **sortOrder** "CLOSEST" <small>["ANY"|"CLOSEST"|"ALL"|"ALL_SORTED"]</small>
+
+The sortOrder field determines the order provided for picked output events.
+
+#### Hint
+
+- Browser implementations may define additional values and algorithms beyond these four required values.
+
+#### Warning
+
+- Do not wrap extra quotation marks around these SFString enumeration values, since "quotation" "marks" are only used for MFString values.
+
+### MFVec3f [out] **pickedNormal**
+
+Output event containing surface normal vectors computed by the picking intersection computations.
+
+### 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.
+
+### 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
+
+- If the target object has multiple textures defined, only texture coordinates for the first texture are returned and all other textures are ignored.
+
+## Description
+
+### 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.
+- 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.
+
+### Warning
+
+- Order of contained nodes is significant, single pickingGeometry node must precede pickTarget node array.
+
+## Example
+
+<x3d-canvas src="https://create3000.github.io/media/examples/Picking/LinePickSensor/LinePickSensor.x3d"></x3d-canvas>
+
+## External Links
+
+- [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"}

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

@@ -0,0 +1,93 @@
+---
+title: PickableGroup
+date: 2022-01-07
+nav: components-Picking
+categories: [components, Picking]
+tags: [PickableGroup, Picking]
+---
+<style>
+.post h3 {
+  word-spacing: 0.2em;
+}
+</style>
+
+## Overview
+
+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.
+
+## Hierarchy
+
+```
++ X3DNode
+  + X3DChildNode
+    + X3DGroupingNode
+      + PickableGroup (X3DPickableObject)*
+```
+
+<small>\* Derived from multiple interfaces.</small>
+
+## Fields
+
+### 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.
+
+### SFBool [in, out] **pickable** TRUE
+
+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.
+
+#### 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.
+
+### 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.
+
+#### Hints
+
+- Authors may define any value for objectType. MFString arrays can have multiple values, so "separate each individual string" "by using quote marks".
+
+### 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.
+
+#### Hint
+
+- Can be useful for collision computations or inverse-kinematics (IK) engines.
+
+### SFVec3f [ ] **bboxCenter** 0 0 0 <small>(-∞,∞)</small>
+
+Bounding box center: optional hint for position offset from origin of local coordinate system.
+
+### MFNode [in] **addChildren**
+
+Input field addChildren.
+
+### MFNode [in] **removeChildren**
+
+Input field removeChildren.
+
+### MFNode [in, out] **children** [ ] <small>[X3DChildNode]</small>
+
+Grouping nodes contain a list of children nodes.
+
+#### Hint
+
+- 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.
+
+## Description
+
+### Hint
+
+- Insert a Shape node before adding geometry or Appearance.
+
+## External Links
+
+- [X3D Specification of PickableGroup](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/picking.html#PickableGroup){:target="_blank"}

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

@@ -0,0 +1,112 @@
+---
+title: PointPickSensor
+date: 2022-01-07
+nav: components-Picking
+categories: [components, Picking]
+tags: [PointPickSensor, Picking]
+---
+<style>
+.post h3 {
+  word-spacing: 0.2em;
+}
+</style>
+
+## Overview
+
+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.
+
+## Hierarchy
+
+```
++ X3DNode
+  + X3DChildNode
+    + X3DSensorNode
+      + X3DPickSensorNode
+        + PointPickSensor
+```
+
+## Fields
+
+### 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.
+
+### SFBool [in, out] **enabled** TRUE
+
+Enables/disables node operation.
+
+### 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.
+
+### 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.
+
+#### Hints
+
+- Authors may define any value for objectType. MFString arrays can have multiple values, so "separate each individual string" "by using quote marks".
+
+### 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.
+
+### MFNode [in, out] **pickTarget** [ ] <small>[X3DGroupingNode|X3DShapeNode|Inline]</small>
+
+*pickTarget* specifies the list of nodes against which picking operations are performed. All nodes declared in this field and their descendents are evaluated for intersections.
+
+### MFNode [out] **pickedGeometry**
+
+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.
+
+### SFString [ ] **intersectionType** "BOUNDS" <small>["GEOMETRY"|"BOUNDS"|...]</small>
+
+*intersectionType* specifies precision of the collision computation.
+
+#### Hint
+
+- IntersectionType constants may be extended by the browser to provide additional options.
+
+#### Warning
+
+- Do not wrap extra quotation marks around these SFString enumeration values, since "quotation" "marks" are only used for MFString values.
+
+### SFString [ ] **sortOrder** "CLOSEST" <small>["CLOSEST"|"ALL"|"ALL_SORTED"]</small>
+
+The sortOrder field determines the order provided for picked output events.
+
+#### Hint
+
+- Browser implementations may define additional values and algorithms beyond these four required values.
+
+#### Warning
+
+- Do not wrap extra quotation marks around these SFString enumeration values, since "quotation" "marks" are only used for MFString values.
+
+### 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.
+
+## Description
+
+### 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.
+- PointSet can be used for pickingGeometry node.
+
+### Warning
+
+- Order of contained nodes is significant, single pickingGeometry node must precede pickTarget node array.
+
+## Example
+
+<x3d-canvas src="https://create3000.github.io/media/examples/Picking/PointPickSensor/PointPickSensor.x3d"></x3d-canvas>
+
+## External Links
+
+- [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"}