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
LeapVector *	center
	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...
LeapFrame *	frame
	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...
LeapVector *	normal
	Returns the normal vector for the circle being traced. More...
LeapPointable *	pointable
	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

other

The LeapGesture object to compare.

+ (LeapGesture *) invalid

Returns an invalid LeapGesture object.

LeapGesture *wrongGesture = LeapGesture.invalid;

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.