Inherits Leap.Interface.
|
bool | Equals (Frame arg0) |
| Compare Frame object equality.
|
|
Finger | Finger (int id) |
| The Finger object with the specified ID in this frame.
|
|
| Frame () |
| Constructs a Frame object.
|
|
Gesture | Gesture (int id) |
| The Gesture object with the specified ID in this frame.
|
|
GestureList | Gestures () |
| The gestures recognized or continuing in this frame.
|
|
GestureList | Gestures (Frame sinceFrame) |
| Returns a GestureList containing all gestures that have occured since the specified frame.
|
|
Hand | Hand (int id) |
| The Hand object with the specified ID in this frame.
|
|
Pointable | Pointable (int id) |
| The Pointable object with the specified ID in this frame.
|
|
float | RotationAngle (Frame sinceFrame) |
| The angle of rotation around the rotation axis derived from the overall rotational motion between the current frame and the specified frame.
|
|
float | RotationAngle (Frame sinceFrame, Vector axis) |
| The angle of rotation around the specified axis derived from the overall rotational motion between the current frame and the specified frame.
|
|
Vector | RotationAxis (Frame sinceFrame) |
| The axis of rotation derived from the overall rotational motion between the current frame and the specified frame.
|
|
Matrix | RotationMatrix (Frame sinceFrame) |
| The transform matrix expressing the rotation derived from the overall rotational motion between the current frame and the specified frame.
|
|
float | RotationProbability (Frame sinceFrame) |
| The estimated probability that the overall motion between the current frame and the specified frame is intended to be a rotating motion.
|
|
float | ScaleFactor (Frame sinceFrame) |
| The scale factor derived from the overall motion between the current frame and the specified frame.
|
|
float | ScaleProbability (Frame sinceFrame) |
| The estimated probability that the overall motion between the current frame and the specified frame is intended to be a scaling motion.
|
|
Tool | Tool (int id) |
| The Tool object with the specified ID in this frame.
|
|
override string | ToString () |
| A string containing a brief, human readable description of the Frame object.
|
|
Vector | Translation (Frame sinceFrame) |
| The change of position derived from the overall linear motion between the current frame and the specified frame.
|
|
float | TranslationProbability (Frame sinceFrame) |
| The estimated probability that the overall motion between the current frame and the specified frame is intended to be a translating motion.
|
|
The Frame class represents a set of hand and finger tracking data detected in a single frame.
The Leap Motion software detects hands, fingers and tools within the tracking area, reporting their positions, orientations and motions in frames at the Leap Motion frame rate.
Access Frame objects through an instance of the Controller class. Implement a Listener subclass to receive a callback event when a new Frame is available.
Finger Leap.Frame.Finger |
( |
int |
id | ) |
|
|
inline |
The Finger object with the specified ID in this frame.
Use the Frame::finger() function to retrieve the Finger object from this frame using an ID value obtained from a previous frame. This function always returns a Finger object, but if no finger with the specified ID is present, an invalid Finger object is returned.
Note that ID values persist across frames, but only until tracking of a particular object is lost. If tracking of a finger is lost and subsequently regained, the new Finger object representing that physical finger may have a different ID than that representing the finger in an earlier frame.
- Parameters
-
id | The ID value of a Finger object from a previous frame. |
- Returns
- The Finger object with the matching ID if one exists in this frame; otherwise, an invalid Finger object is returned.
Hand Leap.Frame.Hand |
( |
int |
id | ) |
|
|
inline |
The Hand object with the specified ID in this frame.
Use the Frame::hand() function to retrieve the Hand object from this frame using an ID value obtained from a previous frame. This function always returns a Hand object, but if no hand with the specified ID is present, an invalid Hand object is returned.
Note that ID values persist across frames, but only until tracking of a particular object is lost. If tracking of a hand is lost and subsequently regained, the new Hand object representing that physical hand may have a different ID than that representing the physical hand in an earlier frame.
- Parameters
-
id | The ID value of a Hand object from a previous frame. |
- Returns
- The Hand object with the matching ID if one exists in this frame; otherwise, an invalid Hand object is returned.
The Pointable object with the specified ID in this frame.
Use the Frame::pointable() function to retrieve the Pointable object from this frame using an ID value obtained from a previous frame. This function always returns a Pointable object, but if no finger or tool with the specified ID is present, an invalid Pointable object is returned.
Note that ID values persist across frames, but only until tracking of a particular object is lost. If tracking of a finger or tool is lost and subsequently regained, the new Pointable object representing that finger or tool may have a different ID than that representing the finger or tool in an earlier frame.
- Parameters
-
id | The ID value of a Pointable object from a previous frame. |
- Returns
- The Pointable object with the matching ID if one exists in this frame; otherwise, an invalid Pointable object is returned.
float Leap.Frame.RotationAngle |
( |
Frame |
sinceFrame | ) |
|
|
inline |
The angle of rotation around the rotation axis derived from the overall rotational motion between the current frame and the specified frame.
The returned angle is expressed in radians measured clockwise around the rotation axis (using the right-hand rule) between the start and end frames. The value is always between 0 and pi radians (0 and 180 degrees).
The Leap Motion software derives frame rotation from the relative change in position and orientation of all objects detected in the field of view.
If either this frame or sinceFrame is an invalid Frame object, then the angle of rotation is zero.
- Parameters
-
sinceFrame | The starting frame for computing the relative rotation. |
- Returns
- A positive value containing the heuristically determined rotational change between the current frame and that specified in the sinceFrame parameter.
float Leap.Frame.RotationAngle |
( |
Frame |
sinceFrame, |
|
|
Vector |
axis |
|
) |
| |
|
inline |
The angle of rotation around the specified axis derived from the overall rotational motion between the current frame and the specified frame.
The returned angle is expressed in radians measured clockwise around the rotation axis (using the right-hand rule) between the start and end frames. The value is always between -pi and pi radians (-180 and 180 degrees).
The Leap Motion software derives frame rotation from the relative change in position and orientation of all objects detected in the field of view.
If either this frame or sinceFrame is an invalid Frame object, then the angle of rotation is zero.
- Parameters
-
sinceFrame | The starting frame for computing the relative rotation. |
axis | The axis to measure rotation around. |
- Returns
- A value containing the heuristically determined rotational change between the current frame and that specified in the sinceFrame parameter around the given axis.
The axis of rotation derived from the overall rotational motion between the current frame and the specified frame.
The returned direction vector is normalized.
The Leap Motion software derives frame rotation from the relative change in position and orientation of all objects detected in the field of view.
If either this frame or sinceFrame is an invalid Frame object, or if no rotation is detected between the two frames, a zero vector is returned.
- Parameters
-
sinceFrame | The starting frame for computing the relative rotation. |
- Returns
- A normalized direction Vector representing the axis of the heuristically determined rotational change between the current frame and that specified in the sinceFrame parameter.
The transform matrix expressing the rotation derived from the overall rotational motion between the current frame and the specified frame.
The Leap Motion software derives frame rotation from the relative change in position and orientation of all objects detected in the field of view.
If either this frame or sinceFrame is an invalid Frame object, then this method returns an identity matrix.
- Parameters
-
sinceFrame | The starting frame for computing the relative rotation. |
- Returns
- A transformation Matrix containing the heuristically determined rotational change between the current frame and that specified in the sinceFrame parameter.
float Leap.Frame.ScaleFactor |
( |
Frame |
sinceFrame | ) |
|
|
inline |
The scale factor derived from the overall motion between the current frame and the specified frame.
The scale factor is always positive. A value of 1.0 indicates no scaling took place. Values between 0.0 and 1.0 indicate contraction and values greater than 1.0 indicate expansion.
The Leap Motion software derives scaling from the relative inward or outward motion of all objects detected in the field of view (independent of translation and rotation).
If either this frame or sinceFrame is an invalid Frame object, then this method returns 1.0.
- Parameters
-
sinceFrame | The starting frame for computing the relative scaling. |
- Returns
- A positive value representing the heuristically determined scaling change ratio between the current frame and that specified in the sinceFrame parameter.
Tool Leap.Frame.Tool |
( |
int |
id | ) |
|
|
inline |
The Tool object with the specified ID in this frame.
Use the Frame::tool() function to retrieve the Tool object from this frame using an ID value obtained from a previous frame. This function always returns a Tool object, but if no tool with the specified ID is present, an invalid Tool object is returned.
Note that ID values persist across frames, but only until tracking of a particular object is lost. If tracking of a tool is lost and subsequently regained, the new Tool object representing that tool may have a different ID than that representing the tool in an earlier frame.
- Parameters
-
id | The ID value of a Tool object from a previous frame. |
- Returns
- The Tool object with the matching ID if one exists in this frame; otherwise, an invalid Tool object is returned.
The change of position derived from the overall linear motion between the current frame and the specified frame.
The returned translation vector provides the magnitude and direction of the movement in millimeters.
The Leap Motion software derives frame translation from the linear motion of all objects detected in the field of view.
If either this frame or sinceFrame is an invalid Frame object, then this method returns a zero vector.
- Parameters
-
sinceFrame | The starting frame for computing the relative translation. |
- Returns
- A Vector representing the heuristically determined change in position of all objects between the current frame and that specified in the sinceFrame parameter.
Reports whether this Frame instance is valid.
A valid Frame is one generated by the Leap::Controller object that contains tracking data for all detected entities. An invalid Frame contains no actual tracking data, but you can call its functions without risk of a null pointer exception. The invalid Frame mechanism makes it more convenient to track individual data across the frame history. For example, you can invoke:
for an arbitrary Frame history value, "n", without first checking whether frame(n) returned a null object. (You should still check that the returned Finger instance is valid.)
- Returns
- True, if this is a valid Frame object; false otherwise.