gdkinput.h 2.92 KB
Newer Older
Elliot Lee's avatar
Elliot Lee committed
1 2 3
#ifndef __GDK_INPUT_H__
#define __GDK_INPUT_H__

Owen Taylor's avatar
Owen Taylor committed
4
#include <gdk/gdktypes.h>
Elliot Lee's avatar
Elliot Lee committed
5

Owen Taylor's avatar
Owen Taylor committed
6 7 8
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
Elliot Lee's avatar
Elliot Lee committed
9

Owen Taylor's avatar
Owen Taylor committed
10
typedef struct _GdkDeviceKey	    GdkDeviceKey;
11 12
typedef struct _GdkDeviceAxis	    GdkDeviceAxis;
typedef struct _GdkDevice	    GdkDevice;
Owen Taylor's avatar
Owen Taylor committed
13
typedef struct _GdkTimeCoord	    GdkTimeCoord;
Elliot Lee's avatar
Elliot Lee committed
14

Owen Taylor's avatar
Owen Taylor committed
15 16 17 18 19 20
typedef enum
{
  GDK_EXTENSION_EVENTS_NONE,
  GDK_EXTENSION_EVENTS_ALL,
  GDK_EXTENSION_EVENTS_CURSOR
} GdkExtensionMode;
Elliot Lee's avatar
Elliot Lee committed
21

Owen Taylor's avatar
Owen Taylor committed
22
typedef enum
Elliot Lee's avatar
Elliot Lee committed
23
{
Owen Taylor's avatar
Owen Taylor committed
24 25 26 27 28
  GDK_SOURCE_MOUSE,
  GDK_SOURCE_PEN,
  GDK_SOURCE_ERASER,
  GDK_SOURCE_CURSOR
} GdkInputSource;
Elliot Lee's avatar
Elliot Lee committed
29

Owen Taylor's avatar
Owen Taylor committed
30 31 32 33 34 35
typedef enum
{
  GDK_MODE_DISABLED,
  GDK_MODE_SCREEN,
  GDK_MODE_WINDOW
} GdkInputMode;
Elliot Lee's avatar
Elliot Lee committed
36

Owen Taylor's avatar
Owen Taylor committed
37 38 39 40 41 42 43 44
typedef enum
{
  GDK_AXIS_IGNORE,
  GDK_AXIS_X,
  GDK_AXIS_Y,
  GDK_AXIS_PRESSURE,
  GDK_AXIS_XTILT,
  GDK_AXIS_YTILT,
45
  GDK_AXIS_WHEEL,
Owen Taylor's avatar
Owen Taylor committed
46 47 48
  GDK_AXIS_LAST
} GdkAxisUse;

49 50 51 52 53 54 55 56 57 58 59 60 61 62
struct _GdkDeviceKey
{
  guint keyval;
  GdkModifierType modifiers;
};

struct _GdkDeviceAxis
{
  GdkAxisUse use;
  gdouble    min;
  gdouble    max;
};

struct _GdkDevice
Owen Taylor's avatar
Owen Taylor committed
63
{
64 65
  /* All fields are read-only */
	  
Owen Taylor's avatar
Owen Taylor committed
66 67 68
  gchar *name;
  GdkInputSource source;
  GdkInputMode mode;
69 70
  gboolean has_cursor;	     /* TRUE if the X pointer follows device motion */
	  
Owen Taylor's avatar
Owen Taylor committed
71
  gint num_axes;
72 73
  GdkDeviceAxis *axes;
	  
Owen Taylor's avatar
Owen Taylor committed
74 75
  gint num_keys;
  GdkDeviceKey *keys;
Elliot Lee's avatar
Elliot Lee committed
76 77
};

78 79 80 81
/* We don't allocate each coordinate this big, but we use it to
 * be ANSI compliant and avoid accessing past the defined limits.
 */
#define GDK_MAX_TIMECOORD_AXES 128
Elliot Lee's avatar
Elliot Lee committed
82

Owen Taylor's avatar
Owen Taylor committed
83
struct _GdkTimeCoord
Elliot Lee's avatar
Elliot Lee committed
84
{
Owen Taylor's avatar
Owen Taylor committed
85
  guint32 time;
86
  gdouble axes[GDK_MAX_TIMECOORD_AXES];
Elliot Lee's avatar
Elliot Lee committed
87 88
};

89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126
/* Returns a list of GdkDevice * */	  
GList *        gdk_devices_list         (void);

/* Functions to configure a device */
void           gdk_device_set_source    (GdkDevice      *device,
					 GdkInputSource  source);
	  
gboolean       gdk_device_set_mode      (GdkDevice      *device,
					 GdkInputMode    mode);

void           gdk_device_set_key       (GdkDevice      *device,
					 guint           index,
					 guint           keyval,
					 GdkModifierType modifiers);

void     gdk_device_set_axis_use (GdkDevice         *device,
				  guint              index,
				  GdkAxisUse         use);
void     gdk_device_get_state    (GdkDevice         *device,
				  GdkWindow         *window,
				  gdouble           *axes,
				  GdkModifierType   *mask);
gboolean gdk_device_get_history  (GdkDevice         *device,
				  GdkWindow         *window,
				  guint32            start,
				  guint32            stop,
				  GdkTimeCoord    ***events,
				  gint              *n_events);
void     gdk_device_free_history (GdkTimeCoord     **events,
				  gint               n_events);
gboolean gdk_device_get_axis     (GdkDevice         *device,
				  gdouble           *axes,
				  GdkAxisUse         use,
				  gdouble           *value);

void gdk_input_set_extension_events (GdkWindow        *window,
				     gint              mask,
				     GdkExtensionMode  mode);
Owen Taylor's avatar
Owen Taylor committed
127

Tor Lillqvist's avatar
Tor Lillqvist committed
128
GDKVAR GdkDevice *gdk_core_pointer;
129
 
Owen Taylor's avatar
Owen Taylor committed
130 131 132
#ifdef __cplusplus
}
#endif /* __cplusplus */
Elliot Lee's avatar
Elliot Lee committed
133

Owen Taylor's avatar
Owen Taylor committed
134
#endif /* __GDK_INPUT_H__ */