Class SoTrackerEvent
SoTrackerEvent
represents 3D position and orientation events in the Open Inventor event model.
A "tracker" is any device whose position and orientation are dynamically tracked in 3D, typically for immersive VR applications. For example: a head tracker. A "controller" is an input device which typically has buttons and/or valuators (e.g. a joystick). Many controllers have an associated tracker. For example, the commonly used "wand" input device has three buttons, a two-axis joystick (two valuators), and an associated tracker.
The virtual method SoEvent.getTrackerInfo() can be used to determine if an event object has associated tracker information. Traditional 2D events like SoMouseButtonEvent
and SoLocation2Event
return NULL. 3D events like SoTrackerEvent
and SoControllerButtonEvent
return their associated tracker information (SbTrackerInfo
).
Many tracker devices generate a continuous stream of position and orientation reports, so strictly speaking there are no "events." Generally Open Inventor classes that recognize the SoTrackerEvent
interpret it as notification of a "significant" change in the tracker position and/or orientation. Processing of SoTrackerEvents may be relatively expensive. For example, a pick operation will usually be done automatically. The application (or other software above Open Inventor) is responsible for deciding when to actually create an SoTrackerEvent
.
- See Also:
-
Nested Class Summary
Nested classes/interfaces inherited from class com.openinventor.inventor.Inventor
Inventor.ConstructorCommand
-
Field Summary
Fields inherited from class com.openinventor.inventor.Inventor
VERBOSE_LEVEL, ZeroHandle
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionGet orientation of associated tracker as a standard Open Inventor rotation (quaternion).Get position of associated tracker in world coordinates.getRay()
Get a ray for picking/intersecting.void
setOrientation
(float x, float y, float z) Set orientation value of associated tracker from Euler angles in radians (using the trackd convention Z*X*Y).void
setOrientation
(SbRotation orientation) Set orientation value of associated tracker from anSbRotation
.void
setOrientation
(SbVec3f axis, float angle) Set orientation value of associated tracker from axis and angle in radians.void
Set position of associated tracker in world coordinates.Returns theSbTrackerInfo
object.Methods inherited from class com.openinventor.inventor.events.SoEvent
getNormalizedPosition, getPosition, getPosition, getPositionFloat, getPositionFloat, getTime, setAltDown, setButton1Down, setCtrlDown, setPosition, setPosition, setShiftDown, setTime, wasAltDown, wasButton1Down, wasCtrlDown, wasShiftDown
Methods inherited from class com.openinventor.inventor.Inventor
dispose, getNativeResourceHandle
-
Constructor Details
-
SoTrackerEvent
public SoTrackerEvent()Constructor.
-
-
Method Details
-
setOrientation
public void setOrientation(float x, float y, float z) Set orientation value of associated tracker from Euler angles in radians (using the trackd convention Z*X*Y). -
trackerInfo
Returns theSbTrackerInfo
object. -
setOrientation
Set orientation value of associated tracker from axis and angle in radians. -
getPosition3
Get position of associated tracker in world coordinates. -
setOrientation
Set orientation value of associated tracker from anSbRotation
. -
setPosition3
Set position of associated tracker in world coordinates. -
getRay
Get a ray for picking/intersecting. This is a convenience function. -
getOrientation
Get orientation of associated tracker as a standard Open Inventor rotation (quaternion).
-