Config¶

Methods:

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