// Luanti // SPDX-License-Identifier: LGPL-2.1-or-later // Copyright (C) 2010-2013 celeron55, Perttu Ahola #include "keycode.h" #include "settings.h" #include "log.h" #include "debug.h" #include "renderingengine.h" #include "util/hex.h" #include "util/string.h" #include "util/basic_macros.h" #include #include struct table_key { std::string Name; // An EKEY_CODE 'symbol' name as a string irr::EKEY_CODE Key; wchar_t Char; // L'\0' means no character assigned std::string LangName; // empty string means it doesn't have a human description }; #define DEFINEKEY1(x, lang) /* Irrlicht key without character */ \ { #x, irr::x, L'\0', lang }, #define DEFINEKEY2(x, ch, lang) /* Irrlicht key with character */ \ { #x, irr::x, ch, lang }, #define DEFINEKEY3(ch) /* single Irrlicht key (e.g. KEY_KEY_X) */ \ { "KEY_KEY_" TOSTRING(ch), irr::KEY_KEY_ ## ch, (wchar_t) *TOSTRING(ch), TOSTRING(ch) }, #define DEFINEKEY4(ch) /* single Irrlicht function key (e.g. KEY_F3) */ \ { "KEY_F" TOSTRING(ch), irr::KEY_F ## ch, L'\0', "F" TOSTRING(ch) }, #define DEFINEKEY5(ch) /* key without Irrlicht keycode */ \ { ch, irr::KEY_KEY_CODES_COUNT, (wchar_t) *ch, ch }, #define N_(text) text static std::vector table = { // Keys that can be reliably mapped between Char and Key DEFINEKEY3(0) DEFINEKEY3(1) DEFINEKEY3(2) DEFINEKEY3(3) DEFINEKEY3(4) DEFINEKEY3(5) DEFINEKEY3(6) DEFINEKEY3(7) DEFINEKEY3(8) DEFINEKEY3(9) DEFINEKEY3(A) DEFINEKEY3(B) DEFINEKEY3(C) DEFINEKEY3(D) DEFINEKEY3(E) DEFINEKEY3(F) DEFINEKEY3(G) DEFINEKEY3(H) DEFINEKEY3(I) DEFINEKEY3(J) DEFINEKEY3(K) DEFINEKEY3(L) DEFINEKEY3(M) DEFINEKEY3(N) DEFINEKEY3(O) DEFINEKEY3(P) DEFINEKEY3(Q) DEFINEKEY3(R) DEFINEKEY3(S) DEFINEKEY3(T) DEFINEKEY3(U) DEFINEKEY3(V) DEFINEKEY3(W) DEFINEKEY3(X) DEFINEKEY3(Y) DEFINEKEY3(Z) DEFINEKEY2(KEY_PLUS, L'+', "+") DEFINEKEY2(KEY_COMMA, L',', ",") DEFINEKEY2(KEY_MINUS, L'-', "-") DEFINEKEY2(KEY_PERIOD, L'.', ".") // Keys without a Char DEFINEKEY1(KEY_LBUTTON, N_("Left Button")) DEFINEKEY1(KEY_RBUTTON, N_("Right Button")) //~ Usually paired with the Pause key DEFINEKEY1(KEY_CANCEL, N_("Break Key")) DEFINEKEY1(KEY_MBUTTON, N_("Middle Button")) DEFINEKEY1(KEY_XBUTTON1, N_("X Button 1")) DEFINEKEY1(KEY_XBUTTON2, N_("X Button 2")) DEFINEKEY1(KEY_BACK, N_("Backspace")) DEFINEKEY1(KEY_TAB, N_("Tab")) DEFINEKEY1(KEY_CLEAR, N_("Clear Key")) DEFINEKEY1(KEY_RETURN, N_("Return Key")) DEFINEKEY1(KEY_SHIFT, N_("Shift Key")) DEFINEKEY1(KEY_CONTROL, N_("Control Key")) //~ Key name, common on Windows keyboards DEFINEKEY1(KEY_MENU, N_("Menu Key")) //~ Usually paired with the Break key DEFINEKEY1(KEY_PAUSE, N_("Pause Key")) DEFINEKEY1(KEY_CAPITAL, N_("Caps Lock")) DEFINEKEY1(KEY_SPACE, N_("Space")) DEFINEKEY1(KEY_PRIOR, N_("Page Up")) DEFINEKEY1(KEY_NEXT, N_("Page Down")) DEFINEKEY1(KEY_END, N_("End")) DEFINEKEY1(KEY_HOME, N_("Home")) DEFINEKEY1(KEY_LEFT, N_("Left Arrow")) DEFINEKEY1(KEY_UP, N_("Up Arrow")) DEFINEKEY1(KEY_RIGHT, N_("Right Arrow")) DEFINEKEY1(KEY_DOWN, N_("Down Arrow")) //~ Key name DEFINEKEY1(KEY_SELECT, N_("Select")) //~ "Print screen" key DEFINEKEY1(KEY_PRINT, N_("Print")) DEFINEKEY1(KEY_EXECUT, N_("Execute")) DEFINEKEY1(KEY_SNAPSHOT, N_("Snapshot")) DEFINEKEY1(KEY_INSERT, N_("Insert")) DEFINEKEY1(KEY_DELETE, N_("Delete Key")) DEFINEKEY1(KEY_HELP, N_("Help")) DEFINEKEY1(KEY_LWIN, N_("Left Windows")) DEFINEKEY1(KEY_RWIN, N_("Right Windows")) DEFINEKEY1(KEY_NUMPAD0, N_("Numpad 0")) // These are not assigned to a char DEFINEKEY1(KEY_NUMPAD1, N_("Numpad 1")) // to prevent interference with KEY_KEY_[0-9]. DEFINEKEY1(KEY_NUMPAD2, N_("Numpad 2")) DEFINEKEY1(KEY_NUMPAD3, N_("Numpad 3")) DEFINEKEY1(KEY_NUMPAD4, N_("Numpad 4")) DEFINEKEY1(KEY_NUMPAD5, N_("Numpad 5")) DEFINEKEY1(KEY_NUMPAD6, N_("Numpad 6")) DEFINEKEY1(KEY_NUMPAD7, N_("Numpad 7")) DEFINEKEY1(KEY_NUMPAD8, N_("Numpad 8")) DEFINEKEY1(KEY_NUMPAD9, N_("Numpad 9")) DEFINEKEY1(KEY_MULTIPLY, N_("Numpad *")) DEFINEKEY1(KEY_ADD, N_("Numpad +")) DEFINEKEY1(KEY_SEPARATOR, N_("Numpad .")) DEFINEKEY1(KEY_SUBTRACT, N_("Numpad -")) DEFINEKEY1(KEY_DECIMAL, N_("Numpad .")) DEFINEKEY1(KEY_DIVIDE, N_("Numpad /")) DEFINEKEY4(1) DEFINEKEY4(2) DEFINEKEY4(3) DEFINEKEY4(4) DEFINEKEY4(5) DEFINEKEY4(6) DEFINEKEY4(7) DEFINEKEY4(8) DEFINEKEY4(9) DEFINEKEY4(10) DEFINEKEY4(11) DEFINEKEY4(12) DEFINEKEY4(13) DEFINEKEY4(14) DEFINEKEY4(15) DEFINEKEY4(16) DEFINEKEY4(17) DEFINEKEY4(18) DEFINEKEY4(19) DEFINEKEY4(20) DEFINEKEY4(21) DEFINEKEY4(22) DEFINEKEY4(23) DEFINEKEY4(24) DEFINEKEY1(KEY_NUMLOCK, N_("Num Lock")) DEFINEKEY1(KEY_SCROLL, N_("Scroll Lock")) DEFINEKEY1(KEY_LSHIFT, N_("Left Shift")) DEFINEKEY1(KEY_RSHIFT, N_("Right Shift")) DEFINEKEY1(KEY_LCONTROL, N_("Left Control")) DEFINEKEY1(KEY_RCONTROL, N_("Right Control")) DEFINEKEY1(KEY_LMENU, N_("Left Menu")) DEFINEKEY1(KEY_RMENU, N_("Right Menu")) // Rare/weird keys DEFINEKEY1(KEY_KANA, "Kana") DEFINEKEY1(KEY_HANGUEL, "Hangul") DEFINEKEY1(KEY_HANGUL, "Hangul") DEFINEKEY1(KEY_JUNJA, "Junja") DEFINEKEY1(KEY_FINAL, "Final") DEFINEKEY1(KEY_KANJI, "Kanji") DEFINEKEY1(KEY_HANJA, "Hanja") DEFINEKEY1(KEY_ESCAPE, N_("IME Escape")) DEFINEKEY1(KEY_CONVERT, N_("IME Convert")) DEFINEKEY1(KEY_NONCONVERT, N_("IME Nonconvert")) DEFINEKEY1(KEY_ACCEPT, N_("IME Accept")) DEFINEKEY1(KEY_MODECHANGE, N_("IME Mode Change")) DEFINEKEY1(KEY_APPS, N_("Apps")) DEFINEKEY1(KEY_SLEEP, N_("Sleep")) DEFINEKEY1(KEY_OEM_1, "OEM 1") // KEY_OEM_[0-9] and KEY_OEM_102 are assigned to multiple DEFINEKEY1(KEY_OEM_2, "OEM 2") // different chars (on different platforms too) and thus w/o char DEFINEKEY1(KEY_OEM_3, "OEM 3") DEFINEKEY1(KEY_OEM_4, "OEM 4") DEFINEKEY1(KEY_OEM_5, "OEM 5") DEFINEKEY1(KEY_OEM_6, "OEM 6") DEFINEKEY1(KEY_OEM_7, "OEM 7") DEFINEKEY1(KEY_OEM_8, "OEM 8") DEFINEKEY1(KEY_OEM_AX, "OEM AX") DEFINEKEY1(KEY_OEM_102, "OEM 102") DEFINEKEY1(KEY_ATTN, "Attn") DEFINEKEY1(KEY_CRSEL, "CrSel") DEFINEKEY1(KEY_EXSEL, "ExSel") DEFINEKEY1(KEY_EREOF, N_("Erase EOF")) DEFINEKEY1(KEY_PLAY, N_("Play")) DEFINEKEY1(KEY_ZOOM, N_("Zoom Key")) DEFINEKEY1(KEY_PA1, "PA1") DEFINEKEY1(KEY_OEM_CLEAR, N_("OEM Clear")) // Keys without Irrlicht keycode DEFINEKEY5("!") DEFINEKEY5("\"") DEFINEKEY5("#") DEFINEKEY5("$") DEFINEKEY5("%") DEFINEKEY5("&") DEFINEKEY5("'") DEFINEKEY5("(") DEFINEKEY5(")") DEFINEKEY5("*") DEFINEKEY5("/") DEFINEKEY5(":") DEFINEKEY5(";") DEFINEKEY5("<") DEFINEKEY5("=") DEFINEKEY5(">") DEFINEKEY5("?") DEFINEKEY5("@") DEFINEKEY5("[") DEFINEKEY5("\\") DEFINEKEY5("]") DEFINEKEY5("^") DEFINEKEY5("_") }; static const table_key invalid_key = {"", irr::KEY_UNKNOWN, L'\0', ""}; #undef N_ static const table_key &lookup_keychar(wchar_t Char) { if (Char == L'\0') return invalid_key; for (const auto &table_key : table) { if (table_key.Char == Char) return table_key; } // Create a new entry in the lookup table if one is not available. auto newsym = wide_to_utf8(std::wstring_view(&Char, 1)); table_key new_key {newsym, irr::KEY_KEY_CODES_COUNT, Char, newsym}; return table.emplace_back(std::move(new_key)); } static const table_key &lookup_keykey(irr::EKEY_CODE key) { if (!Keycode::isValid(key)) return invalid_key; for (const auto &table_key : table) { if (table_key.Key == key) return table_key; } return invalid_key; } static const table_key &lookup_keyname(std::string_view name) { if (name.empty()) return invalid_key; for (const auto &table_key : table) { if (table_key.Name == name) return table_key; } auto wname = utf8_to_wide(name); if (wname.empty()) return invalid_key; return lookup_keychar(wname[0]); } static const table_key &lookup_scancode(const u32 scancode) { auto key = RenderingEngine::get_raw_device()->getKeyFromScancode(scancode); return std::holds_alternative(key) ? lookup_keykey(std::get(key)) : lookup_keychar(std::get(key)); } static const table_key &lookup_scancode(const std::variant &scancode) { return std::holds_alternative(scancode) ? lookup_keykey(std::get(scancode)) : lookup_scancode(std::get(scancode)); } void KeyPress::loadFromKey(irr::EKEY_CODE keycode, wchar_t keychar) { scancode = RenderingEngine::get_raw_device()->getScancodeFromKey(Keycode(keycode, keychar)); } KeyPress::KeyPress(const std::string &name) { if (loadFromScancode(name)) return; const auto &key = lookup_keyname(name); loadFromKey(key.Key, key.Char); } KeyPress::KeyPress(const irr::SEvent::SKeyInput &in) { if (USE_SDL2) { if (in.SystemKeyCode) scancode.emplace(in.SystemKeyCode); else scancode.emplace(in.Key); } else { loadFromKey(in.Key, in.Char); } } std::string KeyPress::formatScancode() const { if (USE_SDL2) { if (auto pv = std::get_if(&scancode)) return *pv == 0 ? "" : "SYSTEM_SCANCODE_" + std::to_string(*pv); } return ""; } std::string KeyPress::sym() const { std::string name = lookup_scancode(scancode).Name; if (USE_SDL2 || name.empty()) if (auto newname = formatScancode(); !newname.empty()) return newname; return name; } std::string KeyPress::name() const { const auto &name = lookup_scancode(scancode).LangName; if (!name.empty()) return name; return formatScancode(); } irr::EKEY_CODE KeyPress::getKeycode() const { return lookup_scancode(scancode).Key; } wchar_t KeyPress::getKeychar() const { return lookup_scancode(scancode).Char; } bool KeyPress::loadFromScancode(const std::string &name) { if (USE_SDL2) { if (!str_starts_with(name, "SYSTEM_SCANCODE_")) return false; char *p; const auto code = strtoul(name.c_str()+16, &p, 10); if (p != name.c_str() + name.size()) return false; scancode.emplace(code); return true; } else { return false; } } std::unordered_map specialKeyCache; const KeyPress &KeyPress::getSpecialKey(const std::string &name) { auto &key = specialKeyCache[name]; if (!key) key = KeyPress(name); return key; } /* Key config */ // A simple cache for quicker lookup static std::unordered_map g_key_setting_cache; const KeyPress &getKeySetting(const std::string &settingname) { auto n = g_key_setting_cache.find(settingname); if (n != g_key_setting_cache.end()) return n->second; auto keysym = g_settings->get(settingname); auto &ref = g_key_setting_cache[settingname]; ref = KeyPress(keysym); if (!keysym.empty() && !ref) { warningstream << "Invalid key '" << keysym << "' for '" << settingname << "'." << std::endl; } return ref; } void clearKeyCache() { g_key_setting_cache.clear(); }