|
GeisFilter | geis_filter_new (Geis geis, GeisString name) |
| Creates a new, empty filter.
|
|
GeisFilter | geis_filter_clone (GeisFilter original, GeisString name) |
| Creates a new filter by copying an existing filter.
|
|
GeisStatus | geis_filter_delete (GeisFilter filter) |
| Destroys a GeisFilter.
|
|
GeisString | geis_filter_name (GeisFilter filter) |
| Gets the name given to the filter when it was created.
|
|
GEIS_VARARG GeisStatus | geis_filter_add_term (GeisFilter filter, GeisFilterFacility facility,...) |
| Adds a term to a filter.
|
|
GeisSubscription | geis_subscription_new (Geis geis, GeisString name, GeisSubscriptionFlags flags) |
| Creates a new subscription.
|
|
GeisStatus | geis_subscription_delete (GeisSubscription subscription) |
| Destroys a GEIS v2.0 subscription object.
|
|
GeisStatus | geis_subscription_activate (GeisSubscription subscription) |
| Activates a subscription.
|
|
GeisStatus | geis_subscription_deactivate (GeisSubscription subscription) |
| Deactivates a subscription.
|
|
GeisString | geis_subscription_name (GeisSubscription subscription) |
| Gets the name given to a subscription when it was created.
|
|
GeisInteger | geis_subscription_id (GeisSubscription subscription) |
| Gets the ID assigned to a subscription when it was created.
|
|
GeisStatus | geis_subscription_add_filter (GeisSubscription subscription, GeisFilter filter) |
| Adds a filter to a subscription.
|
|
GeisFilter | geis_subscription_filter_by_name (GeisSubscription sub, GeisString name) |
| Gets an named filter from a subscription.
|
|
GeisStatus | geis_subscription_remove_filter (GeisSubscription subscription, GeisFilter filter) |
| Removes a filter from a subscription.
|
|
|
- Gesture regions are created to describe a particular display/feedback region. The type of the region can not be changed after creation (just create a new region for that). The types of regions are platform specific and each type may require addition arguments.
- The following region initialization argument names are required by the GEIS v2.0 specification.
|
#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.
|
|
GEIS_VARARG GeisRegion | geis_region_new (Geis geis, GeisString name, GeisString init_arg_name,...) |
| Creates a new GEIS v2.0 region.
|
|
GeisStatus | geis_region_delete (GeisRegion region) |
| Destroys a GEIS v2.0 region.
|
|
GeisString | geis_region_name (GeisRegion region) |
| Gets the name of a GEIS v2.0 region.
|
|
GeisStatus | geis_subscription_get_configuration (GeisSubscription subscription, GeisString config_item_name, GeisPointer config_item_value) |
| Gets a subscription-level configuration item.
|
|
GeisStatus | geis_subscription_set_configuration (GeisSubscription subscription, GeisString config_item_name, GeisPointer config_item_value) |
| Sets a subscription-level configuration item.
|
|
| GEIS_SUBSCRIPTION_NONE |
| No special subscription processing: this is the default.
|
|
| GEIS_SUBSCRIPTION_GRAB |
| The subscription will "grab" all filtered gestures from subwindows.
|
|
| GEIS_SUBSCRIPTION_CONT |
| The gesture engine will return gesture continuations, in which the class of a recognized gestire may change over the lifetime of the gesture.
|
|
| GEIS_SUBSCRIPTION_NONE |
| No special subscription processing: this is the default.
|
|
| GEIS_SUBSCRIPTION_GRAB |
| The subscription will "grab" all filtered gestures from subwindows.
|
|
| GEIS_SUBSCRIPTION_CONT |
| The gesture engine will return gesture continuations, in which the class of a recognized gestire may change over the lifetime of the gesture.
|
|
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...
|
|
enum | { GEIS_SUBSCRIPTION_NONE
, GEIS_SUBSCRIPTION_GRAB
, GEIS_SUBSCRIPTION_CONT
} |
|
typedef enum _GeisFilterFacility | GeisFilterFacility |
| Indicates the type of filter.
|
|
typedef enum _GeisFilterOperation | GeisFilterOperation |
| Indicates the type of filter operation.
|
|
typedef int | GeisSubscriptionFlags |
|
Adds a term to a filter.
- Parameters
-
[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:
NULL);
#define GEIS_CLASS_ATTRIBUTE_NAME
The name of the gesture class.
Definition geis.h:1512
@ GEIS_FILTER_CLASS
Filters on gesture class and gesture attributes.
Definition geis.h:1714
@ GEIS_FILTER_OP_EQ
Compares for equality.
Definition geis.h:1724
GEIS_VARARG GeisStatus geis_filter_add_term(GeisFilter filter, GeisFilterFacility facility,...)
Adds a term to a filter.
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.
Adds a filter to a subscription.
- Parameters
-
[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.