Gesture Subscription

Data Structures
struct	GeisGestureAttr
struct	GeisGestureFuncs
Defines
#define	GEIS_ALL_GESTURES   ((GeisGestureType)0)
#define	GEIS_NO_GESTURE_ID   ((GeisGestureId)0)
Typedefs
typedef unsigned int	GeisGestureType
typedef unsigned int	GeisGestureId
typedef struct GeisGestureAttr	GeisGestureAttr
typedef void(*	GeisGestureCallback )(void *cookie, GeisGestureType gesture_type, GeisGestureId gesture_id, GeisSize attr_count, GeisGestureAttr *attrs)
typedef struct GeisGestureFuncs	GeisGestureFuncs
Functions
GEIS_API GeisStatus	geis_subscribe (GeisInstance geis_instance, GeisInputDeviceId *input_list, const char **gesture_list, GeisGestureFuncs *funcs, void *cookie)
GEIS_API GeisStatus	geis_unsubscribe (GeisInstance geis_instance, GeisGestureType *gesture_list)

---

Typedef Documentation

typedef struct GeisGestureAttr GeisGestureAttr

Gesture Attributes

typedef void(* GeisGestureCallback)(void *cookie, GeisGestureType gesture_type, GeisGestureId gesture_id, GeisSize attr_count, GeisGestureAttr *attrs)

A callback used for different gesture events.

Parameters:

[in]	cookie	an application-specific value to be passed to the callback.
[in]	gesture_type	a gesture type
[in]	gesture_id	a unique gesture identifier
[in]	attrs	parameters

typedef struct GeisGestureFuncs GeisGestureFuncs

A structure of callback functions.

---

Function Documentation

GEIS_API GeisStatus geis_subscribe	(	GeisInstance	geis_instance,
		GeisInputDeviceId *	input_list,
		const char **	gesture_list,
		GeisGestureFuncs *	funcs,
		void *	cookie
	)

Registers a callback to receive gesture events.

Parameters:

[in]	geis_instance	an opaque pointer to a geis gesture subscription instance
[in]	input_list	a null-terminated list of input device IDs
[in]	gesture_list	a null-terminated list of C-style strings naming gestures for subscription
[in]	funcs	a pointer to a GeisGestureFuncs structure
[in]	cookie	an application specific value to be passed to the callback

Return values:

	GEIS_BAD_ARGUMENT	an invalid argument value was passed
	GEIS_STATUS_SUCCESS	normal successful completion

GEIS_API GeisStatus geis_unsubscribe	(	GeisInstance	geis_instance,
		GeisGestureType *	gesture_list
	)

Unsubscribes to one or more gestures.

Parameters:

[in]	geis_instance	an opaque pointer to a geis gesture subscription instance
[in]	gesture_list	a null-terminated list of gesture types