Configuration

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

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. More...

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. More...
#define	GEIS_CONFIG_SEND_TENTATIVE_EVENTS
	See GEIS_INIT_SEND_TENTATIVE_EVENTS. More...
#define	GEIS_CONFIG_SEND_SYNCHRONOS_EVENTS
	See GEIS_INIT_SEND_SYNCHRONOS_EVENTS. More...
#define	GEIS_CONFIG_DRAG_THRESHOLD
	Movement threshold for recognizing a DRAG gesture (in meters). More...
#define	GEIS_CONFIG_DRAG_TIMEOUT
	Timeout for recognizing a DRAG gesture (in milliseconds). More...
#define	GEIS_CONFIG_PINCH_THRESHOLD
	Movement threshold for recognizing a PINCH gesture (in meters). More...
#define	GEIS_CONFIG_PINCH_TIMEOUT
	Timeout for recognizing a PINCH gesture (in milliseconds). More...
#define	GEIS_CONFIG_ROTATE_THRESHOLD
	Movement threshold for recognizing a ROTATE gesture (in meters). More...
#define	GEIS_CONFIG_ROTATE_TIMEOUT
	Timeout for recognizing a ROTATE gesture (in milliseconds). More...
#define	GEIS_CONFIG_TAP_THRESHOLD
	Movement threshold for recognizing a TAP gesture (in meters). More...
#define	GEIS_CONFIG_TAP_TIMEOUT
	Timeout for recognizing a TAP gesture (in milliseconds). More...
#define	GEIS_CONFIG_NUM_ACTIVE_SUBSCRIPTIONS
	The number of subscriptions currently active in the back end. More...

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_NUM_ACTIVE_SUBSCRIPTIONS

The number of subscriptions currently active in the back end.

This config is query-only and intended for unit test validations.

#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.

Examples:

geis2.c.

Function Documentation

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

Gets a feature configuration value.

Parameters

[in]	geis	An opaque GEIS API object.
[in]	configuration_item_name	Selects the configuration value to return.
[out]	configuration_item_value	Points 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_ARGUMENT	an invalid argument value was passed
GEIS_STATUS_NOT_SUPPORTED	the configuration value is not supported
GEIS_STATUS_SUCCESS	normal successful completion

Examples:

geis2.c.

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

Sets a feature configuration value.

Parameters

[in]	geis	An opaque GEIS API object.
[in]	configuration_item_name	Selects the configuration value to return.
[in]	configuration_item_value	Points 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_ARGUMENT	an invalid argument value was passed
GEIS_STATUS_NOT_SUPPORTED	the configuration value is not supported
GEIS_STATUS_SUCCESS	normal successful completion