com.primesense.nite
Class HandData

java.lang.Object
  extended by com.primesense.nite.HandData

public class HandData
extends java.lang.Object

This class stores data on a single hand during a single frame of hand detection by the HandTracker.

It can be used to find out where the hand is in space, the hand's ID, and the tracking status.

All positions are given in "real world" coordinates. See the OpenNI 2.0 documentation for more information on the coordinate systems used by OpenNI/NiTE.

See Also:
HandTracker

Method Summary
 short getId()
          Get the ID of the hand referred to by this data.
 Point3D<java.lang.Float> getPosition()
          Get the position in space of the hand during this frame.
 boolean isLost()
          Indicates whether the hand tracking algorithm has lost track of the hand.
 boolean isNew()
          Indicates if the hand referred to by this object is newly tracked.
 boolean isTouchingFov()
          Indicates whether the hand is at the edge of the sensor field of view.
 boolean isTracking()
          Indicates whether this hand is being actively tracked.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

getId

public short getId()
Get the ID of the hand referred to by this data.

Returns:
HandId of this hand.

getPosition

public Point3D<java.lang.Float> getPosition()
Get the position in space of the hand during this frame.

Returns:
Position of the hand.

isNew

public boolean isNew()
Indicates if the hand referred to by this object is newly tracked.

Returns:
True if this is the first frame that this hand has been detected in, false otherwise.

isLost

public boolean isLost()
Indicates whether the hand tracking algorithm has lost track of the hand. This can happen, for example, if the hand leaves the field of view of the sensor or becomes occluded.

Returns:
True if this hand is no longer being tracked.

isTracking

public boolean isTracking()
Indicates whether this hand is being actively tracked.

Returns:
True if hand is being successfully tracked, false otherwise.

isTouchingFov

public boolean isTouchingFov()
Indicates whether the hand is at the edge of the sensor field of view.

Returns:
True if the hand is at the edge of the field of view, false otherwise.