GEIS  2.0
Gesture Engine Interface Support

Data Structures

class  GeisRegion
 Defines a region over which gestures may take place. More...
 

Functions

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

Region Attributes

These attributes can be used to construct filter terms to restrict a gesture subscription to a particular region.
#define GEIS_REGION_ATTRIBUTE_WINDOWID
 The X11 windowid in which a gesture occurred. More...
 

Region Initialization Arguments

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. More...
 
#define GEIS_REGION_X11_WINDOWID
 Selects an X11 window as a region. More...
 

Detailed Description

Macro Definition Documentation

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

Function Documentation

GeisStatus geis_region_delete ( GeisRegion  region)

Destroys a GEIS v2.0 region.

Parameters
[in]regionThe region.
GeisString geis_region_name ( GeisRegion  region)

Gets the name of a GEIS v2.0 region.

Parameters
[in]regionThe 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.

Parameters
[in]geisThe GEIS API instance.
[in]nameA name. Used for diagnostics.
[in]init_arg_nameThe name of the first initialization argument.

The initialization argument list must be terminated by a NULL.

Returns
a newly created region, or NULL on failure.