keys.h

   1 /*
   2         $RCSfile$
   3
   4         Copyright (C) 1996-1997  Id Software, Inc.
   5
   6         This program is free software; you can redistribute it and/or
   7         modify it under the terms of the GNU General Public License
   8         as published by the Free Software Foundation; either version 2
   9         of the License, or (at your option) any later version.
  10
  11         This program is distributed in the hope that it will be useful,
  12         but WITHOUT ANY WARRANTY; without even the implied warranty of
  13         MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  14
  15         See the GNU General Public License for more details.
  16
  17         You should have received a copy of the GNU General Public License
  18         along with this program; if not, write to:
  19
  20                 Free Software Foundation, Inc.
  21                 59 Temple Place - Suite 330
  22                 Boston, MA  02111-1307, USA
  23
  24         $Id$
  25 */
  26
  27 #ifndef __KEYS_H
  28 #define __KEYS_H
  29
  30 #include <stddef.h>
  31 #include "qtypes.h"
  32 #include "qdefs.h"
  33 #include "fs.h"
  34 #include "cmd.h"
  35
  36 //
  37 // these are the key numbers that should be passed to Key_Event
  38 //
  39 typedef enum keynum_e
  40 {
  41         K_TEXT                  = 1, // used only for unicode character input
  42         K_TAB                   = 9,
  43         K_ENTER                 = 13,
  44         K_ESCAPE                = 27,
  45         K_SPACE                 = 32,
  46
  47         // normal keys should be passed as lowercased ascii
  48
  49         K_BACKSPACE             = 127,
  50         K_UPARROW,
  51         K_DOWNARROW,
  52         K_LEFTARROW,
  53         K_RIGHTARROW,
  54
  55         K_ALT,
  56         K_CTRL,
  57         K_SHIFT,
  58
  59         K_F1,
  60         K_F2,
  61         K_F3,
  62         K_F4,
  63         K_F5,
  64         K_F6,
  65         K_F7,
  66         K_F8,
  67         K_F9,
  68         K_F10,
  69         K_F11,
  70         K_F12,
  71
  72         K_INS,
  73         K_DEL,
  74         K_PGDN,
  75         K_PGUP,
  76         K_HOME,
  77         K_END,
  78
  79         K_PAUSE,
  80
  81         K_NUMLOCK,
  82         K_CAPSLOCK,
  83         K_SCROLLOCK,
  84
  85         K_KP_0,
  86         K_KP_INS = K_KP_0,
  87         K_KP_1,
  88         K_KP_END = K_KP_1,
  89         K_KP_2,
  90         K_KP_DOWNARROW = K_KP_2,
  91         K_KP_3,
  92         K_KP_PGDN = K_KP_3,
  93         K_KP_4,
  94         K_KP_LEFTARROW = K_KP_4,
  95         K_KP_5,
  96         K_KP_6,
  97         K_KP_RIGHTARROW = K_KP_6,
  98         K_KP_7,
  99         K_KP_HOME = K_KP_7,
 100         K_KP_8,
 101         K_KP_UPARROW = K_KP_8,
 102         K_KP_9,
 103         K_KP_PGUP = K_KP_9,
 104         K_KP_PERIOD,
 105         K_KP_DEL = K_KP_PERIOD,
 106         K_KP_DIVIDE,
 107         K_KP_SLASH = K_KP_DIVIDE,
 108         K_KP_MULTIPLY,
 109         K_KP_MINUS,
 110         K_KP_PLUS,
 111         K_KP_ENTER,
 112         K_KP_EQUALS,
 113
 114         K_PRINTSCREEN,
 115
 116         // mouse buttons generate virtual keys
 117
 118         K_MOUSE1 = 512,
 119         K_OTHERDEVICESBEGIN = K_MOUSE1,
 120         K_MOUSE2,
 121         K_MOUSE3,
 122         K_MWHEELUP,
 123         K_MWHEELDOWN,
 124         K_MOUSE4,
 125         K_MOUSE5,
 126         K_MOUSE6,
 127         K_MOUSE7,
 128         K_MOUSE8,
 129         K_MOUSE9,
 130         K_MOUSE10,
 131         K_MOUSE11,
 132         K_MOUSE12,
 133         K_MOUSE13,
 134         K_MOUSE14,
 135         K_MOUSE15,
 136         K_MOUSE16,
 137
 138 //
 139 // joystick buttons
 140 //
 141         K_JOY1 = 768,
 142         K_JOY2,
 143         K_JOY3,
 144         K_JOY4,
 145         K_JOY5,
 146         K_JOY6,
 147         K_JOY7,
 148         K_JOY8,
 149         K_JOY9,
 150         K_JOY10,
 151         K_JOY11,
 152         K_JOY12,
 153         K_JOY13,
 154         K_JOY14,
 155         K_JOY15,
 156         K_JOY16,
 157
 158 //
 159 // aux keys are for multi-buttoned joysticks to generate so they can use
 160 // the normal binding process
 161 //
 162         K_AUX1,
 163         K_AUX2,
 164         K_AUX3,
 165         K_AUX4,
 166         K_AUX5,
 167         K_AUX6,
 168         K_AUX7,
 169         K_AUX8,
 170         K_AUX9,
 171         K_AUX10,
 172         K_AUX11,
 173         K_AUX12,
 174         K_AUX13,
 175         K_AUX14,
 176         K_AUX15,
 177         K_AUX16,
 178         K_AUX17,
 179         K_AUX18,
 180         K_AUX19,
 181         K_AUX20,
 182         K_AUX21,
 183         K_AUX22,
 184         K_AUX23,
 185         K_AUX24,
 186         K_AUX25,
 187         K_AUX26,
 188         K_AUX27,
 189         K_AUX28,
 190         K_AUX29,
 191         K_AUX30,
 192         K_AUX31,
 193         K_AUX32,
 194
 195         // Microsoft Xbox 360 Controller For Windows
 196         K_X360_DPAD_UP,
 197         K_X360_DPAD_DOWN,
 198         K_X360_DPAD_LEFT,
 199         K_X360_DPAD_RIGHT,
 200         K_X360_START,
 201         K_X360_BACK,
 202         K_X360_LEFT_THUMB,
 203         K_X360_RIGHT_THUMB,
 204         K_X360_LEFT_SHOULDER,
 205         K_X360_RIGHT_SHOULDER,
 206         K_X360_A,
 207         K_X360_B,
 208         K_X360_X,
 209         K_X360_Y,
 210         K_X360_LEFT_TRIGGER,
 211         K_X360_RIGHT_TRIGGER,
 212         K_X360_LEFT_THUMB_UP,
 213         K_X360_LEFT_THUMB_DOWN,
 214         K_X360_LEFT_THUMB_LEFT,
 215         K_X360_LEFT_THUMB_RIGHT,
 216         K_X360_RIGHT_THUMB_UP,
 217         K_X360_RIGHT_THUMB_DOWN,
 218         K_X360_RIGHT_THUMB_LEFT,
 219         K_X360_RIGHT_THUMB_RIGHT,
 220
 221         // generic joystick emulation for menu
 222         K_JOY_UP,
 223         K_JOY_DOWN,
 224         K_JOY_LEFT,
 225         K_JOY_RIGHT,
 226
 227         K_MIDINOTE0 = 896, // to this, the note number is added
 228         K_MIDINOTE1,
 229         K_MIDINOTE2,
 230         K_MIDINOTE3,
 231         K_MIDINOTE4,
 232         K_MIDINOTE5,
 233         K_MIDINOTE6,
 234         K_MIDINOTE7,
 235         K_MIDINOTE8,
 236         K_MIDINOTE9,
 237         K_MIDINOTE10,
 238         K_MIDINOTE11,
 239         K_MIDINOTE12,
 240         K_MIDINOTE13,
 241         K_MIDINOTE14,
 242         K_MIDINOTE15,
 243         K_MIDINOTE16,
 244         K_MIDINOTE17,
 245         K_MIDINOTE18,
 246         K_MIDINOTE19,
 247         K_MIDINOTE20,
 248         K_MIDINOTE21,
 249         K_MIDINOTE22,
 250         K_MIDINOTE23,
 251         K_MIDINOTE24,
 252         K_MIDINOTE25,
 253         K_MIDINOTE26,
 254         K_MIDINOTE27,
 255         K_MIDINOTE28,
 256         K_MIDINOTE29,
 257         K_MIDINOTE30,
 258         K_MIDINOTE31,
 259         K_MIDINOTE32,
 260         K_MIDINOTE33,
 261         K_MIDINOTE34,
 262         K_MIDINOTE35,
 263         K_MIDINOTE36,
 264         K_MIDINOTE37,
 265         K_MIDINOTE38,
 266         K_MIDINOTE39,
 267         K_MIDINOTE40,
 268         K_MIDINOTE41,
 269         K_MIDINOTE42,
 270         K_MIDINOTE43,
 271         K_MIDINOTE44,
 272         K_MIDINOTE45,
 273         K_MIDINOTE46,
 274         K_MIDINOTE47,
 275         K_MIDINOTE48,
 276         K_MIDINOTE49,
 277         K_MIDINOTE50,
 278         K_MIDINOTE51,
 279         K_MIDINOTE52,
 280         K_MIDINOTE53,
 281         K_MIDINOTE54,
 282         K_MIDINOTE55,
 283         K_MIDINOTE56,
 284         K_MIDINOTE57,
 285         K_MIDINOTE58,
 286         K_MIDINOTE59,
 287         K_MIDINOTE60,
 288         K_MIDINOTE61,
 289         K_MIDINOTE62,
 290         K_MIDINOTE63,
 291         K_MIDINOTE64,
 292         K_MIDINOTE65,
 293         K_MIDINOTE66,
 294         K_MIDINOTE67,
 295         K_MIDINOTE68,
 296         K_MIDINOTE69,
 297         K_MIDINOTE70,
 298         K_MIDINOTE71,
 299         K_MIDINOTE72,
 300         K_MIDINOTE73,
 301         K_MIDINOTE74,
 302         K_MIDINOTE75,
 303         K_MIDINOTE76,
 304         K_MIDINOTE77,
 305         K_MIDINOTE78,
 306         K_MIDINOTE79,
 307         K_MIDINOTE80,
 308         K_MIDINOTE81,
 309         K_MIDINOTE82,
 310         K_MIDINOTE83,
 311         K_MIDINOTE84,
 312         K_MIDINOTE85,
 313         K_MIDINOTE86,
 314         K_MIDINOTE87,
 315         K_MIDINOTE88,
 316         K_MIDINOTE89,
 317         K_MIDINOTE90,
 318         K_MIDINOTE91,
 319         K_MIDINOTE92,
 320         K_MIDINOTE93,
 321         K_MIDINOTE94,
 322         K_MIDINOTE95,
 323         K_MIDINOTE96,
 324         K_MIDINOTE97,
 325         K_MIDINOTE98,
 326         K_MIDINOTE99,
 327         K_MIDINOTE100,
 328         K_MIDINOTE101,
 329         K_MIDINOTE102,
 330         K_MIDINOTE103,
 331         K_MIDINOTE104,
 332         K_MIDINOTE105,
 333         K_MIDINOTE106,
 334         K_MIDINOTE107,
 335         K_MIDINOTE108,
 336         K_MIDINOTE109,
 337         K_MIDINOTE110,
 338         K_MIDINOTE111,
 339         K_MIDINOTE112,
 340         K_MIDINOTE113,
 341         K_MIDINOTE114,
 342         K_MIDINOTE115,
 343         K_MIDINOTE116,
 344         K_MIDINOTE117,
 345         K_MIDINOTE118,
 346         K_MIDINOTE119,
 347         K_MIDINOTE120,
 348         K_MIDINOTE121,
 349         K_MIDINOTE122,
 350         K_MIDINOTE123,
 351         K_MIDINOTE124,
 352         K_MIDINOTE125,
 353         K_MIDINOTE126,
 354         K_MIDINOTE127,
 355
 356         MAX_KEYS
 357 }
 358 keynum_t;
 359
 360 typedef enum keydest_e { key_game, key_message, key_menu, key_menu_grabbed, key_console, key_void } keydest_t;
 361
 362 extern  char            key_line[MAX_INPUTLINE];
 363 extern  int                     key_linepos;
 364 extern  qbool   key_insert;     // insert key toggle (for editing)
 365 extern  keydest_t       key_dest;
 366 // key_consoleactive bits
 367 // user wants console (halfscreen)
 368 #define KEY_CONSOLEACTIVE_USER 1
 369 // console forced because there's nothing else active (fullscreen)
 370 #define KEY_CONSOLEACTIVE_FORCED 4
 371 extern  int                     key_consoleactive;
 372 extern  char            *keybindings[MAX_BINDMAPS][MAX_KEYS];
 373
 374 extern int chat_mode; // 0 for say, 1 for say_team, -1 for command
 375 extern char chat_buffer[MAX_INPUTLINE];
 376 extern int      chat_bufferpos;
 377
 378 int Key_ClearEditLine(qbool is_console);
 379 void Key_WriteBindings(qfile_t *f);
 380 void Key_Init(void);
 381 void Key_Shutdown(void);
 382 void Key_Init_Cvars(void);
 383 void Key_Event(int key, int ascii, qbool down);
 384 void Key_ReleaseAll (void);
 385 void Key_ReleaseAll_f(cmd_state_t *cmd);
 386 void Key_EventQueue_Block(void);
 387 void Key_EventQueue_Unblock(void);
 388 int Key_AddChar(int unicode, qbool is_console);
 389 int Key_Parse_CommonKeys(cmd_state_t *cmd, qbool is_console, int key, int unicode);
 390
 391 qbool Key_SetBinding (int keynum, int bindmap, const char *binding);
 392 const char *Key_GetBind (int key, int bindmap);
 393 void Key_FindKeysForCommand (const char *command, int *keys, int numkeys, int bindmap);
 394 qbool Key_SetBindMap(int fg, int bg);
 395 void Key_GetBindMap(int *fg, int *bg);
 396 const char *Key_KeynumToString (int keynum, char *buf, size_t buflength);
 397 int Key_StringToKeynum (const char *str);
 398
 399 #endif // __KEYS_H
 400