Leap Motion Java API Reference  0.8.0
com.leapmotion.leap.Config Class Reference

The Config class provides access to Leap Motion system configuration information. More...

Inherits com.leapmotion.leap.Interface.

Classes

enum  ValueType
 Enumerates the possible data types for configuration values. More...
 

Public Member Functions

 Config ()
 Constructs a Config object.
 
boolean getBool (String key)
 Gets the boolean representation for the specified key.
 
float getFloat (String key)
 Gets the floating point representation for the specified key.
 
int getInt32 (String key)
 Gets the 32-bit integer representation for the specified key.
 
String getString (String key)
 Gets the string representation for the specified key.
 
boolean save ()
 Saves the current state of the config.
 
boolean setBool (String key, boolean value)
 Sets the boolean representation for the specified key.
 
boolean setFloat (String key, float value)
 Sets the floating point representation for the specified key.
 
boolean setInt32 (String key, int value)
 Sets the 32-bit integer representation for the specified key.
 
boolean setString (String key, String value)
 Sets the string representation for the specified key.
 
Config.ValueType type (String key)
 Reports the natural data type for the value related to the specified key.
 

Detailed Description

The Config class provides access to Leap Motion system configuration information.

You can get and set gesture configuration parameters using the Config object obtained from a connected Controller object. The key strings required to identify a configuration parameter include:

Key string Value type Default value Units
Gesture.Circle.MinRadius float 5.0 mm
Gesture.Circle.MinArc float 1.5*pi radians
Gesture.Swipe.MinLength float 150 mm
Gesture.Swipe.MinVelocity float 1000 mm/s
Gesture.KeyTap.MinDownVelocity float 50 mm/s
Gesture.KeyTap.HistorySeconds float 0.1 s
Gesture.KeyTap.MinDistance float 3.0 mm
Gesture.ScreenTap.MinForwardVelocity float 50 mm/s
Gesture.ScreenTap.HistorySeconds float 0.1 s
Gesture.ScreenTap.MinDistance float 5.0 mm

After setting a configuration value, you must call the Config::save method to commit the changes. The configuration value changes are not persistent; your application needs to set the values everytime it runs.

See Also
CircleGesture
KeyTapGesture
ScreenTapGesture
SwipeGesture

Constructor & Destructor Documentation

com.leapmotion.leap.Config.Config ( )

Constructs a Config object.

Member Function Documentation

boolean com.leapmotion.leap.Config.getBool ( String  key)

Gets the boolean representation for the specified key.

float com.leapmotion.leap.Config.getFloat ( String  key)

Gets the floating point representation for the specified key.

int com.leapmotion.leap.Config.getInt32 ( String  key)

Gets the 32-bit integer representation for the specified key.

String com.leapmotion.leap.Config.getString ( String  key)

Gets the string representation for the specified key.

boolean com.leapmotion.leap.Config.save ( )

Saves the current state of the config.

Call save() after making a set of configuration changes. The save() function transfers the configuration changes to the Leap Motion service. The configuration value changes are not persistent; your application must set the values everytime it runs.

Returns
true on success, false on failure.
boolean com.leapmotion.leap.Config.setBool ( String  key,
boolean  value 
)

Sets the boolean representation for the specified key.

Returns
true on success, false on failure.
boolean com.leapmotion.leap.Config.setFloat ( String  key,
float  value 
)

Sets the floating point representation for the specified key.

Returns
true on success, false on failure.
boolean com.leapmotion.leap.Config.setInt32 ( String  key,
int  value 
)

Sets the 32-bit integer representation for the specified key.

Returns
true on success, false on failure.
boolean com.leapmotion.leap.Config.setString ( String  key,
String  value 
)

Sets the string representation for the specified key.

Returns
true on success, false on failure.
Config.ValueType com.leapmotion.leap.Config.type ( String  key)

Reports the natural data type for the value related to the specified key.

Parameters
keyThe key for the looking up the value in the configuration dictionary.
Returns
The native data type of the value, that is, the type that does not require a data conversion.