x_ite 8.4.3 → 8.5.3

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

@@ -0,0 +1,114 @@
+---
+title: PrimitivePickSensor
+date: 2022-01-07
+nav: components-Picking
+categories: [components, Picking]
+tags: [PrimitivePickSensor, Picking]
+---
+<style>
+.post h3 {
+  word-spacing: 0.2em;
+}
+</style>
+
+## Overview
+
+PrimitivePickSensor tests picking intersections using one of the basic primitive shapes specified in the pickingGeometry field [Cone|Cylinder|Sphere|Box] against the pickTarget geometry.
+
+The PrimitivePickSensor 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
+        + PrimitivePickSensor
+```
+
+## 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>[Cone|Cylinder|Sphere|Box]</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.
+
+## Description
+
+### Example
+
+- A Cylinder without end caps is still treated as an enclosed Cylinder.
+
+### Hints
+
+- Sorting is defined based on the primitive type as follows. For Cone, the closest picked primitive is defined to be that closest to the vertex point. For Cylinder, Box, and Sphere, the closest picked primitive is defined to be that closest to the center.
+- 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.
+- Box, Cone, Cylinder or Sphere can be used for pickingGeometry node.
+
+### Warnings
+
+- Boolean fields used to control visibility of primitive pickingGeometry subsections are ignored when evaluating picking intersections.
+- 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/PrimitivePickSensor/PrimitivePickSensor.x3d"></x3d-canvas>
+
+## External Links
+
+- [X3D Specification of PrimitivePickSensor](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/picking.html#PrimitivePickSensor){: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"}
+- A Cylinder without end caps is still treated as an enclosed Cylinder.

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

@@ -0,0 +1,107 @@
+---
+title: VolumePickSensor
+date: 2022-01-07
+nav: components-Picking
+categories: [components, Picking]
+tags: [VolumePickSensor, Picking]
+---
+<style>
+.post h3 {
+  word-spacing: 0.2em;
+}
+</style>
+
+## Overview
+
+VolumePickSensor tests picking intersections using the pickingGeometry against the pickTarget geometry volume.
+
+The VolumePickSensor 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
+        + VolumePickSensor
+```
+
+## 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>[X3DGeometryNode]</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.
+
+## Description
+
+### Hints
+
+- Sort order is based on distance between centers of the bounds of the picking geometry and the picked geometry.
+- A pick is successful if any vertex of the pickTarget geometry intersects the volume defined by the pickingGeometry.
+- Sorting is defined based on distance between the centers of the bounds of the picking geometry and the picked geometry.
+- 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.
+- Any geometry can be used for pickingGeometry node.
+
+### Warnings
+
+- PickingGeometry volume is defined by the convex hull of the enclosing planes of the provided X3DGeometryNode. If the provided volume is not manifold, pick results are undefined.
+- Order of contained nodes is significant, single pickingGeometry node must precede pickTarget node array.
+
+## External Links
+
+- [X3D Specification of VolumePickSensor](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/picking.html#VolumePickSensor){: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/PointingDeviceSensor/CylinderSensor.md

@@ -0,0 +1,122 @@
+---
+title: CylinderSensor
+date: 2022-01-07
+nav: components-PointingDeviceSensor
+categories: [components, PointingDeviceSensor]
+tags: [CylinderSensor, PointingDeviceSensor]
+---
+<style>
+.post h3 {
+  word-spacing: 0.2em;
+}
+</style>
+
+## Overview
+
+CylinderSensor converts pointer motion (for example, a mouse or wand) into rotation values using an invisible cylinder aligned with local Y-axis.
+
+The CylinderSensor node belongs to the **PointingDeviceSensor** component and its default container field is *children.* It is available since X3D version 3.0 or later.
+
+## Hierarchy
+
+```
++ X3DNode
+  + X3DChildNode
+    + X3DSensorNode
+      + X3DPointingDeviceSensorNode
+        + X3DDragSensorNode
+          + CylinderSensor
+```
+
+## 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.
+
+### SFString [in, out] **description** ""
+
+Author-provided text tooltip that tells users the expected action of this node.
+
+#### Hints
+
+- Use spaces, make descriptions clear and readable. Many XML tools substitute XML character references automatically if needed (such as &amp;#38; for &amp; ampersand, or &amp;#34; for " quotation mark).
+
+### SFRotation [in, out] **axisRotation** 0 0 1 0
+
+*axisRotation* determines local sensor coordinate system by rotating the local coordinate system.
+
+### SFFloat [in, out] **diskAngle** 0.261792 <small>[0,π/2]</small>
+
+Help decide rotation behavior from initial relative bearing of pointer drag: acute angle whether cylinder sides or end-cap disks of virtual-geometry sensor are used for manipulation.
+
+#### Hint
+
+- DiskAngle 0 forces disk-like behavior, diskAngle 1.570796 (90 degrees) forces cylinder-like behavior.
+
+### SFFloat [in, out] **minAngle** 0 <small>[-2π,2π]</small>
+
+Clamps rotation_changed events within range of min/max values
+
+#### Hint
+
+- If minAngle \> maxAngle, rotation is not clamped.
+
+### SFFloat [in, out] **maxAngle** -1 <small>[-2π,2π]</small>
+
+Clamps rotation_changed events within range of min/max values
+
+#### Hint
+
+- If minAngle \> maxAngle, rotation is not clamped.
+
+### SFFloat [in, out] **offset** 0 <small>(-∞,∞)</small>
+
+Sends event and remembers last value sensed.
+
+#### Warning
+
+- ROUTE connecting rotation_changed to set_offset creates a self-reinforcing positive feedback loop and results in unmanageable response.
+
+### SFBool [in, out] **autoOffset** TRUE
+
+Determines whether previous offset values are remembered/accumulated.
+
+### SFVec3f [out] **trackPoint_changed**
+
+*trackPoint_changed* events give intersection point of bearing with sensor's virtual geometry.
+
+### SFRotation [out] **rotation_changed**
+
+*rotation_changed* events equal sum of relative bearing changes plus offset value about Y-axis in local coordinate system.
+
+### SFBool [out] **isOver**
+
+Hover over geometry by aiming the mouse (or pointing device) to generate isOver events. Sensor sends output event isOver=true event when pointing device moves over sensor's geometry, and later sends output event isOver=false event when pointing device moves off.
+
+### SFBool [out] **isActive**
+
+Select geometry by activating the pointing device (e.g. clicking the mouse) to generate isActive events. Output event isActive=true is sent when geometry is selected (e.g. when primary mouse button is pressed), output event isActive=false is sent when geometry is deselected (e.g. when primary mouse button is released).
+
+## Description
+
+### Hints
+
+- This sensor detects user interactions affecting peer nodes and their child geometry.
+- Add semi-transparent surrounding geometry to see the effect of the sensor.
+- Initial relative bearing of pointer drag determines whether cylinder sides or end-cap disks are used for manipulation.
+
+## Example
+
+<x3d-canvas src="https://create3000.github.io/media/examples/PointingDeviceSensor/CylinderSensor/CylinderSensor.x3d"></x3d-canvas>
+
+## External Links
+
+- [X3D Specification of CylinderSensor](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/pointingDeviceSensor.html#CylinderSensor){:target="_blank"}
+- [See X3D Specification 20.2.1 Overview of pointing device sensors](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/pointingDeviceSensor.html#OverviewOfPointingDeviceSensors){:target="_blank"}
+- [See X3D Specification 20.2.2 Drag sensors](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/pointingDeviceSensor.html#DragSensors){:target="_blank"}
+- [See X3D Specification 20.2.3 Activating and manipulating pointing device sensors](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/pointingDeviceSensor.html#Activatingandmanipulating){:target="_blank"}

package/docs/_posts/components/PointingDeviceSensor/PlaneSensor.md

@@ -0,0 +1,114 @@
+---
+title: PlaneSensor
+date: 2022-01-07
+nav: components-PointingDeviceSensor
+categories: [components, PointingDeviceSensor]
+tags: [PlaneSensor, PointingDeviceSensor]
+---
+<style>
+.post h3 {
+  word-spacing: 0.2em;
+}
+</style>
+
+## Overview
+
+PlaneSensor converts pointing device motion into 2D translation parallel to the local Z=0 plane.
+
+The PlaneSensor node belongs to the **PointingDeviceSensor** component and its default container field is *children.* It is available since X3D version 3.0 or later.
+
+## Hierarchy
+
+```
++ X3DNode
+  + X3DChildNode
+    + X3DSensorNode
+      + X3DPointingDeviceSensorNode
+        + X3DDragSensorNode
+          + PlaneSensor
+```
+
+## 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.
+
+### SFString [in, out] **description** ""
+
+Author-provided text tooltip that tells users the expected action of this node.
+
+#### Hints
+
+- Use spaces, make descriptions clear and readable. Many XML tools substitute XML character references automatically if needed (such as &amp;#38; for &amp; ampersand, or &amp;#34; for " quotation mark).
+
+### SFRotation [in, out] **axisRotation** 0 0 1 0
+
+*axisRotation* determines local sensor coordinate system by rotating the local coordinate system.
+
+### SFBool [in, out] **autoOffset** TRUE
+
+Determines whether previous offset values are remembered/accumulated.
+
+### SFVec3f [in, out] **offset** 0 0 0 <small>(-∞,∞)</small>
+
+Sends event and remembers last value sensed.
+
+#### Warning
+
+- ROUTE connecting translation_changed to set_offset creates a self-reinforcing positive feedback loop and results in unmanageable response.
+
+### SFVec2f [in, out] **minPosition** 0 0 <small>(-∞,∞)</small>
+
+*minPosition* and maxPosition clamp translations to a range of values measured from origin of Z=0 plane default maxPosition \< minPosition means no clamping.
+
+#### Hint
+
+- Create a LineSensor by constraining one axis (minPosition.x=maxPosition.x) or (minPosition.y=maxPosition.y).
+
+### SFVec2f [in, out] **maxPosition** -1 -1 <small>(-∞,∞)</small>
+
+MinPosition and maxPosition clamp translations to a range of values measured from origin of Z=0 plane default maxPosition \< minPosition means no clamping.
+
+#### Hint
+
+- Create a LineSensor by constraining one axis (minPosition.x=maxPosition.x) or (minPosition.y=maxPosition.y).
+
+### SFVec3f [out] **trackPoint_changed**
+
+*trackPoint_changed* events give intersection point of bearing with sensor's virtual geometry.
+
+### SFVec3f [out] **translation_changed**
+
+*translation_changed* events equal sum of relative translation change plus offset value.
+
+### SFBool [out] **isOver**
+
+Hover over geometry by aiming the mouse (or pointing device) to generate isOver events. Sensor sends output event isOver=true event when pointing device moves over sensor's geometry, and later sends output event isOver=false event when pointing device moves off.
+
+### SFBool [out] **isActive**
+
+Select geometry by activating the pointing device (e.g. clicking the mouse) to generate isActive events. Output event isActive=true is sent when geometry is selected (e.g. when primary mouse button is pressed), output event isActive=false is sent when geometry is deselected (e.g. when primary mouse button is released).
+
+## Description
+
+### Hints
+
+- Create a LineSensor by constraining one axis: (minPosition.x=maxPosition.x) or (minPosition.y=maxPosition.y).
+- This sensor detects user interactions affecting peer nodes and their child geometry.
+- Add semi-transparent surrounding geometry to see the effect of the sensor.
+
+## Example
+
+<x3d-canvas src="https://create3000.github.io/media/examples/PointingDeviceSensor/PlaneSensor/PlaneSensor.x3d"></x3d-canvas>
+
+## External Links
+
+- [X3D Specification of PlaneSensor](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/pointingDeviceSensor.html#PlaneSensor){:target="_blank"}
+- [See X3D Specification 20.2.1 Overview of pointing device sensors](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/pointingDeviceSensor.html#OverviewOfPointingDeviceSensors){:target="_blank"}
+- [See X3D Specification 20.2.2 Drag sensors](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/pointingDeviceSensor.html#DragSensors){:target="_blank"}
+- [See X3D Specification 20.2.3 Activating and manipulating pointing device sensors](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/pointingDeviceSensor.html#Activatingandmanipulating){:target="_blank"}

package/docs/_posts/components/PointingDeviceSensor/SphereSensor.md

@@ -0,0 +1,89 @@
+---
+title: SphereSensor
+date: 2022-01-07
+nav: components-PointingDeviceSensor
+categories: [components, PointingDeviceSensor]
+tags: [SphereSensor, PointingDeviceSensor]
+---
+<style>
+.post h3 {
+  word-spacing: 0.2em;
+}
+</style>
+
+## Overview
+
+SphereSensor converts pointing device motion into a spherical rotation about the origin of the local coordinate system.
+
+The SphereSensor node belongs to the **PointingDeviceSensor** component and its default container field is *children.* It is available since X3D version 3.0 or later.
+
+## Hierarchy
+
+```
++ X3DNode
+  + X3DChildNode
+    + X3DSensorNode
+      + X3DPointingDeviceSensorNode
+        + X3DDragSensorNode
+          + SphereSensor
+```
+
+## 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.
+
+### SFString [in, out] **description** ""
+
+Author-provided text tooltip that tells users the expected action of this node.
+
+#### Hints
+
+- Use spaces, make descriptions clear and readable. Many XML tools substitute XML character references automatically if needed (such as &amp;#38; for &amp; ampersand, or &amp;#34; for " quotation mark).
+
+### SFBool [in, out] **autoOffset** TRUE
+
+Determines whether previous offset values are remembered/accumulated.
+
+### SFRotation [in, out] **offset** 0 0 1 0 <small>[-1,1],(-∞,∞)</small>
+
+Sends event and remembers last value sensed.
+
+#### Warning
+
+- ROUTE connecting rotation_changed to set_offset creates a self-reinforcing positive feedback loop and results in unmanageable response.
+
+### SFVec3f [out] **trackPoint_changed**
+
+*trackPoint_changed* events give intersection point of bearing with sensor's virtual geometry.
+
+### SFRotation [out] **rotation_changed**
+
+*rotation_changed* events equal sum of relative bearing changes plus offset value.
+
+### SFBool [out] **isOver**
+
+Hover over geometry by aiming the mouse (or pointing device) to generate isOver events. Sensor sends output event isOver=true event when pointing device moves over sensor's geometry, and later sends output event isOver=false event when pointing device moves off.
+
+### SFBool [out] **isActive**
+
+Select geometry by activating the pointing device (e.g. clicking the mouse) to generate isActive events. Output event isActive=true is sent when geometry is selected (e.g. when primary mouse button is pressed), output event isActive=false is sent when geometry is deselected (e.g. when primary mouse button is released).
+
+## Description
+
+### Hints
+
+- This sensor detects user interactions affecting peer nodes and their child geometry.
+- Add semi-transparent surrounding geometry to see the effect of the sensor.
+
+## External Links
+
+- [X3D Specification of SphereSensor](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/pointingDeviceSensor.html#SphereSensor){:target="_blank"}
+- [See X3D Specification 20.2.1 Overview of pointing device sensors](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/pointingDeviceSensor.html#OverviewOfPointingDeviceSensors){:target="_blank"}
+- [See X3D Specification 20.2.2 Drag sensors](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/pointingDeviceSensor.html#DragSensors){:target="_blank"}
+- [See X3D Specification 20.2.3 Activating and manipulating pointing device sensors](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/pointingDeviceSensor.html#Activatingandmanipulating){:target="_blank"}

package/docs/_posts/components/PointingDeviceSensor/TouchSensor.md

@@ -0,0 +1,87 @@
+---
+title: TouchSensor
+date: 2022-01-07
+nav: components-PointingDeviceSensor
+categories: [components, PointingDeviceSensor]
+tags: [TouchSensor, PointingDeviceSensor]
+---
+<style>
+.post h3 {
+  word-spacing: 0.2em;
+}
+</style>
+
+## Overview
+
+TouchSensor tracks location and state of the pointing device, detecting when a user points at or selects (activates) geometry.
+
+The TouchSensor node belongs to the **PointingDeviceSensor** component and its default container field is *children.* It is available since X3D version 3.0 or later.
+
+## Hierarchy
+
+```
++ X3DNode
+  + X3DChildNode
+    + X3DSensorNode
+      + X3DPointingDeviceSensorNode
+        + X3DTouchSensorNode
+          + TouchSensor
+```
+
+## 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.
+
+### SFString [in, out] **description** ""
+
+Author-provided text tooltip that tells users the expected action of this node.
+
+#### Hints
+
+- Use spaces, make descriptions clear and readable. Many XML tools substitute XML character references automatically if needed (such as &amp;#38; for &amp; ampersand, or &amp;#34; for " quotation mark).
+
+### SFVec2f [out] **hitTexCoord_changed**
+
+When pointing device selects geometry, send event containing texture coordinates of surface at the hitPoint.
+
+### SFVec3f [out] **hitNormal_changed**
+
+When pointing device selects geometry, send event containing surface normal vector at the hitPoint.
+
+### SFVec3f [out] **hitPoint_changed**
+
+When pointing device selects geometry, send event containing 3D point on surface of underlying geometry, as measured in reference frame for TouchSensor's local coordinate system.
+
+### SFBool [out] **isOver**
+
+Hover over geometry by aiming the mouse (or pointing device) to generate isOver events. Sensor sends output event isOver=true event when pointing device moves over sensor's geometry, and later sends output event isOver=false event when pointing device moves off.
+
+### SFBool [out] **isActive**
+
+Select geometry by activating the pointing device (e.g. clicking the mouse) to generate isActive events. Output event isActive=true is sent when pointing device selection is activated, output event isActive=false is sent when pointing device is deselected.
+
+### SFTime [out] **touchTime**
+
+Time event generated when sensor is touched by pointing device, and then deselected by the user.
+
+#### Hint
+
+- TouchTime event is generated when following three conditions are all met: (a) pointing device was pointing towards geometry when initially activated (isActive=true), (b) pointing device is currently pointing towards the geometry (isOver=true), and (c) pointing device selection is deactivated/deselected by user (isActive=false event is also generated).
+
+## Description
+
+### Hint
+
+- This sensor detects user interactions affecting peer nodes and their child geometry.
+
+## External Links
+
+- [X3D Specification of TouchSensor](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/pointingDeviceSensor.html#TouchSensor){:target="_blank"}
+- [See X3D Specification 20.2.1 Overview of pointing device sensors](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/pointingDeviceSensor.html#OverviewOfPointingDeviceSensors){:target="_blank"}
+- [See X3D Specification 20.2.3 Activating and manipulating pointing device sensors](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/pointingDeviceSensor.html#Activatingandmanipulating){:target="_blank"}