javax.media.j3d
Class SensorRead

java.lang.Object
  extended by javax.media.j3d.SensorRead

public class SensorRead
extends java.lang.Object

A SensorRead encapsulates all the information associated with a single reading of a sensor, including a timestamp, a transform, and, optionally, button values.


Field Summary
(package private)  int[] buttonValues
          The state of the sensor's buttons
static int MAXIMUM_SENSOR_BUTTON_COUNT
          The maximum number of sensor-attached buttons tracked on a per sensor basis.
(package private)  int numButtons
          The number of buttons associated with this SensorRead
(package private)  Transform3D read
          The six-degree-of-freedom reading
(package private)  long time
          This reading's time stamp
 
Constructor Summary
SensorRead()
          Constructs a SensorRead object with default parameters.
SensorRead(int numButtons)
          Constructs a SensorRead object with the specified number of buttons.
 
Method Summary
 void get(Transform3D result)
          Retrieve the SensorRead's transform and place it in result
 void getButtons(int[] values)
          Copies the array of button values for this SensorRead object into the specified array.
 int getNumButtons()
          Returns the number of buttons associated with this SensorRead object.
 long getTime()
          Retrieve this SensorRead's associated time stamp
(package private)  void set(SensorRead sensorRead)
           
 void set(Transform3D t1)
          Set the SensorRead's transform to the value specified
 void setButtons(int[] values)
          Sets the values of all buttons for this SensorRead object.
 void setTime(long time)
          Sets this SensorRead's time stamp to the specified argument
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

MAXIMUM_SENSOR_BUTTON_COUNT

public static final int MAXIMUM_SENSOR_BUTTON_COUNT
The maximum number of sensor-attached buttons tracked on a per sensor basis.

See Also:
Constant Field Values

time

long time
This reading's time stamp


read

Transform3D read
The six-degree-of-freedom reading


buttonValues

int[] buttonValues
The state of the sensor's buttons


numButtons

int numButtons
The number of buttons associated with this SensorRead

Constructor Detail

SensorRead

public SensorRead()
Constructs a SensorRead object with default parameters. The default values are as follows:


SensorRead

public SensorRead(int numButtons)
Constructs a SensorRead object with the specified number of buttons.

Parameters:
numButtons - the number of buttons for this SensorRead
Method Detail

set

final void set(SensorRead sensorRead)

set

public void set(Transform3D t1)
Set the SensorRead's transform to the value specified

Parameters:
t1 - this sensor's reading

get

public void get(Transform3D result)
Retrieve the SensorRead's transform and place it in result

Parameters:
result - the recipient of the this sensor's reading

setTime

public void setTime(long time)
Sets this SensorRead's time stamp to the specified argument

Parameters:
time - the time to associate with this reading

getTime

public long getTime()
Retrieve this SensorRead's associated time stamp

Returns:
the SensorRead's time as a long

setButtons

public void setButtons(int[] values)
Sets the values of all buttons for this SensorRead object.

Parameters:
values - array contining the new buttons for this SensorRead
Throws:
java.lang.ArrayIndexOutOfBoundsException - if this object has 0 buttons or if values.length is less than the number of buttons in this object.

getButtons

public void getButtons(int[] values)
Copies the array of button values for this SensorRead object into the specified array. This method has no effect if this SensorRead object has 0 buttons. The array must be large enough to hold all of the buttons.

Parameters:
values - array that will receive the values of all buttons for this SensorRead

getNumButtons

public int getNumButtons()
Returns the number of buttons associated with this SensorRead object.

Returns:
the number of buttons associated with this SensorRead object
Since:
Java 3D 1.2


Copyright 1996-2008 Sun Microsystems, Inc. All Rights Reserved. Use is subject to license terms.