instantreality 1.0

Component:
Geospatial
Status:
fully implemented
Structure type:
concrete
Standard:
X3D3.0

GeoTouchSensor

A GeoTouchSensor 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.

Inheritance

Code

XML encoding
<GeoTouchSensor geoSystem=''GD','WE''
triggerName='Timer'
description=''
enabled='TRUE'
logFeature=''
 />
Classic encoding
GeoTouchSensor {
	geoSystem ["'GD','WE'"]
	triggerName "Timer"
	description ""
	enabled TRUE
	logFeature [""]
}

Interface

Filter: X3D only | Avalon only | All
id Name DataType PartType Default ValueType Description
SFNode geoOrigin SFNode initializeOnly GeoOrigin used to specify a local coordinate frame for extended precision
MFString geoSystem MFString initializeOnly 'GD','WE' used to define the spatial reference frame
SFVec3d hitGeoCoord_changed SFVec3d outputOnly (-inf, inf) generated while the pointing device is pointing towards the GeoTouchSensor'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.
SFVec3f hitNormal_changed SFVec3f outputOnly Events containing surface normal vector at the hitPoint.
SFVec3f hitPoint_changed SFVec3f outputOnly Events containing 3D point on surface of underlying geometry, given in TouchSensor's local coordinate system.
SFVec2f hitTexCoord_changed SFVec2f outputOnly Events containing texture coordinates of surface at the hitPoint.
SFTime touchTime SFTime outputOnly Time event generated when sensor is touched by pointing device.
SFBool isOver SFBool outputOnly Is pointing device over sensor's geometry?
SFNode hitObject_changed SFNode outputOnly The next non-shared hit node's parent of type BoundedNode.
MFVec3f touchPoints_changed MFVec3f outputOnly Events containing all 3D points on surface of underlying geometry, given in Sensor's local coordinate system.
SFString triggerName SFString initializeOnly Timer Name of the dynamic context-slot, which is used by the run-time environment (e.g. Jobs) to trigger the node. Life-Nodes will automatically connect the context-eventOutput to the triggerSlot-eventInput Slot.
SFString description SFString inputOutput Text description to comment the sensor task. Can be used in run-time systems to give usefull feedback to the user and developer
SFBool enabled SFBool inputOutput TRUE Enables/disables the sensor node.
SFBool isActive SFBool outputOnly FALSE isActive true/false events are sent when the sensor gets active
SFTime triggerSlot SFTime inputOnly slot which is used internally to connect a dynamic context-slot which name is set by the triggerName value. Its used automatically to install run-time environment trigger.
MFString logFeature MFString inputOutput state, child, parent, route, eventIn, eventOut controls the logging of changes, state: log state changes (e.g. live), child: log child add/remove, parent: log parent add/remove, route: log route add/remove; eventIn: log receiving of events, eventOut: log sending of events: guiView, runtime system should create node-view, guiEdit: runtime system should create node-editeverything: log everything
SFNode metadata SFNode inputOutput MetadataObject container for payload metadata inside MetadataSet element