![]() |
GEIS
2.0
Gesture Engine Interface Support
|
Modules | |
Gesture Filter | |
Data Structures | |
class | GeisRegion |
Functions | |
GeisFilter | geis_filter_new (Geis geis, GeisString name) |
Creates a new, empty filter. More... | |
GeisFilter | geis_filter_clone (GeisFilter original, GeisString name) |
Creates a new filter by copying an existing filter. More... | |
GeisStatus | geis_filter_delete (GeisFilter filter) |
Destroys a GeisFilter. More... | |
GeisString | geis_filter_name (GeisFilter filter) |
Gets the name given to the filter when it was created. More... | |
GEIS_VARARG GeisStatus | geis_filter_add_term (GeisFilter filter, GeisFilterFacility facility,...) |
Adds a term to a filter. More... | |
GeisSubscription | geis_subscription_new (Geis geis, GeisString name, GeisSubscriptionFlags flags) |
Creates a new subscription. More... | |
GeisStatus | geis_subscription_delete (GeisSubscription subscription) |
Destroys a GEIS v2.0 subscription object. More... | |
GeisStatus | geis_subscription_activate (GeisSubscription subscription) |
Activates a subscription. More... | |
GeisStatus | geis_subscription_deactivate (GeisSubscription subscription) |
Deactivates a subscription. More... | |
GeisString | geis_subscription_name (GeisSubscription subscription) |
Gets the name given to a subscription when it was created. More... | |
GeisInteger | geis_subscription_id (GeisSubscription subscription) |
Gets the ID assigned to a subscription when it was created. More... | |
GeisStatus | geis_subscription_add_filter (GeisSubscription subscription, GeisFilter filter) |
Adds a filter to a subscription. More... | |
GeisFilter | geis_subscription_filter_by_name (GeisSubscription sub, GeisString name) |
Gets an named filter from a subscription. More... | |
GeisStatus | geis_subscription_remove_filter (GeisSubscription subscription, GeisFilter filter) |
Removes a filter from a subscription. More... | |
Region Attributes | |
| |
#define | GEIS_REGION_ATTRIBUTE_WINDOWID |
Region Initialization Arguments | |
| |
#define | GEIS_REGION_X11_ROOT |
#define | GEIS_REGION_X11_WINDOWID |
GEIS_VARARG GeisRegion | geis_region_new (Geis geis, GeisString name, GeisString init_arg_name,...) |
Creates a new GEIS v2.0 region. More... | |
GeisStatus | geis_region_delete (GeisRegion region) |
Destroys a GEIS v2.0 region. More... | |
GeisString | geis_region_name (GeisRegion region) |
Gets the name of a GEIS v2.0 region. More... | |
GeisStatus | geis_subscription_get_configuration (GeisSubscription subscription, GeisString config_item_name, GeisPointer config_item_value) |
Gets a subscription-level configuration item. More... | |
GeisStatus | geis_subscription_set_configuration (GeisSubscription subscription, GeisString config_item_name, GeisPointer config_item_value) |
Sets a subscription-level configuration item. More... | |
enum | _GeisFilterFacility { GEIS_FILTER_DEVICE, GEIS_FILTER_CLASS, GEIS_FILTER_REGION, GEIS_FILTER_SPECIAL } |
Indicates the type of filter. More... | |
enum | _GeisFilterOperation { GEIS_FILTER_OP_EQ, GEIS_FILTER_OP_NE, GEIS_FILTER_OP_GT, GEIS_FILTER_OP_GE, GEIS_FILTER_OP_LT, GEIS_FILTER_OP_LE } |
Indicates the type of filter operation. More... | |
GEIS_SUBSCRIPTION_NONE | |
GEIS_SUBSCRIPTION_GRAB | |
GEIS_SUBSCRIPTION_CONT | |
enum | { GEIS_SUBSCRIPTION_NONE, GEIS_SUBSCRIPTION_GRAB, GEIS_SUBSCRIPTION_CONT } |
GEIS_SUBSCRIPTION_NONE | |
GEIS_SUBSCRIPTION_GRAB | |
GEIS_SUBSCRIPTION_CONT | |
typedef enum _GeisFilterFacility | GeisFilterFacility |
Indicates the type of filter. More... | |
typedef enum _GeisFilterOperation | GeisFilterOperation |
Indicates the type of filter operation. More... | |
typedef int | GeisSubscriptionFlags |
#define GEIS_REGION_ATTRIBUTE_WINDOWID |
The X11 windowid in which a gesture occurred. Used for filter matching.
#define GEIS_REGION_X11_ROOT |
Selects the X11 root window as a region.
#define GEIS_REGION_X11_WINDOWID |
Selects an X11 window as a region. Requires the window_id as an argument.
typedef enum _GeisFilterFacility GeisFilterFacility |
Indicates the type of filter.
typedef enum _GeisFilterOperation GeisFilterOperation |
Indicates the type of filter operation.
anonymous enum |
enum _GeisFilterFacility |
enum _GeisFilterOperation |
Indicates the type of filter operation.
GEIS_VARARG GeisStatus geis_filter_add_term | ( | GeisFilter | filter, |
GeisFilterFacility | facility, | ||
... | |||
) |
Adds a term to a filter.
[in] | filter | The filter. |
[in] | facility | The term facility. |
[in] | ... | A list of zero or more term descriptions. |
A term description is generally a (attr-name, filter-op, value) triple in which the meaning of the filter-op and value depend on the type of the attr.
The term description list must be terminated by a NULL.
In the following example we add terms to filter drag gestures made with three touch points:
Term descriptions are usually ANDed together, so that specifying a class name and a number of touches will filter only for gestures that have both characteristics. But if you specify several class names (e.g. drag and pinch), those classes are ORed together instead. So you can receive events from a gesture that belongs to either drag, drag&pinch or only pinch classes.
GeisFilter geis_filter_clone | ( | GeisFilter | original, |
GeisString | name | ||
) |
Creates a new filter by copying an existing filter.
[in] | original | An existing geisFilter instance. |
[in] | name | A name. |
The original filter remains unchanged.
GeisStatus geis_filter_delete | ( | GeisFilter | filter | ) |
Destroys a GeisFilter.
[in] | filter | The filter. |
GeisString geis_filter_name | ( | GeisFilter | filter | ) |
Gets the name given to the filter when it was created.
[in] | filter | The filter. |
GeisFilter geis_filter_new | ( | Geis | geis, |
GeisString | name | ||
) |
Creates a new, empty filter.
[in] | geis | The GEIS API instance. |
[in] | name | A name. |
GeisStatus geis_region_delete | ( | GeisRegion | region | ) |
Destroys a GEIS v2.0 region.
[in] | region | The region. |
GeisString geis_region_name | ( | GeisRegion | region | ) |
Gets the name of a GEIS v2.0 region.
[in] | region | The region. |
Returns the name
value used when creating the region.
GEIS_VARARG GeisRegion geis_region_new | ( | Geis | geis, |
GeisString | name, | ||
GeisString | init_arg_name, | ||
... | |||
) |
Creates a new GEIS v2.0 region.
[in] | geis | The GEIS API instance. |
[in] | name | A name. Used for diagnostics. |
[in] | init_arg_name | The name of the first initialization argument. |
The initialization argument list must be terminated by a NULL.
GeisStatus geis_subscription_activate | ( | GeisSubscription | subscription | ) |
Activates a subscription.
[in] | subscription | The subscription. |
Puts the subscription into the active state. Gesture events will be delivered for this subscription.
GeisStatus geis_subscription_add_filter | ( | GeisSubscription | subscription, |
GeisFilter | filter | ||
) |
Adds a filter to a subscription.
[in] | subscription | The subscription. |
[in] | filter | The filter to be added to the subscription. |
The effect of filters are ORed together so that, for example, a subscription that has a filter for 3-finger drag gestures and another for 2-finger pinch gestures will produce events for both 3-finger drag gestures and 2-finger pinch gestures.
The default is no filters: that is, all possible gesture events will be reported.
The subscription will take ownership of the filter.
GeisStatus geis_subscription_deactivate | ( | GeisSubscription | subscription | ) |
Deactivates a subscription.
[in] | subscription | The subscription. |
Puts the subscription into the inactive state. Gesture events will not be delivered for this subscription.
GeisStatus geis_subscription_delete | ( | GeisSubscription | subscription | ) |
Destroys a GEIS v2.0 subscription object.
[in] | subscription | The subscription. |
GeisFilter geis_subscription_filter_by_name | ( | GeisSubscription | sub, |
GeisString | name | ||
) |
Gets an named filter from a subscription.
[in] | sub | The subscription. |
[in] | name | Names the filter to retrieve. |
Returns the first filter with the given name or NULL if no such named filter is found.
GeisStatus geis_subscription_get_configuration | ( | GeisSubscription | subscription, |
GeisString | config_item_name, | ||
GeisPointer | config_item_value | ||
) |
Gets a subscription-level configuration item.
[in] | subscription | The subscription from which the configuration item will be retrieved. |
[in] | config_item_name | The name of the configuration item. |
[out] | config_item_value | A pointer to an appropriate variable to hold the retrieved config item value. |
Not all back ends support all configuration items.
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 |
GeisInteger geis_subscription_id | ( | GeisSubscription | subscription | ) |
Gets the ID assigned to a subscription when it was created.
[in] | subscription | The subscription. |
GeisString geis_subscription_name | ( | GeisSubscription | subscription | ) |
Gets the name given to a subscription when it was created.
[in] | subscription | The subscription. |
GeisSubscription geis_subscription_new | ( | Geis | geis, |
GeisString | name, | ||
GeisSubscriptionFlags | flags | ||
) |
Creates a new subscription.
[in] | geis | The GEIS API instance. |
[in] | name | A name. |
[in] | flags | Some flags. |
A gesture subscription is required for any gesture events to be delivered from the GEIS API.
GeisStatus geis_subscription_remove_filter | ( | GeisSubscription | subscription, |
GeisFilter | filter | ||
) |
Removes a filter from a subscription.
[in] | subscription | The subscription. |
[in] | filter | The filter to be removed from the subscription. |
Ownership of the filter is passed to the caller.
GeisStatus geis_subscription_set_configuration | ( | GeisSubscription | subscription, |
GeisString | config_item_name, | ||
GeisPointer | config_item_value | ||
) |
Sets a subscription-level configuration item.
[in] | subscription | The subscription from which the configuration item will be retrieved. |
[in] | config_item_name | The name of the configuration item. |
[in] | config_item_value | A pointer to an appropriate variable holding the config item value. |
Not all back ends support all configuration items.
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 |