src/keycode.cpp

   1 /*
   2 Minetest
   3 Copyright (C) 2010-2013 celeron55, Perttu Ahola <celeron55@gmail.com>
   4
   5 This program is free software; you can redistribute it and/or modify
   6 it under the terms of the GNU Lesser General Public License as published by
   7 the Free Software Foundation; either version 2.1 of the License, or
   8 (at your option) any later version.
   9
  10 This program is distributed in the hope that it will be useful,
  11 but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 GNU Lesser General Public License for more details.
  14
  15 You should have received a copy of the GNU Lesser General Public License along
  16 with this program; if not, write to the Free Software Foundation, Inc.,
  17 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  18 */
  19
  20 #include "keycode.h"
  21 #include "main.h" // For g_settings
  22 #include "exceptions.h"
  23 #include "settings.h"
  24 #include "log.h"
  25 #include "debug.h"
  26 #include "util/hex.h"
  27
  28 class UnknownKeycode : public BaseException
  29 {
  30 public:
  31         UnknownKeycode(const char *s) :
  32                 BaseException(s) {};
  33 };
  34
  35 #define CHECKKEY(x){if(strcmp(name, #x)==0) return irr::x;}
  36
  37 irr::EKEY_CODE keyname_to_keycode(const char *name)
  38 {
  39         CHECKKEY(KEY_LBUTTON)
  40         CHECKKEY(KEY_RBUTTON)
  41         CHECKKEY(KEY_CANCEL)
  42         CHECKKEY(KEY_MBUTTON)
  43         CHECKKEY(KEY_XBUTTON1)
  44         CHECKKEY(KEY_XBUTTON2)
  45         CHECKKEY(KEY_BACK)
  46         CHECKKEY(KEY_TAB)
  47         CHECKKEY(KEY_CLEAR)
  48         CHECKKEY(KEY_RETURN)
  49         CHECKKEY(KEY_SHIFT)
  50         CHECKKEY(KEY_CONTROL)
  51         CHECKKEY(KEY_MENU)
  52         CHECKKEY(KEY_PAUSE)
  53         CHECKKEY(KEY_CAPITAL)
  54         CHECKKEY(KEY_KANA)
  55         CHECKKEY(KEY_HANGUEL)
  56         CHECKKEY(KEY_HANGUL)
  57         CHECKKEY(KEY_JUNJA)
  58         CHECKKEY(KEY_FINAL)
  59         CHECKKEY(KEY_HANJA)
  60         CHECKKEY(KEY_KANJI)
  61         CHECKKEY(KEY_ESCAPE)
  62         CHECKKEY(KEY_CONVERT)
  63         CHECKKEY(KEY_NONCONVERT)
  64         CHECKKEY(KEY_ACCEPT)
  65         CHECKKEY(KEY_MODECHANGE)
  66         CHECKKEY(KEY_SPACE)
  67         CHECKKEY(KEY_PRIOR)
  68         CHECKKEY(KEY_NEXT)
  69         CHECKKEY(KEY_END)
  70         CHECKKEY(KEY_HOME)
  71         CHECKKEY(KEY_LEFT)
  72         CHECKKEY(KEY_UP)
  73         CHECKKEY(KEY_RIGHT)
  74         CHECKKEY(KEY_DOWN)
  75         CHECKKEY(KEY_SELECT)
  76         CHECKKEY(KEY_PRINT)
  77         CHECKKEY(KEY_EXECUT)
  78         CHECKKEY(KEY_SNAPSHOT)
  79         CHECKKEY(KEY_INSERT)
  80         CHECKKEY(KEY_DELETE)
  81         CHECKKEY(KEY_HELP)
  82         CHECKKEY(KEY_KEY_0)
  83         CHECKKEY(KEY_KEY_1)
  84         CHECKKEY(KEY_KEY_2)
  85         CHECKKEY(KEY_KEY_3)
  86         CHECKKEY(KEY_KEY_4)
  87         CHECKKEY(KEY_KEY_5)
  88         CHECKKEY(KEY_KEY_6)
  89         CHECKKEY(KEY_KEY_7)
  90         CHECKKEY(KEY_KEY_8)
  91         CHECKKEY(KEY_KEY_9)
  92         CHECKKEY(KEY_KEY_A)
  93         CHECKKEY(KEY_KEY_B)
  94         CHECKKEY(KEY_KEY_C)
  95         CHECKKEY(KEY_KEY_D)
  96         CHECKKEY(KEY_KEY_E)
  97         CHECKKEY(KEY_KEY_F)
  98         CHECKKEY(KEY_KEY_G)
  99         CHECKKEY(KEY_KEY_H)
 100         CHECKKEY(KEY_KEY_I)
 101         CHECKKEY(KEY_KEY_J)
 102         CHECKKEY(KEY_KEY_K)
 103         CHECKKEY(KEY_KEY_L)
 104         CHECKKEY(KEY_KEY_M)
 105         CHECKKEY(KEY_KEY_N)
 106         CHECKKEY(KEY_KEY_O)
 107         CHECKKEY(KEY_KEY_P)
 108         CHECKKEY(KEY_KEY_Q)
 109         CHECKKEY(KEY_KEY_R)
 110         CHECKKEY(KEY_KEY_S)
 111         CHECKKEY(KEY_KEY_T)
 112         CHECKKEY(KEY_KEY_U)
 113         CHECKKEY(KEY_KEY_V)
 114         CHECKKEY(KEY_KEY_W)
 115         CHECKKEY(KEY_KEY_X)
 116         CHECKKEY(KEY_KEY_Y)
 117         CHECKKEY(KEY_KEY_Z)
 118         CHECKKEY(KEY_LWIN)
 119         CHECKKEY(KEY_RWIN)
 120         CHECKKEY(KEY_APPS)
 121         CHECKKEY(KEY_SLEEP)
 122         CHECKKEY(KEY_NUMPAD0)
 123         CHECKKEY(KEY_NUMPAD1)
 124         CHECKKEY(KEY_NUMPAD2)
 125         CHECKKEY(KEY_NUMPAD3)
 126         CHECKKEY(KEY_NUMPAD4)
 127         CHECKKEY(KEY_NUMPAD5)
 128         CHECKKEY(KEY_NUMPAD6)
 129         CHECKKEY(KEY_NUMPAD7)
 130         CHECKKEY(KEY_NUMPAD8)
 131         CHECKKEY(KEY_NUMPAD9)
 132         CHECKKEY(KEY_MULTIPLY)
 133         CHECKKEY(KEY_ADD)
 134         CHECKKEY(KEY_SEPARATOR)
 135         CHECKKEY(KEY_SUBTRACT)
 136         CHECKKEY(KEY_DECIMAL)
 137         CHECKKEY(KEY_DIVIDE)
 138         CHECKKEY(KEY_F1)
 139         CHECKKEY(KEY_F2)
 140         CHECKKEY(KEY_F3)
 141         CHECKKEY(KEY_F4)
 142         CHECKKEY(KEY_F5)
 143         CHECKKEY(KEY_F6)
 144         CHECKKEY(KEY_F7)
 145         CHECKKEY(KEY_F8)
 146         CHECKKEY(KEY_F9)
 147         CHECKKEY(KEY_F10)
 148         CHECKKEY(KEY_F11)
 149         CHECKKEY(KEY_F12)
 150         CHECKKEY(KEY_F13)
 151         CHECKKEY(KEY_F14)
 152         CHECKKEY(KEY_F15)
 153         CHECKKEY(KEY_F16)
 154         CHECKKEY(KEY_F17)
 155         CHECKKEY(KEY_F18)
 156         CHECKKEY(KEY_F19)
 157         CHECKKEY(KEY_F20)
 158         CHECKKEY(KEY_F21)
 159         CHECKKEY(KEY_F22)
 160         CHECKKEY(KEY_F23)
 161         CHECKKEY(KEY_F24)
 162         CHECKKEY(KEY_NUMLOCK)
 163         CHECKKEY(KEY_SCROLL)
 164         CHECKKEY(KEY_LSHIFT)
 165         CHECKKEY(KEY_RSHIFT)
 166         CHECKKEY(KEY_LCONTROL)
 167         CHECKKEY(KEY_RCONTROL)
 168         CHECKKEY(KEY_LMENU)
 169         CHECKKEY(KEY_RMENU)
 170         CHECKKEY(KEY_PLUS)
 171         CHECKKEY(KEY_COMMA)
 172         CHECKKEY(KEY_MINUS)
 173         CHECKKEY(KEY_PERIOD)
 174         CHECKKEY(KEY_ATTN)
 175         CHECKKEY(KEY_CRSEL)
 176         CHECKKEY(KEY_EXSEL)
 177         CHECKKEY(KEY_EREOF)
 178         CHECKKEY(KEY_PLAY)
 179         CHECKKEY(KEY_ZOOM)
 180         CHECKKEY(KEY_PA1)
 181         CHECKKEY(KEY_OEM_CLEAR)
 182
 183         throw UnknownKeycode(name);
 184 }
 185
 186 static const char *KeyNames[] =
 187 { "-", "KEY_LBUTTON", "KEY_RBUTTON", "KEY_CANCEL", "KEY_MBUTTON", "KEY_XBUTTON1",
 188                 "KEY_XBUTTON2", "-", "KEY_BACK", "KEY_TAB", "-", "-", "KEY_CLEAR", "KEY_RETURN", "-",
 189                 "-", "KEY_SHIFT", "KEY_CONTROL", "KEY_MENU", "KEY_PAUSE", "KEY_CAPITAL", "KEY_KANA", "-",
 190                 "KEY_JUNJA", "KEY_FINAL", "KEY_KANJI", "-", "KEY_ESCAPE", "KEY_CONVERT", "KEY_NONCONVERT",
 191                 "KEY_ACCEPT", "KEY_MODECHANGE", "KEY_SPACE", "KEY_PRIOR", "KEY_NEXT", "KEY_END",
 192                 "KEY_HOME", "KEY_LEFT", "KEY_UP", "KEY_RIGHT", "KEY_DOWN", "KEY_SELECT", "KEY_PRINT",
 193                 "KEY_EXECUTE", "KEY_SNAPSHOT", "KEY_INSERT", "KEY_DELETE", "KEY_HELP", "KEY_KEY_0",
 194                 "KEY_KEY_1", "KEY_KEY_2", "KEY_KEY_3", "KEY_KEY_4", "KEY_KEY_5",
 195                 "KEY_KEY_6", "KEY_KEY_7", "KEY_KEY_8", "KEY_KEY_9", "-", "-", "-", "-",
 196                 "-", "-", "-", "KEY_KEY_A", "KEY_KEY_B", "KEY_KEY_C", "KEY_KEY_D",
 197                 "KEY_KEY_E", "KEY_KEY_F", "KEY_KEY_G", "KEY_KEY_H", "KEY_KEY_I",
 198                 "KEY_KEY_J", "KEY_KEY_K", "KEY_KEY_L", "KEY_KEY_M", "KEY_KEY_N",
 199                 "KEY_KEY_O", "KEY_KEY_P", "KEY_KEY_Q", "KEY_KEY_R", "KEY_KEY_S",
 200                 "KEY_KEY_T", "KEY_KEY_U", "KEY_KEY_V", "KEY_KEY_W", "KEY_KEY_X",
 201                 "KEY_KEY_Y", "KEY_KEY_Z", "KEY_LWIN", "KEY_RWIN", "KEY_APPS", "-",
 202                 "KEY_SLEEP", "KEY_NUMPAD0", "KEY_NUMPAD1", "KEY_NUMPAD2", "KEY_NUMPAD3",
 203                 "KEY_NUMPAD4", "KEY_NUMPAD5", "KEY_NUMPAD6", "KEY_NUMPAD7",
 204                 "KEY_NUMPAD8", "KEY_NUMPAD9", "KEY_MULTIPLY", "KEY_ADD", "KEY_SEPERATOR",
 205                 "KEY_SUBTRACT", "KEY_DECIMAL", "KEY_DIVIDE", "KEY_F1", "KEY_F2", "KEY_F3",
 206                 "KEY_F4", "KEY_F5", "KEY_F6", "KEY_F7", "KEY_F8", "KEY_F9", "KEY_F10",
 207                 "KEY_F11", "KEY_F12", "KEY_F13", "KEY_F14", "KEY_F15", "KEY_F16",
 208                 "KEY_F17", "KEY_F18", "KEY_F19", "KEY_F20", "KEY_F21", "KEY_F22",
 209                 "KEY_F23", "KEY_F24", "-", "-", "-", "-", "-", "-", "-", "-",
 210                 "KEY_NUMLOCK", "KEY_SCROLL", "-", "-", "-", "-", "-", "-", "-", "-", "-",
 211                 "-", "-", "-", "-", "-", "KEY_LSHIFT", "KEY_RSHIFT", "KEY_LCONTROL",
 212                 "KEY_RCONTROL", "KEY_LMENU", "KEY_RMENU", "-", "-", "-", "-", "-",
 213                 "-", "-", "-", "-", "-", "-", "-", "-", "-", "-", "-", "-", "-", "-",
 214                 "-", "-", "KEY_PLUS", "KEY_COMMA", "KEY_MINUS", "KEY_PERIOD", "-", "-", "-", "-", "-",
 215                 "-", "-", "-", "-", "-", "-", "-", "-", "-", "-", "-", "-", "-", "-",
 216                 "-", "-", "-", "-", "-", "-", "-", "-", "-", "-", "-", "-", "-", "-",
 217                 "-", "-", "-", "-", "-", "-", "-", "-", "-", "-", "-", "-", "-", "-",
 218                 "-", "-", "-", "-", "-", "-", "-", "-", "KEY_ATTN", "KEY_CRSEL", "KEY_EXSEL",
 219                 "KEY_EREOF", "KEY_PLAY", "KEY_ZOOM", "KEY_PA1", "KEY_OEM_CLEAR", "-" };
 220
 221 #define N_(text) text
 222
 223 static const char *KeyNamesLang[] =
 224         { "-", N_("Left Button"), N_("Right Button"), N_("Cancel"), N_("Middle Button"), N_("X Button 1"),
 225                         N_("X Button 2"), "-", N_("Back"), N_("Tab"), "-", "-", N_("Clear"), N_("Return"), "-",
 226                         "-", N_("Shift"), N_("Control"), N_("Menu"), N_("Pause"), N_("Capital"), N_("Kana"), "-",
 227                         N_("Junja"), N_("Final"), N_("Kanji"), "-", N_("Escape"), N_("Convert"), N_("Nonconvert"),
 228                         N_("Accept"), N_("Mode Change"), N_("Space"), N_("Prior"), N_("Next"), N_("End"), N_("Home"),
 229                         N_("Left"), N_("Up"), N_("Right"), N_("Down"), N_("Select"), N_("Print"), N_("Execute"),
 230                         N_("Snapshot"), N_("Insert"), N_("Delete"), N_("Help"), "0", "1", "2", "3", "4", "5",
 231                         "6", "7", "8", "9", "-", "-", "-", "-", "-", "-", "-", "A", "B", "C",
 232                         "D", "E", "F", "G", "H", "I", "J", "K", "L", "M", "N", "O", "P", "Q",
 233                         "R", "S", "T", "U", "V", "W", "X", "Y", "Z", N_("Left Windows"),
 234                         N_("Right Windows"), N_("Apps"), "-", N_("Sleep"), N_("Numpad 0"), N_("Numpad 1"),
 235                         N_("Numpad 2"), N_("Numpad 3"), N_("Numpad 4"), N_("Numpad 5"), N_("Numpad 6"), N_("Numpad 7"),
 236                         N_("Numpad 8"), N_("Numpad 9"), N_("Numpad *"), N_("Numpad +"), N_("Numpad /"), N_("Numpad -"),
 237                         "Numpad .", "Numpad /", "F1", "F2", "F3", "F4", "F5", "F6", "F7", "F8",
 238                         "F9", "F10", "F11", "F12", "F13", "F14", "F15", "F16", "F17", "F18",
 239                         "F19", "F20", "F21", "F22", "F23", "F24", "-", "-", "-", "-", "-", "-",
 240                         "-", "-", N_("Num Lock"), N_("Scroll Lock"), "-", "-", "-", "-", "-", "-", "-",
 241                         "-", "-", "-", "-", "-", "-", "-", N_("Left Shift"), N_("Right Shift"),
 242                         N_("Left Control"), N_("Right Control"), N_("Left Menu"), N_("Right Menu"), "-", "-",
 243                         "-", "-", "-", "-", "-", "-", "-", "-", "-", "-", "-", "-", "-", "-",
 244                         "-", "-", "-", "-", "-", N_("Plus"), N_("Comma"), N_("Minus"), N_("Period"), "-", "-",
 245                         "-", "-", "-", "-", "-", "-", "-", "-", "-", "-", "-", "-", "-", "-",
 246                         "-", "-", "-", "-", "-", "-", "-", "-", "-", "-", "-", "-", "-", "-",
 247                         "-", "-", "-", "-", "-", "-", "-", "-", "-", "-", "-", "-", "-", "-",
 248                         "-", "-", "-", "-", "-", "-", "-", "-", "-", "-", "-", N_("Attn"), N_("CrSel"),
 249                         N_("ExSel"), N_("Erase OEF"), N_("Play"), N_("Zoom"), N_("PA1"), N_("OEM Clear"), "-" };
 250
 251 #undef N_
 252
 253 KeyPress::KeyPress() :
 254         Key(irr::KEY_KEY_CODES_COUNT),
 255         Char(L'\0')
 256 {}
 257
 258 KeyPress::KeyPress(const char *name)
 259 {
 260         if (strlen(name) > 4) {
 261                 try {
 262                         Key = keyname_to_keycode(name);
 263                         m_name = name;
 264                         if (strlen(name) > 8 && strncmp(name, "KEY_KEY_", 8) == 0) {
 265                                 int chars_read = mbtowc(&Char, name + 8, 1);
 266
 267                                 FATAL_ERROR_IF(chars_read != 1, "Unexpected multibyte character");
 268                         } else
 269                                 Char = L'\0';
 270                         return;
 271                 } catch (UnknownKeycode &e) {};
 272         } else {
 273                 // see if we can set it up as a KEY_KEY_something
 274                 m_name = "KEY_KEY_";
 275                 m_name += name;
 276                 try {
 277                         Key = keyname_to_keycode(m_name.c_str());
 278                         int chars_read = mbtowc(&Char, name, 1);
 279
 280                         FATAL_ERROR_IF(chars_read != 1, "Unexpected multibyte character");
 281                         return;
 282                 } catch (UnknownKeycode &e) {};
 283         }
 284
 285         // it's not a (known) key, just take the first char and use that
 286
 287         Key = irr::KEY_KEY_CODES_COUNT;
 288
 289         int mbtowc_ret = mbtowc(&Char, name, 1);
 290         FATAL_ERROR_IF(mbtowc_ret != 1, "Unexpected multibyte character");
 291         m_name = name[0];
 292 }
 293
 294 KeyPress::KeyPress(const irr::SEvent::SKeyInput &in, bool prefer_character)
 295 {
 296         Key = in.Key;
 297         Char = in.Char;
 298
 299         if(prefer_character){
 300                 m_name.resize(MB_CUR_MAX+1, '\0');
 301                 int written = wctomb(&m_name[0], Char);
 302                 if(written > 0){
 303                         infostream<<"KeyPress: Preferring character for "<<m_name<<std::endl;
 304                         Key = irr::KEY_KEY_CODES_COUNT;
 305                         return;
 306                 }
 307         }
 308
 309         if (valid_kcode(Key)) {
 310                 m_name = KeyNames[Key];
 311         } else {
 312                 m_name.resize(MB_CUR_MAX+1, '\0');
 313                 int written = wctomb(&m_name[0], Char);
 314                 if(written < 0){
 315                         std::string hexstr = hex_encode((const char*)&Char, sizeof(Char));
 316                         errorstream<<"KeyPress: Unexpected multibyte character "<<hexstr<<std::endl;
 317                 }
 318         }
 319 }
 320
 321 const char *KeyPress::sym() const
 322 {
 323         if (Key && Key < irr::KEY_KEY_CODES_COUNT)
 324                 return KeyNames[Key];
 325         else {
 326                 return m_name.c_str();
 327         }
 328 }
 329
 330 const char *KeyPress::name() const
 331 {
 332         if (Key && Key < irr::KEY_KEY_CODES_COUNT)
 333                 return KeyNamesLang[Key];
 334         else {
 335                 return m_name.c_str();
 336         }
 337 }
 338
 339 const KeyPress EscapeKey("KEY_ESCAPE");
 340 const KeyPress CancelKey("KEY_CANCEL");
 341 const KeyPress NumberKey[] = {
 342         KeyPress("KEY_KEY_0"), KeyPress("KEY_KEY_1"), KeyPress("KEY_KEY_2"),
 343         KeyPress("KEY_KEY_3"), KeyPress("KEY_KEY_4"), KeyPress("KEY_KEY_5"),
 344         KeyPress("KEY_KEY_6"), KeyPress("KEY_KEY_7"), KeyPress("KEY_KEY_8"),
 345         KeyPress("KEY_KEY_9")};
 346
 347 /*
 348         Key config
 349 */
 350
 351 // A simple cache for quicker lookup
 352 std::map<std::string, KeyPress> g_key_setting_cache;
 353
 354 KeyPress getKeySetting(const char *settingname)
 355 {
 356         std::map<std::string, KeyPress>::iterator n;
 357         n = g_key_setting_cache.find(settingname);
 358         if(n != g_key_setting_cache.end())
 359                 return n->second;
 360         g_key_setting_cache[settingname] = g_settings->get(settingname).c_str();
 361         return g_key_setting_cache.find(settingname)->second;
 362 }
 363
 364 void clearKeyCache()
 365 {
 366         g_key_setting_cache.clear();
 367 }