UI: Adopt 2.8-style layout for the Graph Editor sidebar
[blender.git] / source / blender / windowmanager / wm_event_types.h
1 /*
2  * This program is free software; you can redistribute it and/or
3  * modify it under the terms of the GNU General Public License
4  * as published by the Free Software Foundation; either version 2
5  * of the License, or (at your option) any later version.
6  *
7  * This program is distributed in the hope that it will be useful,
8  * but WITHOUT ANY WARRANTY; without even the implied warranty of
9  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
10  * GNU General Public License for more details.
11  *
12  * You should have received a copy of the GNU General Public License
13  * along with this program; if not, write to the Free Software Foundation,
14  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
15  */
16
17 /** \file
18  * \ingroup wm
19  */
20
21 /*
22  * These define have its origin at sgi, where all device defines were written down in device.h.
23  * Blender copied the conventions quite some, and expanded it with internal new defines (ton)
24  */
25
26 #ifndef __WM_EVENT_TYPES_H__
27 #define __WM_EVENT_TYPES_H__
28
29 /* customdata type */
30 enum {
31   EVT_DATA_GESTURE = 1,
32   EVT_DATA_TIMER = 2,
33   EVT_DATA_DRAGDROP = 3,
34   EVT_DATA_NDOF_MOTION = 4,
35 };
36
37 /* tablet active, matches GHOST_TTabletMode */
38 enum {
39   EVT_TABLET_NONE = 0,
40   EVT_TABLET_STYLUS = 1,
41   EVT_TABLET_ERASER = 2,
42 };
43
44 /* ********** wmEvent.type ********** */
45 enum {
46   /* non-event, for example disabled timer */
47   EVENT_NONE = 0x0000,
48
49   /* ********** Start of Input devices. ********** */
50
51   /* MOUSE : 0x000x, 0x001x */
52   LEFTMOUSE = 0x0001,
53   MIDDLEMOUSE = 0x0002,
54   RIGHTMOUSE = 0x0003,
55   MOUSEMOVE = 0x0004,
56   /* Extra mouse buttons */
57   BUTTON4MOUSE = 0x0007,
58   BUTTON5MOUSE = 0x0008,
59   /* More mouse buttons - can't use 9 and 10 here (wheel) */
60   BUTTON6MOUSE = 0x0012,
61   BUTTON7MOUSE = 0x0013,
62   /* Extra trackpad gestures */
63   MOUSEPAN = 0x000e,
64   MOUSEZOOM = 0x000f,
65   MOUSEROTATE = 0x0010,
66   /* defaults from ghost */
67   WHEELUPMOUSE = 0x000a,
68   WHEELDOWNMOUSE = 0x000b,
69   /* mapped with userdef */
70   WHEELINMOUSE = 0x000c,
71   WHEELOUTMOUSE = 0x000d,
72   /* Successive MOUSEMOVE's are converted to this, so we can easily
73    * ignore all but the most recent MOUSEMOVE (for better performance),
74    * paint and drawing tools however will want to handle these. */
75   INBETWEEN_MOUSEMOVE = 0x0011,
76
77   /* IME event, GHOST_kEventImeCompositionStart in ghost */
78   WM_IME_COMPOSITE_START = 0x0014,
79   /* IME event, GHOST_kEventImeComposition in ghost */
80   WM_IME_COMPOSITE_EVENT = 0x0015,
81   /* IME event, GHOST_kEventImeCompositionEnd in ghost */
82   WM_IME_COMPOSITE_END = 0x0016,
83
84   /* Tablet/Pen Specific Events */
85   TABLET_STYLUS = 0x001a,
86   TABLET_ERASER = 0x001b,
87
88   /* *** Start of keyboard codes. *** */
89
90   /* standard keyboard.
91    * XXX from 0x0020 to 0x00ff, and 0x012c to 0x013f for function keys! */
92
93   /* NOTE: these values are saved in keymap files, do not change them but just add new ones */
94   AKEY = 0x0061, /* 'a' */
95   BKEY = 0x0062, /* 'b' */
96   CKEY = 0x0063, /* 'c' */
97   DKEY = 0x0064, /* 'd' */
98   EKEY = 0x0065, /* 'e' */
99   FKEY = 0x0066, /* 'f' */
100   GKEY = 0x0067, /* 'g' */
101 #ifndef WIN32
102   HKEY = 0x0068, /* 'h' */
103 #else
104 #  define HKEY 0x0068
105 #endif
106   IKEY = 0x0069, /* 'i' */
107   JKEY = 0x006a, /* 'j' */
108   KKEY = 0x006b, /* 'k' */
109   LKEY = 0x006c, /* 'l' */
110   MKEY = 0x006d, /* 'm' */
111   NKEY = 0x006e, /* 'n' */
112   OKEY = 0x006f, /* 'o' */
113   PKEY = 0x0070, /* 'p' */
114   QKEY = 0x0071, /* 'q' */
115   RKEY = 0x0072, /* 'r' */
116   SKEY = 0x0073, /* 's' */
117   TKEY = 0x0074, /* 't' */
118   UKEY = 0x0075, /* 'u' */
119   VKEY = 0x0076, /* 'v' */
120   WKEY = 0x0077, /* 'w' */
121   XKEY = 0x0078, /* 'x' */
122   YKEY = 0x0079, /* 'y' */
123   ZKEY = 0x007a, /* 'z' */
124
125   ZEROKEY = 0x0030,  /* '0' */
126   ONEKEY = 0x0031,   /* '1' */
127   TWOKEY = 0x0032,   /* '2' */
128   THREEKEY = 0x0033, /* '3' */
129   FOURKEY = 0x0034,  /* '4' */
130   FIVEKEY = 0x0035,  /* '5' */
131   SIXKEY = 0x0036,   /* '6' */
132   SEVENKEY = 0x0037, /* '7' */
133   EIGHTKEY = 0x0038, /* '8' */
134   NINEKEY = 0x0039,  /* '9' */
135
136   CAPSLOCKKEY = 0x00d3, /* 211 */
137
138   LEFTCTRLKEY = 0x00d4,   /* 212 */
139   LEFTALTKEY = 0x00d5,    /* 213 */
140   RIGHTALTKEY = 0x00d6,   /* 214 */
141   RIGHTCTRLKEY = 0x00d7,  /* 215 */
142   RIGHTSHIFTKEY = 0x00d8, /* 216 */
143   LEFTSHIFTKEY = 0x00d9,  /* 217 */
144
145   ESCKEY = 0x00da,          /* 218 */
146   TABKEY = 0x00db,          /* 219 */
147   RETKEY = 0x00dc,          /* 220 */
148   SPACEKEY = 0x00dd,        /* 221 */
149   LINEFEEDKEY = 0x00de,     /* 222 */
150   BACKSPACEKEY = 0x00df,    /* 223 */
151   DELKEY = 0x00e0,          /* 224 */
152   SEMICOLONKEY = 0x00e1,    /* 225 */
153   PERIODKEY = 0x00e2,       /* 226 */
154   COMMAKEY = 0x00e3,        /* 227 */
155   QUOTEKEY = 0x00e4,        /* 228 */
156   ACCENTGRAVEKEY = 0x00e5,  /* 229 */
157   MINUSKEY = 0x00e6,        /* 230 */
158   PLUSKEY = 0x00e7,         /* 231 */
159   SLASHKEY = 0x00e8,        /* 232 */
160   BACKSLASHKEY = 0x00e9,    /* 233 */
161   EQUALKEY = 0x00ea,        /* 234 */
162   LEFTBRACKETKEY = 0x00eb,  /* 235 */
163   RIGHTBRACKETKEY = 0x00ec, /* 236 */
164
165   LEFTARROWKEY = 0x0089,  /* 137 */
166   DOWNARROWKEY = 0x008a,  /* 138 */
167   RIGHTARROWKEY = 0x008b, /* 139 */
168   UPARROWKEY = 0x008c,    /* 140 */
169
170   PAD0 = 0x0096, /* 150 */
171   PAD1 = 0x0097, /* 151 */
172   PAD2 = 0x0098, /* 152 */
173   PAD3 = 0x0099, /* 153 */
174   PAD4 = 0x009a, /* 154 */
175   PAD5 = 0x009b, /* 155 */
176   PAD6 = 0x009c, /* 156 */
177   PAD7 = 0x009d, /* 157 */
178   PAD8 = 0x009e, /* 158 */
179   PAD9 = 0x009f, /* 159 */
180
181   PADPERIOD = 0x00c7,   /* 199 */
182   PADASTERKEY = 0x00a0, /* 160 */
183   PADSLASHKEY = 0x00a1, /* 161 */
184   PADMINUS = 0x00a2,    /* 162 */
185   PADENTER = 0x00a3,    /* 163 */
186   PADPLUSKEY = 0x00a4,  /* 164 */
187
188   PAUSEKEY = 0x00a5,    /* 165 */
189   INSERTKEY = 0x00a6,   /* 166 */
190   HOMEKEY = 0x00a7,     /* 167 */
191   PAGEUPKEY = 0x00a8,   /* 168 */
192   PAGEDOWNKEY = 0x00a9, /* 169 */
193   ENDKEY = 0x00aa,      /* 170 */
194
195   UNKNOWNKEY = 0x00ab, /* 171 */
196   OSKEY = 0x00ac,      /* 172 */
197   GRLESSKEY = 0x00ad,  /* 173 */
198
199   /* XXX: are these codes ok? */
200   MEDIAPLAY = 0x00ae,  /* 174 */
201   MEDIASTOP = 0x00af,  /* 175 */
202   MEDIAFIRST = 0x00b0, /* 176 */
203   MEDIALAST = 0x00b1,  /* 177 */
204
205   APPKEY = 0x00b2, /* 178 */
206
207   F1KEY = 0x012c,  /* 300 */
208   F2KEY = 0x012d,  /* 301 */
209   F3KEY = 0x012e,  /* 302 */
210   F4KEY = 0x012f,  /* 303 */
211   F5KEY = 0x0130,  /* 304 */
212   F6KEY = 0x0131,  /* 305 */
213   F7KEY = 0x0132,  /* 306 */
214   F8KEY = 0x0133,  /* 307 */
215   F9KEY = 0x0134,  /* 308 */
216   F10KEY = 0x0135, /* 309 */
217   F11KEY = 0x0136, /* 310 */
218   F12KEY = 0x0137, /* 311 */
219   F13KEY = 0x0138, /* 312 */
220   F14KEY = 0x0139, /* 313 */
221   F15KEY = 0x013a, /* 314 */
222   F16KEY = 0x013b, /* 315 */
223   F17KEY = 0x013c, /* 316 */
224   F18KEY = 0x013d, /* 317 */
225   F19KEY = 0x013e, /* 318 */
226   F20KEY = 0x013f, /* 319 */
227   F21KEY = 0x0140, /* 320 */
228   F22KEY = 0x0141, /* 321 */
229   F23KEY = 0x0142, /* 322 */
230   F24KEY = 0x0143, /* 323 */
231
232   /* *** End of keyboard codes. *** */
233
234   /* NDOF (from SpaceNavigator & friends)
235    * These should be kept in sync with GHOST_NDOFManager.h
236    * Ordering matters, exact values do not. */
237   NDOF_MOTION = 0x0190,
238   /* used internally, never sent */
239   NDOF_BUTTON_NONE = NDOF_MOTION,
240   /* these two are available from any 3Dconnexion device */
241   NDOF_BUTTON_MENU,
242   NDOF_BUTTON_FIT,
243   /* standard views */
244   NDOF_BUTTON_TOP,
245   NDOF_BUTTON_BOTTOM,
246   NDOF_BUTTON_LEFT,
247   NDOF_BUTTON_RIGHT,
248   NDOF_BUTTON_FRONT,
249   NDOF_BUTTON_BACK,
250   /* more views */
251   NDOF_BUTTON_ISO1,
252   NDOF_BUTTON_ISO2,
253   /* 90 degree rotations */
254   NDOF_BUTTON_ROLL_CW,
255   NDOF_BUTTON_ROLL_CCW,
256   NDOF_BUTTON_SPIN_CW,
257   NDOF_BUTTON_SPIN_CCW,
258   NDOF_BUTTON_TILT_CW,
259   NDOF_BUTTON_TILT_CCW,
260   /* device control */
261   NDOF_BUTTON_ROTATE,
262   NDOF_BUTTON_PANZOOM,
263   NDOF_BUTTON_DOMINANT,
264   NDOF_BUTTON_PLUS,
265   NDOF_BUTTON_MINUS,
266   /* keyboard emulation */
267   NDOF_BUTTON_ESC,
268   NDOF_BUTTON_ALT,
269   NDOF_BUTTON_SHIFT,
270   NDOF_BUTTON_CTRL,
271   /* general-purpose buttons */
272   NDOF_BUTTON_1,
273   NDOF_BUTTON_2,
274   NDOF_BUTTON_3,
275   NDOF_BUTTON_4,
276   NDOF_BUTTON_5,
277   NDOF_BUTTON_6,
278   NDOF_BUTTON_7,
279   NDOF_BUTTON_8,
280   NDOF_BUTTON_9,
281   NDOF_BUTTON_10,
282   /* more general-purpose buttons */
283   NDOF_BUTTON_A,
284   NDOF_BUTTON_B,
285   NDOF_BUTTON_C,
286   /* the end */
287   NDOF_LAST,
288
289   /* ********** End of Input devices. ********** */
290
291   /* ********** Start of Blender internal events. ********** */
292
293   /* XXX Those are mixed inside keyboard 'area'! */
294   /* System: 0x010x */
295   INPUTCHANGE = 0x0103,   /* input connected or disconnected */
296   WINDEACTIVATE = 0x0104, /* window is deactivated, focus lost */
297   /* Timer: 0x011x */
298   TIMER = 0x0110,         /* timer event, passed on to all queues */
299   TIMER0 = 0x0111,        /* timer event, slot for internal use */
300   TIMER1 = 0x0112,        /* timer event, slot for internal use */
301   TIMER2 = 0x0113,        /* timer event, slot for internal use */
302   TIMERJOBS = 0x0114,     /* timer event, jobs system */
303   TIMERAUTOSAVE = 0x0115, /* timer event, autosave */
304   TIMERREPORT = 0x0116,   /* timer event, reports */
305   TIMERREGION = 0x0117,   /* timer event, region slide in/out */
306   TIMERNOTIFIER = 0x0118, /* timer event, notifier sender */
307   TIMERF = 0x011F,        /* last timer */
308
309   /* Actionzones, tweak, gestures: 0x500x, 0x501x */
310   /* Keep in sync with IS_EVENT_ACTIONZONE(...). */
311   EVT_ACTIONZONE_AREA = 0x5000,
312   EVT_ACTIONZONE_REGION = 0x5001,
313   EVT_ACTIONZONE_FULLSCREEN = 0x5011,
314
315   /* NOTE: these values are saved in keymap files, do not change them but just add new ones */
316
317   /* Tweak events:
318    * Sent as additional event with the mouse coordinates
319    * from where the initial click was placed. */
320
321   /* tweak events for L M R mousebuttons */
322   EVT_TWEAK_L = 0x5002,
323   EVT_TWEAK_M = 0x5003,
324   EVT_TWEAK_R = 0x5004,
325   /* 0x5010 (and lower) should be left to add other tweak types in the future. */
326
327   /* 0x5011 is taken, see EVT_ACTIONZONE_FULLSCREEN */
328
329   /* Misc Blender internals: 0x502x */
330   EVT_FILESELECT = 0x5020,
331   EVT_BUT_OPEN = 0x5021,
332   EVT_MODAL_MAP = 0x5022,
333   EVT_DROP = 0x5023,
334   EVT_BUT_CANCEL = 0x5024,
335
336   /* could become gizmo callback */
337   EVT_GIZMO_UPDATE = 0x5025,
338   /* ********** End of Blender internal events. ********** */
339 };
340
341 /* *********** wmEvent.type helpers. ********** */
342
343 /* test whether the event is timer event */
344 #define ISTIMER(event_type) ((event_type) >= TIMER && (event_type) <= TIMERF)
345
346 /* for event checks */
347 /* only used for KM_TEXTINPUT, so assume that we want all user-inputtable ascii codes included */
348 /* UNUSED - see wm_eventmatch - BUG [#30479] */
349 /* #define ISTEXTINPUT(event_type)  ((event_type) >= ' ' && (event_type) <= 255) */
350 /* note, an alternative could be to check 'event->utf8_buf' */
351
352 /* test whether the event is a key on the keyboard */
353 #define ISKEYBOARD(event_type) \
354   (((event_type) >= 0x0020 && (event_type) <= 0x00ff) || \
355    ((event_type) >= 0x012c && (event_type) <= 0x0143))
356
357 /* test whether the event is a modifier key */
358 #define ISKEYMODIFIER(event_type) \
359   (((event_type) >= LEFTCTRLKEY && (event_type) <= LEFTSHIFTKEY) || (event_type) == OSKEY)
360
361 /* test whether the event is a mouse button */
362 #define ISMOUSE(event_type) ((event_type) >= LEFTMOUSE && (event_type) <= BUTTON7MOUSE)
363
364 #define ISMOUSE_WHEEL(event_type) ((event_type) >= WHEELUPMOUSE && (event_type) <= WHEELOUTMOUSE)
365 #define ISMOUSE_GESTURE(event_type) ((event_type) >= MOUSEPAN && (event_type) <= MOUSEROTATE)
366 #define ISMOUSE_BUTTON(event_type) \
367   (ELEM(event_type, \
368         LEFTMOUSE, \
369         MIDDLEMOUSE, \
370         RIGHTMOUSE, \
371         BUTTON4MOUSE, \
372         BUTTON5MOUSE, \
373         BUTTON6MOUSE, \
374         BUTTON7MOUSE))
375
376 /* test whether the event is tweak event */
377 #define ISTWEAK(event_type) ((event_type) >= EVT_TWEAK_L && (event_type) <= EVT_TWEAK_R)
378
379 /* test whether the event is a NDOF event */
380 #define ISNDOF(event_type) ((event_type) >= NDOF_MOTION && (event_type) < NDOF_LAST)
381
382 #define IS_EVENT_ACTIONZONE(event_type) \
383   ELEM(event_type, EVT_ACTIONZONE_AREA, EVT_ACTIONZONE_REGION, EVT_ACTIONZONE_FULLSCREEN)
384
385 /* test whether event type is acceptable as hotkey, excluding modifiers */
386 #define ISHOTKEY(event_type) \
387   ((ISKEYBOARD(event_type) || ISMOUSE(event_type) || ISNDOF(event_type)) && \
388    (ISKEYMODIFIER(event_type) == false))
389
390 /* internal helpers*/
391 #define _VA_IS_EVENT_MOD2(v, a) (CHECK_TYPE_INLINE(v, wmEvent *), ((v)->a))
392 #define _VA_IS_EVENT_MOD3(v, a, b) (_VA_IS_EVENT_MOD2(v, a) || ((v)->b))
393 #define _VA_IS_EVENT_MOD4(v, a, b, c) (_VA_IS_EVENT_MOD3(v, a, b) || ((v)->c))
394 #define _VA_IS_EVENT_MOD5(v, a, b, c, d) (_VA_IS_EVENT_MOD4(v, a, b, c) || ((v)->d))
395
396 /* reusable IS_EVENT_MOD(event, shift, ctrl, alt, oskey), macro */
397 #define IS_EVENT_MOD(...) VA_NARGS_CALL_OVERLOAD(_VA_IS_EVENT_MOD, __VA_ARGS__)
398
399 enum eEventType_Mask {
400   /* ISKEYMODIFIER */
401   EVT_TYPE_MASK_KEYBOARD_MODIFIER = (1 << 0),
402   /* ISKEYBOARD */
403   EVT_TYPE_MASK_KEYBOARD = (1 << 1),
404   /* ISMOUSE_WHEEL */
405   EVT_TYPE_MASK_MOUSE_WHEEL = (1 << 2),
406   /* ISMOUSE_BUTTON */
407   EVT_TYPE_MASK_MOUSE_GESTURE = (1 << 3),
408   /* ISMOUSE_GESTURE */
409   EVT_TYPE_MASK_MOUSE_BUTTON = (1 << 4),
410   /* ISMOUSE */
411   EVT_TYPE_MASK_MOUSE = (1 << 5),
412   /* ISNDOF */
413   EVT_TYPE_MASK_NDOF = (1 << 6),
414   /* ISTWEAK */
415   EVT_TYPE_MASK_TWEAK = (1 << 7),
416   /* IS_EVENT_ACTIONZONE */
417   EVT_TYPE_MASK_ACTIONZONE = (1 << 8),
418 };
419 #define EVT_TYPE_MASK_ALL \
420   (EVT_TYPE_MASK_KEYBOARD | EVT_TYPE_MASK_MOUSE | EVT_TYPE_MASK_NDOF | EVT_TYPE_MASK_TWEAK | \
421    EVT_TYPE_MASK_ACTIONZONE)
422
423 #define EVT_TYPE_MASK_HOTKEY_INCLUDE \
424   (EVT_TYPE_MASK_KEYBOARD | EVT_TYPE_MASK_MOUSE | EVT_TYPE_MASK_NDOF)
425 #define EVT_TYPE_MASK_HOTKEY_EXCLUDE EVT_TYPE_MASK_KEYBOARD_MODIFIER
426
427 bool WM_event_type_mask_test(const int event_type, const enum eEventType_Mask mask);
428
429 /* ********** wmEvent.val ********** */
430
431 /* Gestures */
432 /* NOTE: these values are saved in keymap files, do not change them but just add new ones */
433 enum {
434   /* value of tweaks and line gestures, note, KM_ANY (-1) works for this case too */
435   EVT_GESTURE_N = 1,
436   EVT_GESTURE_NE = 2,
437   EVT_GESTURE_E = 3,
438   EVT_GESTURE_SE = 4,
439   EVT_GESTURE_S = 5,
440   EVT_GESTURE_SW = 6,
441   EVT_GESTURE_W = 7,
442   EVT_GESTURE_NW = 8,
443   /* value of corner gestures */
444   EVT_GESTURE_N_E = 9,
445   EVT_GESTURE_N_W = 10,
446   EVT_GESTURE_E_N = 11,
447   EVT_GESTURE_E_S = 12,
448   EVT_GESTURE_S_E = 13,
449   EVT_GESTURE_S_W = 14,
450   EVT_GESTURE_W_S = 15,
451   EVT_GESTURE_W_N = 16,
452 };
453
454 /* File select */
455 enum {
456   EVT_FILESELECT_FULL_OPEN = 1,
457   EVT_FILESELECT_EXEC = 2,
458   EVT_FILESELECT_CANCEL = 3,
459   EVT_FILESELECT_EXTERNAL_CANCEL = 4,
460 };
461
462 /**
463  * Gesture
464  * Used in #wmEvent.val
465  *
466  * \note These values are saved in keymap files,
467  * do not change them but just add new ones.
468  */
469 enum {
470   GESTURE_MODAL_CANCEL = 1,
471   GESTURE_MODAL_CONFIRM = 2,
472
473   /** Uses 'deselect' operator property. */
474   GESTURE_MODAL_SELECT = 3,
475   GESTURE_MODAL_DESELECT = 4,
476
477   /** Circle select: when no mouse button is pressed */
478   GESTURE_MODAL_NOP = 5,
479
480   /** Circle select: larger brush. */
481   GESTURE_MODAL_CIRCLE_ADD = 6,
482   /** Circle select: smaller brush. */
483   GESTURE_MODAL_CIRCLE_SUB = 7,
484
485   /** Box select/straight line, activate, use release to detect which button. */
486   GESTURE_MODAL_BEGIN = 8,
487
488   /** Uses 'zoom_out' operator property. */
489   GESTURE_MODAL_IN = 9,
490   GESTURE_MODAL_OUT = 10,
491
492   /** circle select: size brush (for trackpad event). */
493   GESTURE_MODAL_CIRCLE_SIZE = 11,
494 };
495
496 #endif /* __WM_EVENT_TYPES_H__ */