Leap Motion C# API Reference  0.8.0
Leap.ScreenTapGesture Class Reference

The ScreenTapGesture class represents a tapping gesture by a finger or tool. More...

Inherits Leap.Gesture.

Public Member Functions

 ScreenTapGesture ()
 Constructs a new ScreenTapGesture object.
 
 ScreenTapGesture (Gesture rhs)
 Constructs a ScreenTapGesture object from an instance of the Gesture class.
 
- Public Member Functions inherited from Leap.Gesture
bool Equals (Gesture rhs)
 Compare Gesture object equality.
 
 Gesture ()
 Constructs a new Gesture object.
 
 Gesture (Gesture rhs)
 Constructs a new copy of an Gesture object.
 
override string ToString ()
 A string containing a brief, human-readable description of this Gesture.
 

Static Public Member Functions

static Gesture.GestureType ClassType ()
 The screen tap gesture type.
 

Properties

Vector Direction [get]
 The direction of finger tip motion.
 
Pointable Pointable [get]
 The finger performing the screen tap gesture.
 
Vector Position [get]
 The position where the screen tap is registered.
 
float Progress [get]
 The progess value is always 1.0 for a screen tap gesture.
 
- Properties inherited from Leap.Gesture
long Duration [get]
 The elapsed duration of the recognized movement up to the frame containing this Gesture object, in microseconds.
 
float DurationSeconds [get]
 The elapsed duration in seconds.
 
Frame Frame [get]
 The Frame containing this Gesture instance.
 
HandList Hands [get]
 The list of hands associated with this Gesture, if any.
 
int Id [get]
 The gesture ID.
 
static Gesture Invalid [get]
 Returns an invalid Gesture object.
 
bool IsValid [get]
 Reports whether this Gesture instance represents a valid Gesture.
 
PointableList Pointables [get]
 The list of fingers and tools associated with this Gesture, if any.
 
Gesture.GestureState State [get]
 The gesture state.
 
Gesture.GestureType Type [get]
 The gesture type.
 

Additional Inherited Members

- Public Types inherited from Leap.Gesture
enum  GestureState { STATEINVALID = -1, STATESTART = 1, STATEUPDATE = 2, STATESTOP = 3 }
 The possible gesture states. More...
 
enum  GestureType {
  TYPEINVALID = -1, TYPESWIPE = 1, TYPECIRCLE = 4, TYPESCREENTAP = 5,
  TYPEKEYTAP = 6
}
 The supported types of gestures. More...
 

Detailed Description

The ScreenTapGesture class represents a tapping gesture by a finger or tool.

A screen tap gesture is recognized when the tip of a finger pokes forward and then springs back to approximately the original postion, as if tapping a vertical screen. The tapping finger must pause briefly before beginning the tap.

Important: To use screen tap gestures in your application, you must enable recognition of the screen tap gesture. You can enable recognition with:

ScreenTap gestures are discrete. The ScreenTapGesture object representing a tap always has the state, STATE_STOP. Only one ScreenTapGesture object is created for each screen tap gesture recognized.

You can set the minimum finger movement and velocity required for a movement to be recognized as a screen tap as well as adjust the detection window for evaluating the movement using the config attribute of a connected Controller object. Use the following keys to configure screen tap recognition:

Key string Value type Default value Units
Gesture.ScreenTap.MinForwardVelocity float 50 mm/s
Gesture.ScreenTap.HistorySeconds float 0.1 s
Gesture.ScreenTap.MinDistance float 3.0 mm

The following example demonstrates how to set the screen tap configuration parameters:

Constructor & Destructor Documentation

Leap.ScreenTapGesture.ScreenTapGesture ( )
inline

Constructs a new ScreenTapGesture object.

An uninitialized ScreenTapGesture object is considered invalid. Get valid instances of the ScreenTapGesture class from a Frame object.

Leap.ScreenTapGesture.ScreenTapGesture ( Gesture  rhs)
inline

Constructs a ScreenTapGesture object from an instance of the Gesture class.

Parameters
rhsThe Gesture instance to specialize. This Gesture instance must be a ScreenTapGesture object.

Member Function Documentation

static Gesture.GestureType Leap.ScreenTapGesture.ClassType ( )
inlinestatic

The screen tap gesture type.

Returns
Type The type value designating a screen tap gesture.

Property Documentation

Vector Leap.ScreenTapGesture.Direction
get

The direction of finger tip motion.

Returns
Vector A unit direction vector.
Pointable Leap.ScreenTapGesture.Pointable
get

The finger performing the screen tap gesture.

Returns
Pointable A Pointable object representing the tapping finger.
Vector Leap.ScreenTapGesture.Position
get

The position where the screen tap is registered.

Returns
Vector A Vector containing the coordinates of screen tap location.
float Leap.ScreenTapGesture.Progress
get

The progess value is always 1.0 for a screen tap gesture.

Returns
float The value 1.0.