Pointing device sensor component

Contents:

1. Demos

For demos and tests of these features, see the sensors_pointing_device subdirectory inside our VRML/X3D demo models.

2. Supported nodes

• TouchSensor (API reference)

  Catch click events on 3D objects. The main functionality is that it sends touchTime event when the user "clicked" the geometry that is sibling to the sensor. See examples/viewport_and_scenes/listen_on_x3d_events/ for a demo how to handle it in Pascal.

  Full support, including:

  • hitTexCoord_changed event. You should apply some texture on your shape, otherwise texture coordinates will not be geneted (and this event will always generate zero vector).

    Note that it's only a single 2D texture coordinate. If you use volumetric 3D textures (from DDS file), the additional texture coordinate components will be ignored. If you use multi-texturing, the additional texture units (above the first) will be ignored.

  • hitNormal_changed event. Generates nice smooth normals when the shape is smooth (e.g. creaseAngle > 0).

    Note: Normals output by hitNormal_changed are in the shape local coordinate system. Spec doesn't say in which coordinate system they should be, please report if you have any idea what is expected / what other browsers do.

• PlaneSensor (API reference)

  Move geometry by dragging.

  Note: when axisRotation with non-zero rotation is used, trackPoint_changed is generated in local sensor coordinates (with transformation and axisRotation applied), just like translation_changed.

  Note: that axisRotation is still useful, it is not a shortcut for using Transform with rotation around the sensor. Reason: wrapping sensor in a Transform would change it's siblings. So axisRotation is useful under our interpretation.

• SphereSensor (API reference)

Rotate geometry freely by dragging.

• CylinderSensor (API reference)

  Rotate geometry around an axis by dragging.

  Note: See PlaneSensor notes about axisRotation, they apply also here.