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