LeapCircleGestureΒΆ

LeapCircleGesture Class Reference

The LeapCircleGesture classes represents a circular finger movement. More...

Inherits LeapGesture.

Instance Methods

(BOOL) - equals:
 Compare LeapGesture object equality. More...
 

Class Methods

(LeapGesture *) + invalid
 Returns an invalid LeapGesture object. More...
 

Properties

LeapVectorcenter
 The center point of the circle within the Leap frame of reference. More...
 
int64_t duration
 The elapsed duration of the recognized movement up to the frame containing this LeapGesture object, in microseconds. More...
 
float durationSeconds
 The elapsed duration in seconds. More...
 
LeapFrameframe
 The LeapFrame containing this LeapGesture instance. More...
 
NSArray * hands
 The list of hands associated with this LeapGesture, if any. More...
 
int32_t id
 The gesture ID. More...
 
BOOL isValid
 Reports whether this LeapGesture instance represents a valid gesture. More...
 
LeapVectornormal
 Returns the normal vector for the circle being traced. More...
 
LeapPointablepointable
 The finger performing the circle gesture. More...
 
NSArray * pointables
 The list of fingers and tools associated with this LeapGesture, if any. More...
 
float progress
 The number of times the finger tip has traversed the circle. More...
 
float radius
 The radius of the circle. More...
 
LeapGestureState state
 The gesture state. More...
 
LeapGestureType type
 The gesture type. More...
 

Detailed Description

The LeapCircleGesture classes represents a circular finger movement.

Method Documentation

- (BOOL) equals: (const LeapGesture *)  other

Compare LeapGesture object equality.

[thisGesture equals:thatGesture];
Parameters
otherThe LeapGesture object to compare.
+ (LeapGesture *) invalid

Returns an invalid LeapGesture object.

Returns
The invalid LeapGesture instance.

Property Documentation

- (LeapVector*) center
readnonatomicassign

The center point of the circle within the Leap frame of reference.

LeapVector *centerPoint = circleGesture.center;
Returns
LeapVector The center of the circle in mm from the Leap origin.
- (int64_t) duration
readnonatomicassigninherited

The elapsed duration of the recognized movement up to the frame containing this LeapGesture object, in microseconds.

int64_t microseconds = gesture.duration;
Returns
int64_t the elapsed duration in microseconds.
- (float) durationSeconds
readnonatomicassigninherited

The elapsed duration in seconds.

float seconds = gesture.duration;
See also
duration
Returns
float the elapsed duration in seconds.
- (LeapFrame*) frame
readnonatomicstronginherited

The LeapFrame containing this LeapGesture instance.

LeapFrame *owningFrame = gesture.frame;
Returns
The parent LeapFrame object.
- (NSArray*) hands
readnonatomicstronginherited

The list of hands associated with this LeapGesture, if any.

NSArray *handList = gesture.hands;
//Only one hand for current gestures
LeapHand *gesturingHand = [handList objectAtIndex:0];
Returns
NSArray the list of related LeapHand objects.
- (int32_t) id
readnonatomicassigninherited

The gesture ID.

int gestureID = gesture.id;
Returns
int32_t the ID of this LeapGesture.
- (BOOL) isValid
readnonatomicassigninherited

Reports whether this LeapGesture instance represents a valid gesture.

LeapFrame *frame = [controller frame:0];
LeapGesture *trackedGesture = [frame gesture:trackedGestureID];
if(trackedGesture.isValid)
{
//Use the data...
}
Returns
bool Yes, if this is a valid LeapGesture instance; NO, otherwise.
- (LeapVector*) normal
readnonatomicassign

Returns the normal vector for the circle being traced.

NSString* clockDirection;
if ([[[circleGesture pointable] direction]
angleTo:[circleGesture normal]] <= LEAP_PI/2)
{
clockDirection = @"clockwise";
} else {
clockDirection = @"counterclockwise";
}
Returns
LeapVector the normal vector for the circle being traced
- (LeapPointable*) pointable
readnonatomicassign

The finger performing the circle gesture.

LeapPointable *circlingPointable = circleGesture.pointable;
Returns
A LeapPointable object representing the circling finger.
- (NSArray*) pointables
readnonatomicstronginherited

The list of fingers and tools associated with this LeapGesture, if any.

NSArray *pointableList = gesture.pointables;
//Only one pointable for current gestures
LeapHand *gesturingPointable = [pointableList objectAtIndex:0];
Returns
NSArray the list of related LeapPointable objects.
- (float) progress
readnonatomicassign

The number of times the finger tip has traversed the circle.

int revolutions = floor(circleGesture.progress);
Returns
float A positive number indicating the gesture progress.
- (float) radius
readnonatomicassign

The radius of the circle.

float currentRadius = circleGesture.radius;
Returns
The circle radius in mm.
- (LeapGestureState) state
readnonatomicassigninherited

The gesture state.

Returns
LeapGestureState A value from the LeapGestureState enumeration.
- (LeapGestureType) type
readnonatomicassigninherited

The gesture type.

LeapGestureType type = gesture.type;
Returns
LeapGestureType A value from the LeapGestureType enumeration.