LeapCircleGestureΒΆ

Properties:

Methods:

class LeapCircleGesture

The LeapCircleGesture classes represents a circular finger movement.

Public Functions


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

Compare LeapGesture object equality.

[thisGesture equals:thatGesture];

Parameters

Property


- (LeapVector *) center
center

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

LeapVector *centerPoint = circleGesture.center;

Return
LeapVector The center of the circle in mm from the Leap origin.


- (int64_t) duration
duration

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

int64_t microseconds = gesture.duration;

Return
int64_t the elapsed duration in microseconds.


- (float) durationSeconds
durationSeconds

The elapsed duration in seconds.

float seconds = gesture.duration;

See
duration
Return
float the elapsed duration in seconds.


- (LeapFrame *) frame
frame

The LeapFrame containing this LeapGesture instance.

LeapFrame *owningFrame = gesture.frame;

Return
The parent LeapFrame object.


- (NSArray *) hands
hands

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];

Return
NSArray the list of related LeapHand objects.


- (int32_t) id
id

The gesture ID.

int gestureID = gesture.id;

Return
int32_t the ID of this LeapGesture.


- (BOOL) isValid
isValid

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...
}

Return
bool Yes, if this is a valid LeapGesture instance; NO, otherwise.


- (LeapVector *) normal
normal

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";
}

Return
LeapVector the normal vector for the circle being traced


- (LeapPointable *) pointable
pointable

The finger performing the circle gesture.

LeapPointable *circlingPointable = circleGesture.pointable;

Return
A LeapPointable object representing the circling finger.


- (NSArray *) pointables
pointables

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];

Return
NSArray the list of related LeapPointable objects.


- (float) progress
progress

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

int revolutions = floor(circleGesture.progress);

Return
float A positive number indicating the gesture progress.


- (float) radius
radius

The radius of the circle.

float currentRadius = circleGesture.radius;

Return
The circle radius in mm.


- (LeapGestureState) state
state

The gesture state.

Return
LeapGestureState A value from the LeapGestureState enumeration.


- (LeapGestureType) type
type

The gesture type.

LeapGestureType type = gesture.type;

Return
LeapGestureType A value from the LeapGestureType enumeration.

Public Static Functions


+ (LeapGesture *) invalid

Returns an invalid LeapGesture object.

LeapGesture *wrongGesture = LeapGesture.invalid;

Return
The invalid LeapGesture instance.