LeapCircleGesture¶

Properties:

Methods:

The LeapCircleGesture classes represents a circular finger movement.

Public Functions

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

Compare LeapGesture object equality.

[thisGesture equals:thatGesture];

Parameters

• other -

  The LeapGesture object to compare.

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.