ConfigΒΆ

Methods:

class com::leapmotion::leap::Config

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. You can save after the Controller has connected to the Leap Motion service/daemon. In other words, after the Controller has dispatched the serviceConnected or connected events or Controller::isConnected is true. The configuration value changes are not persistent; your application needs to set the values every time it runs.

See
CircleGesture
See
KeyTapGesture
See
ScreenTapGesture
See
SwipeGesture
Since
1.0

Public Functions

Config()

Constructs a Config object.

Do not create your own Config objects. Get a Config object using the Controller::config() function.

Config config = controller.config();

Since
1.0

boolean getBool(String key)

Gets the boolean representation for the specified key.

Boolean booleanValue = controller.config().getBool("Key.For.boolean.Setting");

Since
1.0

float getFloat(String key)

Gets the floating point representation for the specified key.

float floatValue = controller.config().getFloat("Gesture.Circle.MinRadius");

Since
1.0

int getInt32(String key)

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

int intValue = controller.config().getInt32("Key.For.Integer.Setting");

Since
1.0

String getString(String key)

Gets the string representation for the specified key.

String stringValue = controller.config().getString("Key.For.String.Setting");

Since
1.0

boolean 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. You can save after the Controller has connected to the Leap Motion service/daemon. In other words, after the Controller has dispatched the serviceConnected or connected events or Controller::isConnected is true. The configuration value changes are not persistent; your application must set the values every time it runs.

controller.config().setFloat("Gesture.Circle.MinRadius", 15);
controller.config().setFloat("Gesture.Circle.MinArc", 1.7f);
Boolean success = controller.config().save();

Return
true on success, false on failure.
Since
1.0

boolean setBool(String key, boolean value)

Sets the boolean representation for the specified key.

controller.config().setBool("Key.For.boolean.Setting", true);

Return
true on success, false on failure.
Since
1.0

boolean setFloat(String key, float value)

Sets the floating point representation for the specified key.

controller.config().setFloat("Gesture.Circle.MinRadius", 25);

Return
true on success, false on failure.
Since
1.0

boolean setInt32(String key, int value)

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

controller.config().setInt32("Key.For.Integer.Setting", 12);

Return
true on success, false on failure.
Since
1.0

boolean setString(String key, String value)

Sets the string representation for the specified key.

controller.config().setString("Key.For.String.Setting", "A String");

Return
true on success, false on failure.
Since
1.0

Config.ValueType type(String key)

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

Config.ValueType dataType = controller.config().type("Gesture.KeyTap.MinDistance");

Return
The native data type of the value, that is, the type that does not require a data conversion.
Since
1.0
Parameters
  • key -

    The key for the looking up the value in the configuration dictionary.

class ValueType

Enumerates the possible data types for configuration values.

The Config::type() function returns an item from the ValueType enumeration.

Since
1.0

Public Members

TYPE_UNKNOWN

The data type is unknown.

Since
1.0