1 | /************************************************************
|
---|
2 |
|
---|
3 | Copyright 1987, 1998 The Open Group
|
---|
4 |
|
---|
5 | Permission to use, copy, modify, distribute, and sell this software and its
|
---|
6 | documentation for any purpose is hereby granted without fee, provided that
|
---|
7 | the above copyright notice appear in all copies and that both that
|
---|
8 | copyright notice and this permission notice appear in supporting
|
---|
9 | documentation.
|
---|
10 |
|
---|
11 | The above copyright notice and this permission notice shall be included in
|
---|
12 | all copies or substantial portions of the Software.
|
---|
13 |
|
---|
14 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
---|
15 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
---|
16 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
---|
17 | OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
|
---|
18 | AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
---|
19 | CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
---|
20 |
|
---|
21 | Except as contained in this notice, the name of The Open Group shall not be
|
---|
22 | used in advertising or otherwise to promote the sale, use or other dealings
|
---|
23 | in this Software without prior written authorization from The Open Group.
|
---|
24 |
|
---|
25 | Copyright 1987 by Digital Equipment Corporation, Maynard, Massachusetts.
|
---|
26 |
|
---|
27 | All Rights Reserved
|
---|
28 |
|
---|
29 | Permission to use, copy, modify, and distribute this software and its
|
---|
30 | documentation for any purpose and without fee is hereby granted,
|
---|
31 | provided that the above copyright notice appear in all copies and that
|
---|
32 | both that copyright notice and this permission notice appear in
|
---|
33 | supporting documentation, and that the name of Digital not be
|
---|
34 | used in advertising or publicity pertaining to distribution of the
|
---|
35 | software without specific, written prior permission.
|
---|
36 |
|
---|
37 | DIGITAL DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING
|
---|
38 | ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL
|
---|
39 | DIGITAL BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR
|
---|
40 | ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
|
---|
41 | WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
|
---|
42 | ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
|
---|
43 | SOFTWARE.
|
---|
44 |
|
---|
45 | ********************************************************/
|
---|
46 |
|
---|
47 | #ifndef INPUT_H
|
---|
48 | #define INPUT_H
|
---|
49 |
|
---|
50 | #include "misc.h"
|
---|
51 | #include "screenint.h"
|
---|
52 | #include <X11/Xmd.h>
|
---|
53 | #include <X11/Xproto.h>
|
---|
54 | #include <stdint.h>
|
---|
55 | #include "window.h" /* for WindowPtr */
|
---|
56 | #include "xkbrules.h"
|
---|
57 | #include "events.h"
|
---|
58 | #include "list.h"
|
---|
59 | #include <X11/extensions/XI2.h>
|
---|
60 |
|
---|
61 | #define DEVICE_INIT 0
|
---|
62 | #define DEVICE_ON 1
|
---|
63 | #define DEVICE_OFF 2
|
---|
64 | #define DEVICE_CLOSE 3
|
---|
65 | #define DEVICE_ABORT 4
|
---|
66 |
|
---|
67 | #define POINTER_RELATIVE (1 << 1)
|
---|
68 | #define POINTER_ABSOLUTE (1 << 2)
|
---|
69 | #define POINTER_ACCELERATE (1 << 3)
|
---|
70 | #define POINTER_SCREEN (1 << 4) /* Data in screen coordinates */
|
---|
71 | #define POINTER_NORAW (1 << 5) /* Don't generate RawEvents */
|
---|
72 | #define POINTER_EMULATED (1 << 6) /* Event was emulated from another event */
|
---|
73 | #define POINTER_DESKTOP (1 << 7) /* Data in desktop coordinates */
|
---|
74 |
|
---|
75 | /* GetTouchEvent flags */
|
---|
76 | #define TOUCH_ACCEPT (1 << 0)
|
---|
77 | #define TOUCH_REJECT (1 << 1)
|
---|
78 | #define TOUCH_PENDING_END (1 << 2)
|
---|
79 | #define TOUCH_CLIENT_ID (1 << 3) /* touch ID is the client-visible id */
|
---|
80 | #define TOUCH_REPLAYING (1 << 4) /* event is being replayed */
|
---|
81 | #define TOUCH_POINTER_EMULATED (1 << 5) /* touch event may be pointer emulated */
|
---|
82 | #define TOUCH_END (1 << 6) /* really end this touch now */
|
---|
83 |
|
---|
84 | /*int constants for pointer acceleration schemes*/
|
---|
85 | #define PtrAccelNoOp 0
|
---|
86 | #define PtrAccelPredictable 1
|
---|
87 | #define PtrAccelLightweight 2
|
---|
88 | #define PtrAccelDefault PtrAccelPredictable
|
---|
89 |
|
---|
90 | #define MAX_VALUATORS 36
|
---|
91 | /* Maximum number of valuators, divided by six, rounded up, to get number
|
---|
92 | * of events. */
|
---|
93 | #define MAX_VALUATOR_EVENTS 6
|
---|
94 | #define MAX_BUTTONS 256 /* completely arbitrarily chosen */
|
---|
95 |
|
---|
96 | #define NO_AXIS_LIMITS -1
|
---|
97 |
|
---|
98 | #define MAP_LENGTH MAX_BUTTONS
|
---|
99 | #define DOWN_LENGTH (MAX_BUTTONS/8) /* 256/8 => number of bytes to hold 256 bits */
|
---|
100 | #define NullGrab ((GrabPtr)NULL)
|
---|
101 | #define PointerRootWin ((WindowPtr)PointerRoot)
|
---|
102 | #define NoneWin ((WindowPtr)None)
|
---|
103 | #define NullDevice ((DevicePtr)NULL)
|
---|
104 |
|
---|
105 | #ifndef FollowKeyboard
|
---|
106 | #define FollowKeyboard 3
|
---|
107 | #endif
|
---|
108 | #ifndef FollowKeyboardWin
|
---|
109 | #define FollowKeyboardWin ((WindowPtr) FollowKeyboard)
|
---|
110 | #endif
|
---|
111 | #ifndef RevertToFollowKeyboard
|
---|
112 | #define RevertToFollowKeyboard 3
|
---|
113 | #endif
|
---|
114 |
|
---|
115 | enum InputLevel {
|
---|
116 | CORE = 1,
|
---|
117 | XI = 2,
|
---|
118 | XI2 = 3,
|
---|
119 | };
|
---|
120 |
|
---|
121 | typedef unsigned long Leds;
|
---|
122 | typedef struct _OtherClients *OtherClientsPtr;
|
---|
123 | typedef struct _InputClients *InputClientsPtr;
|
---|
124 | typedef struct _DeviceIntRec *DeviceIntPtr;
|
---|
125 | typedef struct _ValuatorClassRec *ValuatorClassPtr;
|
---|
126 | typedef struct _ClassesRec *ClassesPtr;
|
---|
127 | typedef struct _SpriteRec *SpritePtr;
|
---|
128 | typedef struct _TouchClassRec *TouchClassPtr;
|
---|
129 | typedef struct _TouchPointInfo *TouchPointInfoPtr;
|
---|
130 | typedef struct _DDXTouchPointInfo *DDXTouchPointInfoPtr;
|
---|
131 | typedef union _GrabMask GrabMask;
|
---|
132 |
|
---|
133 | typedef struct _ValuatorMask ValuatorMask;
|
---|
134 |
|
---|
135 | /* The DIX stores incoming input events in this list */
|
---|
136 | extern InternalEvent *InputEventList;
|
---|
137 |
|
---|
138 | typedef int (*DeviceProc) (DeviceIntPtr /*device */ ,
|
---|
139 | int /*what */ );
|
---|
140 |
|
---|
141 | typedef void (*ProcessInputProc) (InternalEvent * /*event */ ,
|
---|
142 | DeviceIntPtr /*device */ );
|
---|
143 |
|
---|
144 | typedef Bool (*DeviceHandleProc) (DeviceIntPtr /*device */ ,
|
---|
145 | void * /*data */
|
---|
146 | );
|
---|
147 |
|
---|
148 | typedef void (*DeviceUnwrapProc) (DeviceIntPtr /*device */ ,
|
---|
149 | DeviceHandleProc /*proc */ ,
|
---|
150 | void * /*data */
|
---|
151 | );
|
---|
152 |
|
---|
153 | /* pointer acceleration handling */
|
---|
154 | typedef void (*PointerAccelSchemeProc) (DeviceIntPtr /*device */ ,
|
---|
155 | ValuatorMask * /*valuators */ ,
|
---|
156 | CARD32 /*evtime */ );
|
---|
157 |
|
---|
158 | typedef void (*DeviceCallbackProc) (DeviceIntPtr /*pDev */ );
|
---|
159 |
|
---|
160 | struct _ValuatorAccelerationRec;
|
---|
161 | typedef Bool (*PointerAccelSchemeInitProc) (DeviceIntPtr /*dev */ ,
|
---|
162 | struct _ValuatorAccelerationRec *
|
---|
163 | /*protoScheme */ );
|
---|
164 |
|
---|
165 | typedef struct _DeviceRec {
|
---|
166 | void *devicePrivate;
|
---|
167 | ProcessInputProc processInputProc; /* current */
|
---|
168 | ProcessInputProc realInputProc; /* deliver */
|
---|
169 | ProcessInputProc enqueueInputProc; /* enqueue */
|
---|
170 | Bool on; /* used by DDX to keep state */
|
---|
171 | } DeviceRec, *DevicePtr;
|
---|
172 |
|
---|
173 | typedef struct {
|
---|
174 | int click, bell, bell_pitch, bell_duration;
|
---|
175 | Bool autoRepeat;
|
---|
176 | unsigned char autoRepeats[32];
|
---|
177 | Leds leds;
|
---|
178 | unsigned char id;
|
---|
179 | } KeybdCtrl;
|
---|
180 |
|
---|
181 | typedef struct {
|
---|
182 | KeySym *map;
|
---|
183 | KeyCode minKeyCode, maxKeyCode;
|
---|
184 | int mapWidth;
|
---|
185 | } KeySymsRec, *KeySymsPtr;
|
---|
186 |
|
---|
187 | typedef struct {
|
---|
188 | int num, den, threshold;
|
---|
189 | unsigned char id;
|
---|
190 | } PtrCtrl;
|
---|
191 |
|
---|
192 | typedef struct {
|
---|
193 | int resolution, min_value, max_value;
|
---|
194 | int integer_displayed;
|
---|
195 | unsigned char id;
|
---|
196 | } IntegerCtrl;
|
---|
197 |
|
---|
198 | typedef struct {
|
---|
199 | int max_symbols, num_symbols_supported;
|
---|
200 | int num_symbols_displayed;
|
---|
201 | KeySym *symbols_supported;
|
---|
202 | KeySym *symbols_displayed;
|
---|
203 | unsigned char id;
|
---|
204 | } StringCtrl;
|
---|
205 |
|
---|
206 | typedef struct {
|
---|
207 | int percent, pitch, duration;
|
---|
208 | unsigned char id;
|
---|
209 | } BellCtrl;
|
---|
210 |
|
---|
211 | typedef struct {
|
---|
212 | Leds led_values;
|
---|
213 | Mask led_mask;
|
---|
214 | unsigned char id;
|
---|
215 | } LedCtrl;
|
---|
216 |
|
---|
217 | extern _X_EXPORT KeybdCtrl defaultKeyboardControl;
|
---|
218 | extern _X_EXPORT PtrCtrl defaultPointerControl;
|
---|
219 |
|
---|
220 | typedef struct _InputOption InputOption;
|
---|
221 | typedef struct _XI2Mask XI2Mask;
|
---|
222 |
|
---|
223 | typedef struct _InputAttributes {
|
---|
224 | char *product;
|
---|
225 | char *vendor;
|
---|
226 | char *device;
|
---|
227 | char *pnp_id;
|
---|
228 | char *usb_id;
|
---|
229 | char **tags; /* null-terminated */
|
---|
230 | uint32_t flags;
|
---|
231 | } InputAttributes;
|
---|
232 |
|
---|
233 | #define ATTR_KEYBOARD (1<<0)
|
---|
234 | #define ATTR_POINTER (1<<1)
|
---|
235 | #define ATTR_JOYSTICK (1<<2)
|
---|
236 | #define ATTR_TABLET (1<<3)
|
---|
237 | #define ATTR_TOUCHPAD (1<<4)
|
---|
238 | #define ATTR_TOUCHSCREEN (1<<5)
|
---|
239 |
|
---|
240 | /* Key/Button has been run through all input processing and events sent to clients. */
|
---|
241 | #define KEY_PROCESSED 1
|
---|
242 | #define BUTTON_PROCESSED 1
|
---|
243 | /* Key/Button has not been fully processed, no events have been sent. */
|
---|
244 | #define KEY_POSTED 2
|
---|
245 | #define BUTTON_POSTED 2
|
---|
246 |
|
---|
247 | extern _X_EXPORT void set_key_down(DeviceIntPtr pDev, int key_code, int type);
|
---|
248 | extern _X_EXPORT void set_key_up(DeviceIntPtr pDev, int key_code, int type);
|
---|
249 | extern _X_EXPORT int key_is_down(DeviceIntPtr pDev, int key_code, int type);
|
---|
250 | extern _X_EXPORT void set_button_down(DeviceIntPtr pDev, int button, int type);
|
---|
251 | extern _X_EXPORT void set_button_up(DeviceIntPtr pDev, int button, int type);
|
---|
252 | extern _X_EXPORT int button_is_down(DeviceIntPtr pDev, int button, int type);
|
---|
253 |
|
---|
254 | extern void InitCoreDevices(void);
|
---|
255 | extern void InitXTestDevices(void);
|
---|
256 |
|
---|
257 | extern _X_EXPORT DeviceIntPtr AddInputDevice(ClientPtr /*client */ ,
|
---|
258 | DeviceProc /*deviceProc */ ,
|
---|
259 | Bool /*autoStart */ );
|
---|
260 |
|
---|
261 | extern _X_EXPORT Bool EnableDevice(DeviceIntPtr /*device */ ,
|
---|
262 | BOOL /* sendevent */ );
|
---|
263 |
|
---|
264 | extern _X_EXPORT Bool ActivateDevice(DeviceIntPtr /*device */ ,
|
---|
265 | BOOL /* sendevent */ );
|
---|
266 |
|
---|
267 | extern _X_EXPORT Bool DisableDevice(DeviceIntPtr /*device */ ,
|
---|
268 | BOOL /* sendevent */ );
|
---|
269 | extern void DisableAllDevices(void);
|
---|
270 | extern int InitAndStartDevices(void);
|
---|
271 |
|
---|
272 | extern void CloseDownDevices(void);
|
---|
273 | extern void AbortDevices(void);
|
---|
274 |
|
---|
275 | extern void UndisplayDevices(void);
|
---|
276 |
|
---|
277 | extern _X_EXPORT int RemoveDevice(DeviceIntPtr /*dev */ ,
|
---|
278 | BOOL /* sendevent */ );
|
---|
279 |
|
---|
280 | extern _X_EXPORT int NumMotionEvents(void);
|
---|
281 |
|
---|
282 | extern _X_EXPORT int dixLookupDevice(DeviceIntPtr * /* dev */ ,
|
---|
283 | int /* id */ ,
|
---|
284 | ClientPtr /* client */ ,
|
---|
285 | Mask /* access_mode */ );
|
---|
286 |
|
---|
287 | extern _X_EXPORT void QueryMinMaxKeyCodes(KeyCode * /*minCode */ ,
|
---|
288 | KeyCode * /*maxCode */ );
|
---|
289 |
|
---|
290 | extern _X_EXPORT Bool InitButtonClassDeviceStruct(DeviceIntPtr /*device */ ,
|
---|
291 | int /*numButtons */ ,
|
---|
292 | Atom * /* labels */ ,
|
---|
293 | CARD8 * /*map */ );
|
---|
294 |
|
---|
295 | extern _X_INTERNAL ValuatorClassPtr AllocValuatorClass(ValuatorClassPtr src,
|
---|
296 | int numAxes);
|
---|
297 |
|
---|
298 | extern _X_EXPORT Bool InitValuatorClassDeviceStruct(DeviceIntPtr /*device */ ,
|
---|
299 | int /*numAxes */ ,
|
---|
300 | Atom * /* labels */ ,
|
---|
301 | int /*numMotionEvents */ ,
|
---|
302 | int /*mode */ );
|
---|
303 |
|
---|
304 | extern _X_EXPORT Bool InitPointerAccelerationScheme(DeviceIntPtr /*dev */ ,
|
---|
305 | int /*scheme */ );
|
---|
306 |
|
---|
307 | extern _X_EXPORT Bool InitFocusClassDeviceStruct(DeviceIntPtr /*device */ );
|
---|
308 |
|
---|
309 | extern _X_EXPORT Bool InitTouchClassDeviceStruct(DeviceIntPtr /*device */ ,
|
---|
310 | unsigned int /*max_touches */ ,
|
---|
311 | unsigned int /*mode */ ,
|
---|
312 | unsigned int /*numAxes */ );
|
---|
313 |
|
---|
314 | typedef void (*BellProcPtr) (int percent,
|
---|
315 | DeviceIntPtr device,
|
---|
316 | void *ctrl,
|
---|
317 | int feedbackClass);
|
---|
318 |
|
---|
319 | typedef void (*KbdCtrlProcPtr) (DeviceIntPtr /*device */ ,
|
---|
320 | KeybdCtrl * /*ctrl */ );
|
---|
321 |
|
---|
322 | typedef void (*PtrCtrlProcPtr) (DeviceIntPtr /*device */ ,
|
---|
323 | PtrCtrl * /*ctrl */ );
|
---|
324 |
|
---|
325 | extern _X_EXPORT Bool InitPtrFeedbackClassDeviceStruct(DeviceIntPtr /*device */
|
---|
326 | ,
|
---|
327 | PtrCtrlProcPtr
|
---|
328 | /*controlProc */ );
|
---|
329 |
|
---|
330 | typedef void (*StringCtrlProcPtr) (DeviceIntPtr /*device */ ,
|
---|
331 | StringCtrl * /*ctrl */ );
|
---|
332 |
|
---|
333 | extern _X_EXPORT Bool InitStringFeedbackClassDeviceStruct(DeviceIntPtr
|
---|
334 | /*device */ ,
|
---|
335 | StringCtrlProcPtr
|
---|
336 | /*controlProc */ ,
|
---|
337 | int /*max_symbols */ ,
|
---|
338 | int
|
---|
339 | /*num_symbols_supported */
|
---|
340 | ,
|
---|
341 | KeySym * /*symbols */
|
---|
342 | );
|
---|
343 |
|
---|
344 | typedef void (*BellCtrlProcPtr) (DeviceIntPtr /*device */ ,
|
---|
345 | BellCtrl * /*ctrl */ );
|
---|
346 |
|
---|
347 | extern _X_EXPORT Bool InitBellFeedbackClassDeviceStruct(DeviceIntPtr /*device */
|
---|
348 | ,
|
---|
349 | BellProcPtr
|
---|
350 | /*bellProc */ ,
|
---|
351 | BellCtrlProcPtr
|
---|
352 | /*controlProc */ );
|
---|
353 |
|
---|
354 | typedef void (*LedCtrlProcPtr) (DeviceIntPtr /*device */ ,
|
---|
355 | LedCtrl * /*ctrl */ );
|
---|
356 |
|
---|
357 | extern _X_EXPORT Bool InitLedFeedbackClassDeviceStruct(DeviceIntPtr /*device */
|
---|
358 | ,
|
---|
359 | LedCtrlProcPtr
|
---|
360 | /*controlProc */ );
|
---|
361 |
|
---|
362 | typedef void (*IntegerCtrlProcPtr) (DeviceIntPtr /*device */ ,
|
---|
363 | IntegerCtrl * /*ctrl */ );
|
---|
364 |
|
---|
365 | extern _X_EXPORT Bool InitIntegerFeedbackClassDeviceStruct(DeviceIntPtr
|
---|
366 | /*device */ ,
|
---|
367 | IntegerCtrlProcPtr
|
---|
368 | /*controlProc */ );
|
---|
369 |
|
---|
370 | extern _X_EXPORT Bool InitPointerDeviceStruct(DevicePtr /*device */ ,
|
---|
371 | CARD8 * /*map */ ,
|
---|
372 | int /*numButtons */ ,
|
---|
373 | Atom * /* btn_labels */ ,
|
---|
374 | PtrCtrlProcPtr /*controlProc */ ,
|
---|
375 | int /*numMotionEvents */ ,
|
---|
376 | int /*numAxes */ ,
|
---|
377 | Atom * /* axes_labels */ );
|
---|
378 |
|
---|
379 | extern _X_EXPORT Bool InitKeyboardDeviceStruct(DeviceIntPtr /*device */ ,
|
---|
380 | XkbRMLVOSet * /*rmlvo */ ,
|
---|
381 | BellProcPtr /*bellProc */ ,
|
---|
382 | KbdCtrlProcPtr /*controlProc */
|
---|
383 | );
|
---|
384 |
|
---|
385 | extern _X_EXPORT Bool InitKeyboardDeviceStructFromString(DeviceIntPtr dev,
|
---|
386 | const char *keymap,
|
---|
387 | int keymap_length,
|
---|
388 | BellProcPtr bell_func,
|
---|
389 | KbdCtrlProcPtr ctrl_func);
|
---|
390 |
|
---|
391 | extern int ApplyPointerMapping(DeviceIntPtr /* pDev */ ,
|
---|
392 | CARD8 * /* map */ ,
|
---|
393 | int /* len */ ,
|
---|
394 | ClientPtr /* client */ );
|
---|
395 |
|
---|
396 | extern Bool BadDeviceMap(BYTE * /*buff */ ,
|
---|
397 | int /*length */ ,
|
---|
398 | unsigned /*low */ ,
|
---|
399 | unsigned /*high */ ,
|
---|
400 | XID * /*errval */ );
|
---|
401 |
|
---|
402 | extern void NoteLedState(DeviceIntPtr /*keybd */ ,
|
---|
403 | int /*led */ ,
|
---|
404 | Bool /*on */ );
|
---|
405 |
|
---|
406 | extern void MaybeStopHint(DeviceIntPtr /*device */ ,
|
---|
407 | ClientPtr /*client */ );
|
---|
408 |
|
---|
409 | extern void ProcessPointerEvent(InternalEvent * /* ev */ ,
|
---|
410 | DeviceIntPtr /*mouse */ );
|
---|
411 |
|
---|
412 | extern void ProcessKeyboardEvent(InternalEvent * /*ev */ ,
|
---|
413 | DeviceIntPtr /*keybd */ );
|
---|
414 |
|
---|
415 | extern Bool LegalModifier(unsigned int /*key */ ,
|
---|
416 | DeviceIntPtr /*pDev */ );
|
---|
417 |
|
---|
418 | extern _X_EXPORT void ProcessInputEvents(void);
|
---|
419 |
|
---|
420 | extern _X_EXPORT void InitInput(int /*argc */ ,
|
---|
421 | char ** /*argv */ );
|
---|
422 | extern _X_EXPORT void CloseInput(void);
|
---|
423 |
|
---|
424 | extern _X_EXPORT int GetMaximumEventsNum(void);
|
---|
425 |
|
---|
426 | extern _X_EXPORT InternalEvent *InitEventList(int num_events);
|
---|
427 | extern _X_EXPORT void FreeEventList(InternalEvent *list, int num_events);
|
---|
428 |
|
---|
429 | extern void CreateClassesChangedEvent(InternalEvent *event,
|
---|
430 | DeviceIntPtr master,
|
---|
431 | DeviceIntPtr slave, int flags);
|
---|
432 |
|
---|
433 | extern InternalEvent *UpdateFromMaster(InternalEvent *events,
|
---|
434 | DeviceIntPtr pDev,
|
---|
435 | int type, int *num_events);
|
---|
436 |
|
---|
437 | extern _X_EXPORT int GetPointerEvents(InternalEvent *events,
|
---|
438 | DeviceIntPtr pDev,
|
---|
439 | int type,
|
---|
440 | int buttons,
|
---|
441 | int flags, const ValuatorMask *mask);
|
---|
442 |
|
---|
443 | extern _X_EXPORT void QueuePointerEvents(DeviceIntPtr pDev,
|
---|
444 | int type,
|
---|
445 | int buttons,
|
---|
446 | int flags, const ValuatorMask *mask);
|
---|
447 |
|
---|
448 | extern _X_EXPORT int GetKeyboardEvents(InternalEvent *events,
|
---|
449 | DeviceIntPtr pDev,
|
---|
450 | int type,
|
---|
451 | int key_code, const ValuatorMask *mask);
|
---|
452 |
|
---|
453 | extern _X_EXPORT void QueueKeyboardEvents(DeviceIntPtr pDev,
|
---|
454 | int type,
|
---|
455 | int key_code,
|
---|
456 | const ValuatorMask *mask);
|
---|
457 |
|
---|
458 | extern int GetTouchEvents(InternalEvent *events,
|
---|
459 | DeviceIntPtr pDev,
|
---|
460 | uint32_t ddx_touchid,
|
---|
461 | uint16_t type,
|
---|
462 | uint32_t flags, const ValuatorMask *mask);
|
---|
463 |
|
---|
464 | void QueueTouchEvents(DeviceIntPtr device,
|
---|
465 | int type,
|
---|
466 | uint32_t ddx_touchid,
|
---|
467 | int flags, const ValuatorMask *mask);
|
---|
468 |
|
---|
469 | extern int GetTouchOwnershipEvents(InternalEvent *events,
|
---|
470 | DeviceIntPtr pDev,
|
---|
471 | TouchPointInfoPtr ti,
|
---|
472 | uint8_t mode, XID resource, uint32_t flags);
|
---|
473 |
|
---|
474 | extern void GetDixTouchEnd(InternalEvent *ievent,
|
---|
475 | DeviceIntPtr dev,
|
---|
476 | TouchPointInfoPtr ti,
|
---|
477 | uint32_t flags);
|
---|
478 |
|
---|
479 | extern _X_EXPORT int GetProximityEvents(InternalEvent *events,
|
---|
480 | DeviceIntPtr pDev,
|
---|
481 | int type, const ValuatorMask *mask);
|
---|
482 |
|
---|
483 | extern _X_EXPORT void QueueProximityEvents(DeviceIntPtr pDev,
|
---|
484 | int type, const ValuatorMask *mask);
|
---|
485 |
|
---|
486 | #ifdef PANORAMIX
|
---|
487 | _X_EXPORT
|
---|
488 | #endif
|
---|
489 | extern void PostSyntheticMotion(DeviceIntPtr pDev,
|
---|
490 | int x, int y, int screen, unsigned long time);
|
---|
491 |
|
---|
492 | extern _X_EXPORT int GetMotionHistorySize(void);
|
---|
493 |
|
---|
494 | extern _X_EXPORT void AllocateMotionHistory(DeviceIntPtr pDev);
|
---|
495 |
|
---|
496 | extern _X_EXPORT int GetMotionHistory(DeviceIntPtr pDev,
|
---|
497 | xTimecoord ** buff,
|
---|
498 | unsigned long start,
|
---|
499 | unsigned long stop,
|
---|
500 | ScreenPtr pScreen, BOOL core);
|
---|
501 |
|
---|
502 | extern void ReleaseButtonsAndKeys(DeviceIntPtr dev);
|
---|
503 |
|
---|
504 | extern int AttachDevice(ClientPtr client,
|
---|
505 | DeviceIntPtr slave, DeviceIntPtr master);
|
---|
506 |
|
---|
507 | extern _X_EXPORT DeviceIntPtr GetPairedDevice(DeviceIntPtr kbd);
|
---|
508 | extern DeviceIntPtr GetMaster(DeviceIntPtr dev, int type);
|
---|
509 |
|
---|
510 | extern _X_EXPORT int AllocDevicePair(ClientPtr client,
|
---|
511 | const char *name,
|
---|
512 | DeviceIntPtr *ptr,
|
---|
513 | DeviceIntPtr *keybd,
|
---|
514 | DeviceProc ptr_proc,
|
---|
515 | DeviceProc keybd_proc, Bool master);
|
---|
516 | extern void DeepCopyDeviceClasses(DeviceIntPtr from,
|
---|
517 | DeviceIntPtr to, DeviceChangedEvent *dce);
|
---|
518 |
|
---|
519 | /* Helper functions. */
|
---|
520 | extern _X_EXPORT int generate_modkeymap(ClientPtr client, DeviceIntPtr dev,
|
---|
521 | KeyCode **modkeymap,
|
---|
522 | int *max_keys_per_mod);
|
---|
523 | extern int change_modmap(ClientPtr client, DeviceIntPtr dev, KeyCode *map,
|
---|
524 | int max_keys_per_mod);
|
---|
525 | extern int AllocXTestDevice(ClientPtr client, const char *name,
|
---|
526 | DeviceIntPtr *ptr, DeviceIntPtr *keybd,
|
---|
527 | DeviceIntPtr master_ptr, DeviceIntPtr master_keybd);
|
---|
528 | extern BOOL IsXTestDevice(DeviceIntPtr dev, DeviceIntPtr master);
|
---|
529 | extern DeviceIntPtr GetXTestDevice(DeviceIntPtr master);
|
---|
530 | extern void SendDevicePresenceEvent(int deviceid, int type);
|
---|
531 | extern _X_EXPORT InputAttributes *DuplicateInputAttributes(InputAttributes *
|
---|
532 | attrs);
|
---|
533 | extern _X_EXPORT void FreeInputAttributes(InputAttributes * attrs);
|
---|
534 |
|
---|
535 | enum TouchListenerState {
|
---|
536 | LISTENER_AWAITING_BEGIN = 0, /**< Waiting for a TouchBegin event */
|
---|
537 | LISTENER_AWAITING_OWNER, /**< Waiting for a TouchOwnership event */
|
---|
538 | LISTENER_EARLY_ACCEPT, /**< Waiting for ownership, has already
|
---|
539 | accepted */
|
---|
540 | LISTENER_IS_OWNER, /**< Is the current owner, hasn't accepted */
|
---|
541 | LISTENER_HAS_ACCEPTED, /**< Is the current owner, has accepted */
|
---|
542 | LISTENER_HAS_END, /**< Has already received the end event */
|
---|
543 | };
|
---|
544 |
|
---|
545 | enum TouchListenerType {
|
---|
546 | LISTENER_GRAB,
|
---|
547 | LISTENER_POINTER_GRAB,
|
---|
548 | LISTENER_REGULAR,
|
---|
549 | LISTENER_POINTER_REGULAR,
|
---|
550 | };
|
---|
551 |
|
---|
552 | extern void TouchInitDDXTouchPoint(DeviceIntPtr dev,
|
---|
553 | DDXTouchPointInfoPtr ddxtouch);
|
---|
554 | extern DDXTouchPointInfoPtr TouchBeginDDXTouch(DeviceIntPtr dev,
|
---|
555 | uint32_t ddx_id);
|
---|
556 | extern void TouchEndDDXTouch(DeviceIntPtr dev, DDXTouchPointInfoPtr ti);
|
---|
557 | extern DDXTouchPointInfoPtr TouchFindByDDXID(DeviceIntPtr dev,
|
---|
558 | uint32_t ddx_id, Bool create);
|
---|
559 | extern Bool TouchInitTouchPoint(TouchClassPtr touch, ValuatorClassPtr v,
|
---|
560 | int index);
|
---|
561 | extern void TouchFreeTouchPoint(DeviceIntPtr dev, int index);
|
---|
562 | extern TouchPointInfoPtr TouchBeginTouch(DeviceIntPtr dev, int sourceid,
|
---|
563 | uint32_t touchid,
|
---|
564 | Bool emulate_pointer);
|
---|
565 | extern TouchPointInfoPtr TouchFindByClientID(DeviceIntPtr dev,
|
---|
566 | uint32_t client_id);
|
---|
567 | extern void TouchEndTouch(DeviceIntPtr dev, TouchPointInfoPtr ti);
|
---|
568 | extern Bool TouchEventHistoryAllocate(TouchPointInfoPtr ti);
|
---|
569 | extern void TouchEventHistoryFree(TouchPointInfoPtr ti);
|
---|
570 | extern void TouchEventHistoryPush(TouchPointInfoPtr ti, const DeviceEvent *ev);
|
---|
571 | extern void TouchEventHistoryReplay(TouchPointInfoPtr ti, DeviceIntPtr dev,
|
---|
572 | XID resource);
|
---|
573 | extern Bool TouchResourceIsOwner(TouchPointInfoPtr ti, XID resource);
|
---|
574 | extern void TouchAddListener(TouchPointInfoPtr ti, XID resource, int resource_type,
|
---|
575 | enum InputLevel level, enum TouchListenerType type,
|
---|
576 | enum TouchListenerState state, WindowPtr window, GrabPtr grab);
|
---|
577 | extern Bool TouchRemoveListener(TouchPointInfoPtr ti, XID resource);
|
---|
578 | extern void TouchSetupListeners(DeviceIntPtr dev, TouchPointInfoPtr ti,
|
---|
579 | InternalEvent *ev);
|
---|
580 | extern Bool TouchBuildSprite(DeviceIntPtr sourcedev, TouchPointInfoPtr ti,
|
---|
581 | InternalEvent *ev);
|
---|
582 | extern Bool TouchBuildDependentSpriteTrace(DeviceIntPtr dev, SpritePtr sprite);
|
---|
583 | extern int TouchConvertToPointerEvent(const InternalEvent *ev,
|
---|
584 | InternalEvent *motion,
|
---|
585 | InternalEvent *button);
|
---|
586 | extern int TouchGetPointerEventType(const InternalEvent *ev);
|
---|
587 | extern void TouchRemovePointerGrab(DeviceIntPtr dev);
|
---|
588 | extern void TouchListenerGone(XID resource);
|
---|
589 | extern int TouchListenerAcceptReject(DeviceIntPtr dev, TouchPointInfoPtr ti,
|
---|
590 | int listener, int mode);
|
---|
591 | extern int TouchAcceptReject(ClientPtr client, DeviceIntPtr dev, int mode,
|
---|
592 | uint32_t touchid, Window grab_window, XID *error);
|
---|
593 | extern void TouchEndPhysicallyActiveTouches(DeviceIntPtr dev);
|
---|
594 | extern void TouchDeliverDeviceClassesChangedEvent(TouchPointInfoPtr ti,
|
---|
595 | Time time, XID resource);
|
---|
596 | extern void TouchEmitTouchEnd(DeviceIntPtr dev, TouchPointInfoPtr ti, int flags, XID resource);
|
---|
597 | extern void TouchAcceptAndEnd(DeviceIntPtr dev, int touchid);
|
---|
598 |
|
---|
599 | /* misc event helpers */
|
---|
600 | extern Mask GetEventMask(DeviceIntPtr dev, xEvent *ev, InputClientsPtr clients);
|
---|
601 | extern Mask GetEventFilter(DeviceIntPtr dev, xEvent *event);
|
---|
602 | extern Bool WindowXI2MaskIsset(DeviceIntPtr dev, WindowPtr win, xEvent *ev);
|
---|
603 | extern int GetXI2MaskByte(XI2Mask *mask, DeviceIntPtr dev, int event_type);
|
---|
604 | void FixUpEventFromWindow(SpritePtr pSprite,
|
---|
605 | xEvent *xE,
|
---|
606 | WindowPtr pWin, Window child, Bool calcChild);
|
---|
607 | extern Bool PointInBorderSize(WindowPtr pWin, int x, int y);
|
---|
608 | extern WindowPtr XYToWindow(SpritePtr pSprite, int x, int y);
|
---|
609 | extern int EventIsDeliverable(DeviceIntPtr dev, int evtype, WindowPtr win);
|
---|
610 | extern Bool ActivatePassiveGrab(DeviceIntPtr dev, GrabPtr grab,
|
---|
611 | InternalEvent *ev, InternalEvent *real_event);
|
---|
612 | /**
|
---|
613 | * Masks specifying the type of event to deliver for an InternalEvent; used
|
---|
614 | * by EventIsDeliverable.
|
---|
615 | * @defgroup EventIsDeliverable return flags
|
---|
616 | * @{
|
---|
617 | */
|
---|
618 | #define EVENT_XI1_MASK (1 << 0) /**< XI1.x event */
|
---|
619 | #define EVENT_CORE_MASK (1 << 1) /**< Core event */
|
---|
620 | #define EVENT_DONT_PROPAGATE_MASK (1 << 2) /**< DontPropagate mask set */
|
---|
621 | #define EVENT_XI2_MASK (1 << 3) /**< XI2 mask set on window */
|
---|
622 | /* @} */
|
---|
623 |
|
---|
624 | enum EventDeliveryState {
|
---|
625 | EVENT_DELIVERED, /**< Event has been delivered to a client */
|
---|
626 | EVENT_NOT_DELIVERED, /**< Event was not delivered to any client */
|
---|
627 | EVENT_SKIP, /**< Event can be discarded by the caller */
|
---|
628 | EVENT_REJECTED, /**< Event was rejected for delivery to the client */
|
---|
629 | };
|
---|
630 |
|
---|
631 | /* Implemented by the DDX. */
|
---|
632 | extern _X_EXPORT int NewInputDeviceRequest(InputOption *options,
|
---|
633 | InputAttributes * attrs,
|
---|
634 | DeviceIntPtr *dev);
|
---|
635 | extern _X_EXPORT void DeleteInputDeviceRequest(DeviceIntPtr dev);
|
---|
636 |
|
---|
637 | extern _X_EXPORT void DDXRingBell(int volume, int pitch, int duration);
|
---|
638 |
|
---|
639 | #define VALUATOR_MODE_ALL_AXES -1
|
---|
640 | extern _X_HIDDEN int valuator_get_mode(DeviceIntPtr dev, int axis);
|
---|
641 | extern _X_HIDDEN void valuator_set_mode(DeviceIntPtr dev, int axis, int mode);
|
---|
642 |
|
---|
643 | /* Set to TRUE by default - os/utils.c sets it to FALSE on user request,
|
---|
644 | xfixes/cursor.c uses it to determine if the cursor is enabled */
|
---|
645 | extern Bool EnableCursor;
|
---|
646 |
|
---|
647 | /* Set to FALSE by default - ChangeWindowAttributes sets it to TRUE on
|
---|
648 | * CWCursor, xfixes/cursor.c uses it to determine if the cursor is enabled
|
---|
649 | */
|
---|
650 | extern Bool CursorVisible;
|
---|
651 |
|
---|
652 | extern _X_EXPORT ValuatorMask *valuator_mask_new(int num_valuators);
|
---|
653 | extern _X_EXPORT void valuator_mask_free(ValuatorMask **mask);
|
---|
654 | extern _X_EXPORT void valuator_mask_set_range(ValuatorMask *mask,
|
---|
655 | int first_valuator,
|
---|
656 | int num_valuators,
|
---|
657 | const int *valuators);
|
---|
658 | extern _X_EXPORT void valuator_mask_set(ValuatorMask *mask, int valuator,
|
---|
659 | int data);
|
---|
660 | extern _X_EXPORT void valuator_mask_set_double(ValuatorMask *mask, int valuator,
|
---|
661 | double data);
|
---|
662 | extern _X_EXPORT void valuator_mask_zero(ValuatorMask *mask);
|
---|
663 | extern _X_EXPORT int valuator_mask_size(const ValuatorMask *mask);
|
---|
664 | extern _X_EXPORT int valuator_mask_isset(const ValuatorMask *mask, int bit);
|
---|
665 | extern _X_EXPORT void valuator_mask_unset(ValuatorMask *mask, int bit);
|
---|
666 | extern _X_EXPORT int valuator_mask_num_valuators(const ValuatorMask *mask);
|
---|
667 | extern _X_EXPORT void valuator_mask_copy(ValuatorMask *dest,
|
---|
668 | const ValuatorMask *src);
|
---|
669 | extern _X_EXPORT int valuator_mask_get(const ValuatorMask *mask, int valnum);
|
---|
670 | extern _X_EXPORT double valuator_mask_get_double(const ValuatorMask *mask,
|
---|
671 | int valnum);
|
---|
672 | extern _X_EXPORT Bool valuator_mask_fetch(const ValuatorMask *mask,
|
---|
673 | int valnum, int *val);
|
---|
674 | extern _X_EXPORT Bool valuator_mask_fetch_double(const ValuatorMask *mask,
|
---|
675 | int valnum, double *val);
|
---|
676 |
|
---|
677 | /* InputOption handling interface */
|
---|
678 | extern _X_EXPORT InputOption *input_option_new(InputOption *list,
|
---|
679 | const char *key,
|
---|
680 | const char *value);
|
---|
681 | extern _X_EXPORT void input_option_free_list(InputOption **opt);
|
---|
682 | extern _X_EXPORT InputOption *input_option_free_element(InputOption *opt,
|
---|
683 | const char *key);
|
---|
684 | extern _X_EXPORT InputOption *input_option_find(InputOption *list,
|
---|
685 | const char *key);
|
---|
686 | extern _X_EXPORT const char *input_option_get_key(const InputOption *opt);
|
---|
687 | extern _X_EXPORT const char *input_option_get_value(const InputOption *opt);
|
---|
688 | extern _X_EXPORT void input_option_set_key(InputOption *opt, const char *key);
|
---|
689 | extern _X_EXPORT void input_option_set_value(InputOption *opt,
|
---|
690 | const char *value);
|
---|
691 |
|
---|
692 | extern _X_HIDDEN Bool point_on_screen(ScreenPtr pScreen, int x, int y);
|
---|
693 | extern _X_HIDDEN void update_desktop_dimensions(void);
|
---|
694 |
|
---|
695 | extern _X_HIDDEN void input_constrain_cursor(DeviceIntPtr pDev, ScreenPtr screen,
|
---|
696 | int current_x, int current_y,
|
---|
697 | int dest_x, int dest_y,
|
---|
698 | int *out_x, int *out_y,
|
---|
699 | int *nevents, InternalEvent* events);
|
---|
700 |
|
---|
701 | #endif /* INPUT_H */
|
---|