com.openinventor.scaleviz.interaction

Class SoControllerReader

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.scaleviz.interaction.SoControllerReader

public class SoControllerReader
extends Inventor

Interface to trackdAPI (buttons, valuators). SoControllerReader is a class that interfaces to trackdAPI. It provides access functions to the states of buttons and valuators of VR input devices, e.g., the buttons and joystick of a wand. SoTrackerReader is instantiated by the SbConfig class, if the configuration file specifies the use of a tracking system (by providing shared memory keys). See SbConfig.getControllerReader.

NOTE: trackd from VRCO (www.vrco.com) is not included with Open Inventor. If trackd exists on the system, Open Inventor will dynamically load it at run time. See trackd documentation for information about the values returned.

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

Constructor and Description
SoControllerReader(int name_10509) Constructor.

Method Summary

Modifier and Type	Method and Description
int	buttonChange(int id) Returns information about changes of the state of the button identified by id.
int	getButton(int id) Returns the value of button identified by id from the tracker daemon.
int	getNumberOfButtons() Returns the number of buttons the tracker daemon is storing.
int	getNumberOfValuators() Returns the number of valuators the tracker daemon is storing.
float	getValuator(int id) Returns value of the valuator identified by id from the tracker daemon.
boolean	isInitSuccess() Returns true if Inventor was able to retrieve all the trackdAPI functions.
boolean	isLoadSuccess() Returns true if libtrackd.so was loaded successfully.

Methods inherited from class com.openinventor.inventor.Inventor

dispose, getAddress, getNativeResourceHandle, startInternalThreads, stopInternalThreads

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SoControllerReader

public SoControllerReader(int name_10509)

Constructor. The argument passed to the constructor is the shared memory key used by trackd. The constructor dynamically loads trackdAPI into memory, and gets the necessary function addresses.

Method Detail

isInitSuccess

public boolean isInitSuccess()

Returns true if Inventor was able to retrieve all the trackdAPI functions.

getButton

public int getButton(int id)

Returns the value of button identified by id from the tracker daemon.

buttonChange

public int buttonChange(int id)

Returns information about changes of the state of the button identified by id. The function returns 0 if the state of the button hasn't changed, returns -1, if the button was released, returns 1, if the button was pressed.

getValuator

public float getValuator(int id)

Returns value of the valuator identified by id from the tracker daemon.

getNumberOfButtons

public int getNumberOfButtons()

Returns the number of buttons the tracker daemon is storing.

getNumberOfValuators

public int getNumberOfValuators()

Returns the number of valuators the tracker daemon is storing.

isLoadSuccess

public boolean isLoadSuccess()

Returns true if libtrackd.so was loaded successfully.