com.openinventor.scaleviz.nodes

Class SoTracker

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.misc.SoBase

com.openinventor.inventor.fields.SoFieldContainer

com.openinventor.inventor.nodes.SoNode

com.openinventor.scaleviz.nodes.SoTracker

All Implemented Interfaces:

SafeDisposable

public class SoTracker
extends SoNode

Defines immersive viewing parameters in a MultiPipe configuration file. The SoTracker class is used in ScaleViz configuration file to set various parameters for an immersive, tracked environment. Some of these parameters set objects within the scene graph. The camera position is set initially to defaultCameraPosition. A transform node is inserted in the scene graph after the camera node. This transform node contains the defaultObjectPosition as well as the scaling (computed with) others set tracker information (trackd shared memory keys, head/wand ids...).

File format/default:

Tracker {

defaultCameraPosition	-1,-1,-1
defaultObjectPosition	-1,-1,-1
defaultObjectBoxMaxDim	-1
unitScaleFactor	1.0
server	"0:0"
interEyeDistance	0.0
wandTrackerId	0
headTrackerId	1
wandFile	"wand.iv"
calibrate	-1.0, -1.0, -1.0, -1.0

}

Nested Class Summary

Nested classes/interfaces inherited from class com.openinventor.inventor.Inventor

Inventor.ConstructorCommand

Field Summary

Fields

Modifier and Type	Field and Description
SoMFVec4f	calibrate Optional calibration matrix that converts from actual tracker coordinates to world coordinates.
SoSFVec3f	defaultCameraPosition Initial camera position.
SoSFFloat	defaultObjectBoxMaxDim Radius of a bounding sphere.
SoSFVec3f	defaultObjectPosition Initial scene position.
SoSFInt32	headTrackerId ID of the trackd sensor which should be used to control the head/camera.
SoSFFloat	interEyeDistance Inter-eye distance with respect to the system coordinates.
SoSFString	server Specifies a string used to initialize the connection to the tracking system.
SoSFFloat	unitScaleFactor A factor that will be applied to all position coordinates retrieved from the tracking system.
SoSFFilePathString	wandFile Name of a geometry file that the MultiPipe viewer uses for the wand geometry.
SoSFInt32	wandTrackerId ID of the trackd sensor which should be used to control the wand.

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Constructor Summary

Constructors

Constructor and Description
SoTracker() Constructor.

Method Summary

Modifier and Type	Method and Description
SoControllerReader	getControllerReader() Gets associated controller reader.
SoTrackerReader	getTrackerReader() Gets associated tracker reader.

Methods inherited from class com.openinventor.inventor.nodes.SoNode

affectsState, callback, copy, copy, distribute, doAction, getAlternateRep, getBoundingBox, getByName, getMatrix, getPrimitiveCount, getRenderUnitID, GLRender, GLRenderBelowPath, GLRenderInPath, GLRenderOffPath, grabEventsCleanup, grabEventsSetup, handleEvent, isBoundingBoxIgnoring, isOverride, pick, rayPick, search, setOverride, touch, write

Methods inherited from class com.openinventor.inventor.fields.SoFieldContainer

copyFieldValues, copyFieldValues, enableNotify, fieldsAreEqual, get, getAllFields, getEventIn, getEventOut, getField, getFieldName, hasDefaultValues, isNotifyEnabled, set, setToDefaults

Methods inherited from class com.openinventor.inventor.misc.SoBase

dispose, getEXTERNPROTO, getName, getPROTO, isDisposable, isSynchronizable, setName, setSynchronizable

Methods inherited from class com.openinventor.inventor.Inventor

getAddress, getNativeResourceHandle, startInternalThreads, stopInternalThreads

Methods inherited from class java.lang.Object

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

Field Detail

defaultCameraPosition

public final SoSFVec3f defaultCameraPosition

Initial camera position. This is useful if head tracking will not be used.

defaultObjectPosition

public final SoSFVec3f defaultObjectPosition

Initial scene position. In a CAVE environment, it makes sense to set the default postion to the center of the front wall.

defaultObjectBoxMaxDim

public final SoSFFloat defaultObjectBoxMaxDim

Radius of a bounding sphere. The scene is scaled to fit initially within the sphere. In a CAVE environment, it makes sense to choose a radius equal to half the width of the front screen.

unitScaleFactor

public final SoSFFloat unitScaleFactor

A factor that will be applied to all position coordinates retrieved from the tracking system. Its value depends on the units the tracking system is using, and on the units that are appropriate in the Open Inventor world.

Example: The tracking system is in feet and it makes sense for Open Inventor to have inches; the unitScaleFactor should be 12.0. The default value is 1.0.

server

public final SoSFString server

Specifies a string used to initialize the connection to the tracking system. In order to connect to a VRCO trackd daemon, the string should contain the shared memory key for the trackd controller data, and the shared memory key for the trackd tracker data. The format of the string is:

"<controller key> : <tracker key>"

The shared memory keys are defined in the trackd.conf file.

interEyeDistance

public final SoSFFloat interEyeDistance

Inter-eye distance with respect to the system coordinates. In an immersive environment, this value should be around 0.65 cm or equivalent (which is the actual average inter-eye distance for humans) depending on the units used in the Open Inventor world.

wandTrackerId

public final SoSFInt32 wandTrackerId

ID of the trackd sensor which should be used to control the wand. Default is 0.

headTrackerId

public final SoSFInt32 headTrackerId

ID of the trackd sensor which should be used to control the head/camera. The default value is 1. If set to -1, headtracking is disabled and the defaultCameraPosition is used to set the camera node.

wandFile

public final SoSFFilePathString wandFile

Name of a geometry file that the MultiPipe viewer uses for the wand geometry. The geometry should be centered at the origin, and should point towards the -z axis.

calibrate

public final SoMFVec4f calibrate

Optional calibration matrix that converts from actual tracker coordinates to world coordinates. The default values (-1., -1., -1., -1.) indicate that the matrix has not been defined. If actually set, the field must contain a 4x4 matrix (as four Vec4f values).

Constructor Detail

SoTracker

public SoTracker()

Constructor.

Method Detail

getTrackerReader

public SoTrackerReader getTrackerReader()

Gets associated tracker reader.

getControllerReader

public SoControllerReader getControllerReader()

Gets associated controller reader.