Detects when the user has pointed at a specific piece of geometry. More...
#include <Inventor/geo/SoVRMLGeoTouchSensor.h>
Public Member Functions | |
virtual SoType | getTypeId () const |
SoVRMLGeoTouchSensor () | |
Static Public Member Functions | |
static SoType | getClassTypeId () |
Public Attributes | |
SoSFNode | geoOrigin |
SoMFString | geoSystem |
SoSFVec3f | hitGeoCoord_changed |
SoMFString | hitGeoCoordString_changed |
The SoVRMLGeoTouchSensor node tracks the location and state of a pointing device and detects when the user points at geometry contained by the parent group of the GeoTouchSensor. This node provides the same functionality as a TouchSensor but also provides the ability to return the geographic coordinate under the pointing device.
This section may reference portions of the X3D specification that are not present in this help file. The complete X3D spec is available at http://www.web3d.org .
The SoVRMLGeoTouchSensor node tracks the location and state of a pointing device and detects when the user points at geometry contained by the parent group of the GeoTouchSensor. This node provides the same functionality as a TouchSensor but also provides the ability to return the geographic coordinate under the pointing device. The description field in the GeoTouchSensor node specifies a textual description of the GeoTouchSensor node. This may be used by browser-specific user interfaces that wish to present users with more detailed information about the GeoTouchSensor. A SoVRMLGeoTouchSensor can be enabled or disabled by sending an event of value TRUE or FALSE to the enabled field. A disabled GeoTouchSensor does not track user input or send events. The geoOrigin field is used to specify a local coordinate frame for extended precision as described in 25.2.5 Dealing with high-precision coordinates. The geoSystem field is used to define the spatial reference frame and is described in 25.2.3 Specifying a spatial reference frame. The fields hitNormal_changed, hitPoint_changed, hitTexCoord_changed, isActive, isOver, and touchTime all have the same meaning as in the TouchSensor node. The hitGeoCoord_changed field is generated while the pointing device is pointing towards the SoVRMLGeoTouchSensor's geometry (i.e., when isOver is TRUE). It is a field containing the geospatial coordinate for the point of intersection between the pointing device's location and the underlying geometry. The value of the geoSystem string defines the spatial reference frame of the geospatial coordinate. For example, given the default geoSystem value of "GD", the hitGeoCoord_changed field will be in the format
<latitude> <longitude> <elevation>
(see 25.2.4 Specifying geospatial coordinates). The hitGeoCoordString_changed is the MFString equivalent of hitGeoCoord_changed.
enabled | TRUE |
description | "" |
metadata | NULL |
geoOrigin | NULL |
geoSystem | ["GD","WE"] |
SoSFBool | set_enabled |
SoSFBool | set_description |
SoSFNode | set_metadata |
SoSFString | description_changed |
SoSFBool | enabled_changed |
SoSFVec3f | hitNormal_changed |
SoSFVec3f | hitPoint_changed |
SoSFVec2f | hitTexCoord_changed |
SoSFVec2f | hitGeoCoord_changed |
SoMFString | hitGeoCoordString_changed |
SoSFBool | isActive |
SoSFBool | isOver (Note: Not implemented) |
SoSFTime | touchTime |
SoSFNode | metadata_changed |
SoVRMLGeoTouchSensor::SoVRMLGeoTouchSensor | ( | ) |
Constructor.
static SoType SoVRMLGeoTouchSensor::getClassTypeId | ( | ) | [static] |
Returns the type identifier for this class.
Reimplemented from SoVRMLTouchSensor.
virtual SoType SoVRMLGeoTouchSensor::getTypeId | ( | ) | const [virtual] |
Returns the type identifier for this specific instance.
Reimplemented from SoVRMLTouchSensor.
An SoVRMLGeoOrigin node specifying the origin of the local coordinate system.
Defines the spatial reference frame.
Valid values are:
Output event sent when cursor on shape.
Output event sent when cursor on shape.