// 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 "renderingengine.h" #include "util/string.h" #include #include struct table_key { std::string Name; // An EKEY_CODE 'symbol' name as a string 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, x, L'\0', lang }, #define DEFINEKEY2(x, ch, lang) /* Irrlicht key with character */ \ { #x, x, ch, lang }, #define DEFINEKEY3(ch) /* single Irrlicht key (e.g. KEY_KEY_X) */ \ { "KEY_KEY_" TOSTRING(ch), KEY_KEY_ ## ch, static_cast(*TOSTRING(ch)), TOSTRING(ch) }, #define DEFINEKEY4(ch) /* single Irrlicht function key (e.g. KEY_F3) */ \ { "KEY_F" TOSTRING(ch), KEY_F ## ch, L'\0', "F" TOSTRING(ch) }, #define DEFINEKEY5(ch) /* key without Irrlicht keycode */ \ { ch, KEY_KEY_CODES_COUNT, static_cast(*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 // Note: we add "Key" to the description if the string could be confused for something else DEFINEKEY1(KEY_LBUTTON, N_("Left Click")) DEFINEKEY1(KEY_RBUTTON, N_("Right Click")) //~ Usually paired with the Pause key DEFINEKEY1(KEY_CANCEL, N_("Break Key")) DEFINEKEY1(KEY_MBUTTON, N_("Middle Click")) DEFINEKEY1(KEY_XBUTTON1, N_("Mouse X1")) DEFINEKEY1(KEY_XBUTTON2, N_("Mouse X2")) DEFINEKEY1(KEY_BACK, N_("Backspace")) DEFINEKEY1(KEY_TAB, N_("Tab Key")) DEFINEKEY1(KEY_CLEAR, N_("Clear Key")) DEFINEKEY1(KEY_RETURN, N_("Return Key")) DEFINEKEY1(KEY_SHIFT, N_("Shift Key")) DEFINEKEY1(KEY_CONTROL, N_("Control Key")) 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 Key")) DEFINEKEY1(KEY_HOME, N_("Home Key")) DEFINEKEY1(KEY_LEFT, N_("Left Arrow")) DEFINEKEY1(KEY_UP, N_("Up Arrow")) DEFINEKEY1(KEY_RIGHT, N_("Right Arrow")) DEFINEKEY1(KEY_DOWN, N_("Down Arrow")) DEFINEKEY1(KEY_SELECT, N_("Select Key")) //~ "Print screen" key DEFINEKEY1(KEY_PRINT, N_("Print")) DEFINEKEY1(KEY_INSERT, N_("Insert")) DEFINEKEY1(KEY_DELETE, N_("Delete Key")) DEFINEKEY1(KEY_HELP, N_("Help Key")) //~ Name of key DEFINEKEY1(KEY_LWIN, N_("Left Windows")) //~ Name of key 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 .")) // duplicate of KEY_SEPARATOR? 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, "IME Escape") DEFINEKEY1(KEY_CONVERT, "IME Convert") DEFINEKEY1(KEY_NONCONVERT, "IME Nonconvert") DEFINEKEY1(KEY_ACCEPT, "IME Accept") DEFINEKEY1(KEY_MODECHANGE, "IME Mode Change") DEFINEKEY1(KEY_EXECUT, "Execute Key") DEFINEKEY1(KEY_SNAPSHOT, "Snapshot Key") DEFINEKEY1(KEY_APPS, "Apps Key") DEFINEKEY1(KEY_SLEEP, "Sleep Key") 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, "Erase EOF") DEFINEKEY1(KEY_PLAY, N_("Play")) DEFINEKEY1(KEY_ZOOM, "Zoom Key") DEFINEKEY1(KEY_PA1, "PA1") DEFINEKEY1(KEY_OEM_CLEAR, "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 = {"", 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, KEY_KEY_CODES_COUNT, Char, newsym}; return table.emplace_back(std::move(new_key)); } static const table_key &lookup_keykey(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(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 SEvent::SKeyInput &in) { if (in.SystemKeyCode) scancode.emplace(in.SystemKeyCode); else scancode.emplace(in.Key); } std::string KeyPress::formatScancode() const { 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 (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(); } 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 (!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; } std::unordered_map specialKeyCache; 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; 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(); }