GEIS  2.0
Gesture Engine Interface Support
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups
Configuration

Functions

GeisStatus geis_get_configuration (Geis geis, GeisString configuration_item_name, void *configuration_item_value)
 Gets a feature configuration value.
GeisStatus geis_set_configuration (Geis geis, GeisString configuration_item_name, void *configuration_item_value)
 Sets a feature configuration value.

Required Configuration Items

These configuration items are defined by the GEIS specification.
#define GEIS_CONFIGURATION_FD
 Gets a Unix file descriptor that will signal the availablility of GEIS events for processing.

Vendor-defined Configuration Items

These configuration items are not a part of the GEIS specification and may change.
#define GEIS_CONFIG_MAX_EVENTS
#define GEIS_CONFIG_ATOMIC_GESTURES
 Indicates if atomic gestures are in use.
#define GEIS_CONFIG_SEND_TENTATIVE_EVENTS
 See GEIS_INIT_SEND_TENTATIVE_EVENTS.
#define GEIS_CONFIG_SEND_SYNCHRONOS_EVENTS
 See GEIS_INIT_SEND_SYNCHRONOS_EVENTS.
#define GEIS_CONFIG_DRAG_THRESHOLD
 Movement threshold for recognizing a DRAG gesture (in meters).
#define GEIS_CONFIG_DRAG_TIMEOUT
 Timeout for recognizing a DRAG gesture (in milliseconds).
#define GEIS_CONFIG_PINCH_THRESHOLD
 Movement threshold for recognizing a PINCH gesture (in meters).
#define GEIS_CONFIG_PINCH_TIMEOUT
 Timeout for recognizing a PINCH gesture (in milliseconds).
#define GEIS_CONFIG_ROTATE_THRESHOLD
 Movement threshold for recognizing a ROTATE gesture (in meters).
#define GEIS_CONFIG_ROTATE_TIMEOUT
 Timeout for recognizing a ROTATE gesture (in milliseconds).
#define GEIS_CONFIG_TAP_THRESHOLD
 Movement threshold for recognizing a TAP gesture (in meters).
#define GEIS_CONFIG_TAP_TIMEOUT
 Timeout for recognizing a TAP gesture (in milliseconds).

Detailed Description


Macro Definition Documentation

#define GEIS_CONFIG_ATOMIC_GESTURES

Indicates if atomic gestures are in use.

Value type GeisBoolean.

#define GEIS_CONFIG_DRAG_THRESHOLD

Movement threshold for recognizing a DRAG gesture (in meters).

Value type GeisFloat.

#define GEIS_CONFIG_DRAG_TIMEOUT

Timeout for recognizing a DRAG gesture (in milliseconds).

Value type GeisInteger.

#define GEIS_CONFIG_PINCH_THRESHOLD

Movement threshold for recognizing a PINCH gesture (in meters).

Value type GeisFloat.

#define GEIS_CONFIG_PINCH_TIMEOUT

Timeout for recognizing a PINCH gesture (in milliseconds).

Value type GeisInteger.

#define GEIS_CONFIG_ROTATE_THRESHOLD

Movement threshold for recognizing a ROTATE gesture (in meters).

Value type GeisFloat.

#define GEIS_CONFIG_ROTATE_TIMEOUT

Timeout for recognizing a ROTATE gesture (in milliseconds).

Value type GeisInteger.

#define GEIS_CONFIG_SEND_SYNCHRONOS_EVENTS

See GEIS_INIT_SEND_SYNCHRONOS_EVENTS.

#define GEIS_CONFIG_SEND_TENTATIVE_EVENTS

See GEIS_INIT_SEND_TENTATIVE_EVENTS.

#define GEIS_CONFIG_TAP_THRESHOLD

Movement threshold for recognizing a TAP gesture (in meters).

Value type GeisFloat.

#define GEIS_CONFIG_TAP_TIMEOUT

Timeout for recognizing a TAP gesture (in milliseconds).

Value type GeisInteger.

#define GEIS_CONFIGURATION_FD

Gets a Unix file descriptor that will signal the availablility of GEIS events for processing.


Function Documentation

GeisStatus geis_get_configuration ( Geis  geis,
GeisString  configuration_item_name,
void *  configuration_item_value 
)

Gets a feature configuration value.

Parameters:
[in]geisAn opaque GEIS API object.
[in]configuration_item_nameSelects the configuration value to return.
[out]configuration_item_valuePoints to a buffer to contain the output value. The actual type of this buffer depends on the configuration_value_name.
Return values:
GEIS_STATUS_BAD_ARGUMENTan invalid argument value was passed
GEIS_STATUS_NOT_SUPPORTEDthe configuration value is not supported
GEIS_STATUS_SUCCESSnormal successful completion
GeisStatus geis_set_configuration ( Geis  geis,
GeisString  configuration_item_name,
void *  configuration_item_value 
)

Sets a feature configuration value.

Parameters:
[in]geisAn opaque GEIS API object.
[in]configuration_item_nameSelects the configuration value to return.
[in]configuration_item_valuePoints to a buffer to contain the output configuration value. The actual type of this buffer depends on the configuration_value_name.
Return values:
GEIS_STATUS_BAD_ARGUMENTan invalid argument value was passed
GEIS_STATUS_NOT_SUPPORTEDthe configuration value is not supported
GEIS_STATUS_SUCCESSnormal successful completion