godot/core/os/keyboard.cpp

510 lines
16 KiB
C++
Raw Normal View History

2014-02-10 01:10:30 +00:00
/*************************************************************************/
/* keyboard.cpp */
/*************************************************************************/
/* This file is part of: */
/* GODOT ENGINE */
/* https://godotengine.org */
2014-02-10 01:10:30 +00:00
/*************************************************************************/
/* Copyright (c) 2007-2022 Juan Linietsky, Ariel Manzur. */
/* Copyright (c) 2014-2022 Godot Engine contributors (cf. AUTHORS.md). */
2014-02-10 01:10:30 +00:00
/* */
/* Permission is hereby granted, free of charge, to any person obtaining */
/* a copy of this software and associated documentation files (the */
/* "Software"), to deal in the Software without restriction, including */
/* without limitation the rights to use, copy, modify, merge, publish, */
/* distribute, sublicense, and/or sell copies of the Software, and to */
/* permit persons to whom the Software is furnished to do so, subject to */
/* the following conditions: */
/* */
/* The above copyright notice and this permission notice shall be */
/* included in all copies or substantial portions of the Software. */
/* */
/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.*/
/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
/*************************************************************************/
2014-02-10 01:10:30 +00:00
#include "keyboard.h"
#include "core/os/os.h"
2014-02-10 01:10:30 +00:00
struct _KeyCodeText {
2021-08-13 21:31:57 +00:00
Key code;
2014-02-10 01:10:30 +00:00
const char *text;
};
static const _KeyCodeText _keycodes[] = {
/* clang-format off */
2021-08-13 21:31:57 +00:00
{Key::ESCAPE ,"Escape"},
{Key::TAB ,"Tab"},
{Key::BACKTAB ,"Backtab"},
{Key::BACKSPACE ,"Backspace"},
2021-08-13 21:31:57 +00:00
{Key::ENTER ,"Enter"},
{Key::KP_ENTER ,"Kp Enter"},
{Key::INSERT ,"Insert"},
{Key::KEY_DELETE ,"Delete"},
{Key::PAUSE ,"Pause"},
{Key::PRINT ,"Print"},
{Key::SYSREQ ,"SysReq"},
{Key::CLEAR ,"Clear"},
{Key::HOME ,"Home"},
{Key::END ,"End"},
{Key::LEFT ,"Left"},
{Key::UP ,"Up"},
{Key::RIGHT ,"Right"},
{Key::DOWN ,"Down"},
{Key::PAGEUP ,"PageUp"},
{Key::PAGEDOWN ,"PageDown"},
{Key::SHIFT ,"Shift"},
{Key::CTRL ,"Ctrl"},
#ifdef OSX_ENABLED
2021-08-13 21:31:57 +00:00
{Key::META ,"Command"},
#else
2021-08-13 21:31:57 +00:00
{Key::META ,"Meta"},
#endif
2021-08-13 21:31:57 +00:00
{Key::ALT ,"Alt"},
{Key::CAPSLOCK ,"CapsLock"},
{Key::NUMLOCK ,"NumLock"},
{Key::SCROLLLOCK ,"ScrollLock"},
{Key::F1 ,"F1"},
{Key::F2 ,"F2"},
{Key::F3 ,"F3"},
{Key::F4 ,"F4"},
{Key::F5 ,"F5"},
{Key::F6 ,"F6"},
{Key::F7 ,"F7"},
{Key::F8 ,"F8"},
{Key::F9 ,"F9"},
{Key::F10 ,"F10"},
{Key::F11 ,"F11"},
{Key::F12 ,"F12"},
{Key::F13 ,"F13"},
{Key::F14 ,"F14"},
{Key::F15 ,"F15"},
{Key::F16 ,"F16"},
{Key::F17 ,"F17"},
{Key::F18 ,"F18"},
{Key::F19 ,"F19"},
{Key::F20 ,"F20"},
{Key::F21 ,"F21"},
{Key::F22 ,"F22"},
{Key::F23 ,"F23"},
{Key::F24 ,"F24"},
{Key::F25 ,"F25"},
{Key::F26 ,"F26"},
{Key::F27 ,"F27"},
{Key::F28 ,"F28"},
{Key::F29 ,"F29"},
{Key::F30 ,"F30"},
{Key::F31 ,"F31"},
{Key::F32 ,"F32"},
{Key::F33 ,"F33"},
{Key::F34 ,"F34"},
{Key::F35 ,"F35"},
2021-08-13 21:31:57 +00:00
{Key::KP_MULTIPLY ,"Kp Multiply"},
{Key::KP_DIVIDE ,"Kp Divide"},
{Key::KP_SUBTRACT ,"Kp Subtract"},
{Key::KP_PERIOD ,"Kp Period"},
{Key::KP_ADD ,"Kp Add"},
{Key::KP_0 ,"Kp 0"},
{Key::KP_1 ,"Kp 1"},
{Key::KP_2 ,"Kp 2"},
{Key::KP_3 ,"Kp 3"},
{Key::KP_4 ,"Kp 4"},
{Key::KP_5 ,"Kp 5"},
{Key::KP_6 ,"Kp 6"},
{Key::KP_7 ,"Kp 7"},
{Key::KP_8 ,"Kp 8"},
{Key::KP_9 ,"Kp 9"},
{Key::SUPER_L ,"Super L"},
{Key::SUPER_R ,"Super R"},
{Key::MENU ,"Menu"},
{Key::HYPER_L ,"Hyper L"},
{Key::HYPER_R ,"Hyper R"},
{Key::HELP ,"Help"},
{Key::DIRECTION_L ,"Direction L"},
{Key::DIRECTION_R ,"Direction R"},
{Key::BACK ,"Back"},
{Key::FORWARD ,"Forward"},
{Key::STOP ,"Stop"},
{Key::REFRESH ,"Refresh"},
{Key::VOLUMEDOWN ,"VolumeDown"},
{Key::VOLUMEMUTE ,"VolumeMute"},
{Key::VOLUMEUP ,"VolumeUp"},
{Key::BASSBOOST ,"BassBoost"},
{Key::BASSUP ,"BassUp"},
{Key::BASSDOWN ,"BassDown"},
{Key::TREBLEUP ,"TrebleUp"},
{Key::TREBLEDOWN ,"TrebleDown"},
{Key::MEDIAPLAY ,"MediaPlay"},
{Key::MEDIASTOP ,"MediaStop"},
{Key::MEDIAPREVIOUS ,"MediaPrevious"},
{Key::MEDIANEXT ,"MediaNext"},
{Key::MEDIARECORD ,"MediaRecord"},
{Key::HOMEPAGE ,"HomePage"},
{Key::FAVORITES ,"Favorites"},
{Key::SEARCH ,"Search"},
{Key::STANDBY ,"StandBy"},
{Key::LAUNCHMAIL ,"LaunchMail"},
{Key::LAUNCHMEDIA ,"LaunchMedia"},
{Key::LAUNCH0 ,"Launch0"},
{Key::LAUNCH1 ,"Launch1"},
{Key::LAUNCH2 ,"Launch2"},
{Key::LAUNCH3 ,"Launch3"},
{Key::LAUNCH4 ,"Launch4"},
{Key::LAUNCH5 ,"Launch5"},
{Key::LAUNCH6 ,"Launch6"},
{Key::LAUNCH7 ,"Launch7"},
{Key::LAUNCH8 ,"Launch8"},
{Key::LAUNCH9 ,"Launch9"},
{Key::LAUNCHA ,"LaunchA"},
{Key::LAUNCHB ,"LaunchB"},
{Key::LAUNCHC ,"LaunchC"},
{Key::LAUNCHD ,"LaunchD"},
{Key::LAUNCHE ,"LaunchE"},
{Key::LAUNCHF ,"LaunchF"},
{Key::UNKNOWN ,"Unknown"},
{Key::SPACE ,"Space"},
{Key::EXCLAM ,"Exclam"},
{Key::QUOTEDBL ,"QuoteDbl"},
{Key::NUMBERSIGN ,"NumberSign"},
{Key::DOLLAR ,"Dollar"},
{Key::PERCENT ,"Percent"},
{Key::AMPERSAND ,"Ampersand"},
{Key::APOSTROPHE ,"Apostrophe"},
{Key::PARENLEFT ,"ParenLeft"},
{Key::PARENRIGHT ,"ParenRight"},
{Key::ASTERISK ,"Asterisk"},
{Key::PLUS ,"Plus"},
{Key::COMMA ,"Comma"},
{Key::MINUS ,"Minus"},
{Key::PERIOD ,"Period"},
{Key::SLASH ,"Slash"},
{Key::KEY_0 ,"0"},
{Key::KEY_1 ,"1"},
{Key::KEY_2 ,"2"},
{Key::KEY_3 ,"3"},
{Key::KEY_4 ,"4"},
{Key::KEY_5 ,"5"},
{Key::KEY_6 ,"6"},
{Key::KEY_7 ,"7"},
{Key::KEY_8 ,"8"},
{Key::KEY_9 ,"9"},
{Key::COLON ,"Colon"},
{Key::SEMICOLON ,"Semicolon"},
{Key::LESS ,"Less"},
{Key::EQUAL ,"Equal"},
{Key::GREATER ,"Greater"},
{Key::QUESTION ,"Question"},
{Key::AT ,"At"},
{Key::A ,"A"},
{Key::B ,"B"},
{Key::C ,"C"},
{Key::D ,"D"},
{Key::E ,"E"},
{Key::F ,"F"},
{Key::G ,"G"},
{Key::H ,"H"},
{Key::I ,"I"},
{Key::J ,"J"},
{Key::K ,"K"},
{Key::L ,"L"},
{Key::M ,"M"},
{Key::N ,"N"},
{Key::O ,"O"},
{Key::P ,"P"},
{Key::Q ,"Q"},
{Key::R ,"R"},
{Key::S ,"S"},
{Key::T ,"T"},
{Key::U ,"U"},
{Key::V ,"V"},
{Key::W ,"W"},
{Key::X ,"X"},
{Key::Y ,"Y"},
{Key::Z ,"Z"},
{Key::BRACKETLEFT ,"BracketLeft"},
{Key::BACKSLASH ,"BackSlash"},
{Key::BRACKETRIGHT ,"BracketRight"},
{Key::ASCIICIRCUM ,"AsciiCircum"},
{Key::UNDERSCORE ,"UnderScore"},
{Key::QUOTELEFT ,"QuoteLeft"},
{Key::BRACELEFT ,"BraceLeft"},
{Key::BAR ,"Bar"},
{Key::BRACERIGHT ,"BraceRight"},
{Key::ASCIITILDE ,"AsciiTilde"},
{Key::NOBREAKSPACE ,"NoBreakSpace"},
{Key::EXCLAMDOWN ,"ExclamDown"},
{Key::CENT ,"Cent"},
{Key::STERLING ,"Sterling"},
{Key::CURRENCY ,"Currency"},
{Key::YEN ,"Yen"},
{Key::BROKENBAR ,"BrokenBar"},
{Key::SECTION ,"Section"},
{Key::DIAERESIS ,"Diaeresis"},
{Key::COPYRIGHT ,"Copyright"},
{Key::ORDFEMININE ,"Ordfeminine"},
{Key::GUILLEMOTLEFT ,"GuillemotLeft"},
{Key::NOTSIGN ,"NotSign"},
{Key::HYPHEN ,"Hyphen"},
{Key::KEY_REGISTERED ,"Registered"},
{Key::MACRON ,"Macron"},
{Key::DEGREE ,"Degree"},
{Key::PLUSMINUS ,"PlusMinus"},
{Key::TWOSUPERIOR ,"TwoSuperior"},
{Key::THREESUPERIOR ,"ThreeSuperior"},
{Key::ACUTE ,"Acute"},
{Key::MU ,"Mu"},
{Key::PARAGRAPH ,"Paragraph"},
{Key::PERIODCENTERED ,"PeriodCentered"},
{Key::CEDILLA ,"Cedilla"},
{Key::ONESUPERIOR ,"OneSuperior"},
{Key::MASCULINE ,"Masculine"},
{Key::GUILLEMOTRIGHT ,"GuillemotRight"},
{Key::ONEQUARTER ,"OneQuarter"},
{Key::ONEHALF ,"OneHalf"},
{Key::THREEQUARTERS ,"ThreeQuarters"},
{Key::QUESTIONDOWN ,"QuestionDown"},
{Key::AGRAVE ,"Agrave"},
{Key::AACUTE ,"Aacute"},
{Key::ACIRCUMFLEX ,"AcircumFlex"},
{Key::ATILDE ,"Atilde"},
{Key::ADIAERESIS ,"Adiaeresis"},
{Key::ARING ,"Aring"},
{Key::AE ,"Ae"},
{Key::CCEDILLA ,"Ccedilla"},
{Key::EGRAVE ,"Egrave"},
{Key::EACUTE ,"Eacute"},
{Key::ECIRCUMFLEX ,"Ecircumflex"},
{Key::EDIAERESIS ,"Ediaeresis"},
{Key::IGRAVE ,"Igrave"},
{Key::IACUTE ,"Iacute"},
{Key::ICIRCUMFLEX ,"Icircumflex"},
{Key::IDIAERESIS ,"Idiaeresis"},
{Key::ETH ,"Eth"},
{Key::NTILDE ,"Ntilde"},
{Key::OGRAVE ,"Ograve"},
{Key::OACUTE ,"Oacute"},
{Key::OCIRCUMFLEX ,"Ocircumflex"},
{Key::OTILDE ,"Otilde"},
{Key::ODIAERESIS ,"Odiaeresis"},
{Key::MULTIPLY ,"Multiply"},
{Key::OOBLIQUE ,"Ooblique"},
{Key::UGRAVE ,"Ugrave"},
{Key::UACUTE ,"Uacute"},
{Key::UCIRCUMFLEX ,"Ucircumflex"},
{Key::UDIAERESIS ,"Udiaeresis"},
{Key::YACUTE ,"Yacute"},
{Key::THORN ,"Thorn"},
{Key::SSHARP ,"Ssharp"},
{Key::DIVISION ,"Division"},
{Key::YDIAERESIS ,"Ydiaeresis"},
{Key::NONE ,nullptr}
/* clang-format on */
2014-02-10 01:10:30 +00:00
};
2021-08-13 21:31:57 +00:00
bool keycode_has_unicode(Key p_keycode) {
switch (p_keycode) {
2021-08-13 21:31:57 +00:00
case Key::ESCAPE:
case Key::TAB:
case Key::BACKTAB:
case Key::BACKSPACE:
case Key::ENTER:
case Key::KP_ENTER:
case Key::INSERT:
case Key::KEY_DELETE:
case Key::PAUSE:
case Key::PRINT:
case Key::SYSREQ:
case Key::CLEAR:
case Key::HOME:
case Key::END:
case Key::LEFT:
case Key::UP:
case Key::RIGHT:
case Key::DOWN:
case Key::PAGEUP:
case Key::PAGEDOWN:
case Key::SHIFT:
case Key::CTRL:
case Key::META:
case Key::ALT:
case Key::CAPSLOCK:
case Key::NUMLOCK:
case Key::SCROLLLOCK:
case Key::F1:
case Key::F2:
case Key::F3:
case Key::F4:
case Key::F5:
case Key::F6:
case Key::F7:
case Key::F8:
case Key::F9:
case Key::F10:
case Key::F11:
case Key::F12:
case Key::F13:
case Key::F14:
case Key::F15:
case Key::F16:
case Key::F17:
case Key::F18:
case Key::F19:
case Key::F20:
case Key::F21:
case Key::F22:
case Key::F23:
case Key::F24:
case Key::F25:
case Key::F26:
case Key::F27:
case Key::F28:
case Key::F29:
case Key::F30:
case Key::F31:
case Key::F32:
case Key::F33:
case Key::F34:
case Key::F35:
2021-08-13 21:31:57 +00:00
case Key::SUPER_L:
case Key::SUPER_R:
case Key::MENU:
case Key::HYPER_L:
case Key::HYPER_R:
case Key::HELP:
case Key::DIRECTION_L:
case Key::DIRECTION_R:
case Key::BACK:
case Key::FORWARD:
case Key::STOP:
case Key::REFRESH:
case Key::VOLUMEDOWN:
case Key::VOLUMEMUTE:
case Key::VOLUMEUP:
case Key::BASSBOOST:
case Key::BASSUP:
case Key::BASSDOWN:
case Key::TREBLEUP:
case Key::TREBLEDOWN:
case Key::MEDIAPLAY:
case Key::MEDIASTOP:
case Key::MEDIAPREVIOUS:
case Key::MEDIANEXT:
case Key::MEDIARECORD:
case Key::HOMEPAGE:
case Key::FAVORITES:
case Key::SEARCH:
case Key::STANDBY:
case Key::OPENURL:
case Key::LAUNCHMAIL:
case Key::LAUNCHMEDIA:
case Key::LAUNCH0:
case Key::LAUNCH1:
case Key::LAUNCH2:
case Key::LAUNCH3:
case Key::LAUNCH4:
case Key::LAUNCH5:
case Key::LAUNCH6:
case Key::LAUNCH7:
case Key::LAUNCH8:
case Key::LAUNCH9:
case Key::LAUNCHA:
case Key::LAUNCHB:
case Key::LAUNCHC:
case Key::LAUNCHD:
case Key::LAUNCHE:
case Key::LAUNCHF:
return false;
2021-08-13 21:31:57 +00:00
default: {
}
2014-02-10 01:10:30 +00:00
}
return true;
}
2021-08-13 21:31:57 +00:00
String keycode_get_string(Key p_code) {
2014-02-10 01:10:30 +00:00
String codestr;
2021-08-13 21:31:57 +00:00
if ((p_code & KeyModifierMask::SHIFT) != Key::NONE) {
codestr += find_keycode_name(Key::SHIFT);
codestr += "+";
}
2021-08-13 21:31:57 +00:00
if ((p_code & KeyModifierMask::ALT) != Key::NONE) {
codestr += find_keycode_name(Key::ALT);
codestr += "+";
}
2021-08-13 21:31:57 +00:00
if ((p_code & KeyModifierMask::CTRL) != Key::NONE) {
codestr += find_keycode_name(Key::CTRL);
codestr += "+";
}
2021-08-13 21:31:57 +00:00
if ((p_code & KeyModifierMask::META) != Key::NONE) {
codestr += find_keycode_name(Key::META);
codestr += "+";
}
2014-02-10 01:10:30 +00:00
2021-08-13 21:31:57 +00:00
p_code &= KeyModifierMask::CODE_MASK;
2014-02-10 01:10:30 +00:00
const _KeyCodeText *kct = &_keycodes[0];
2014-02-10 01:10:30 +00:00
while (kct->text) {
2021-08-13 21:31:57 +00:00
if (kct->code == p_code) {
codestr += kct->text;
2014-02-10 01:10:30 +00:00
return codestr;
}
kct++;
}
2021-08-13 21:31:57 +00:00
codestr += String::chr((char32_t)p_code);
2014-02-10 01:10:30 +00:00
return codestr;
}
2021-08-13 21:31:57 +00:00
Key find_keycode(const String &p_code) {
const _KeyCodeText *kct = &_keycodes[0];
2014-02-10 01:10:30 +00:00
while (kct->text) {
if (p_code.nocasecmp_to(kct->text) == 0) {
2014-02-10 01:10:30 +00:00
return kct->code;
}
kct++;
}
2021-08-13 21:31:57 +00:00
return Key::NONE;
2014-02-10 01:10:30 +00:00
}
2021-08-13 21:31:57 +00:00
const char *find_keycode_name(Key p_keycode) {
const _KeyCodeText *kct = &_keycodes[0];
while (kct->text) {
if (kct->code == p_keycode) {
return kct->text;
}
kct++;
}
return "";
}
int keycode_get_count() {
const _KeyCodeText *kct = &_keycodes[0];
int count = 0;
while (kct->text) {
count++;
kct++;
}
return count;
}
int keycode_get_value_by_index(int p_index) {
2021-08-13 21:31:57 +00:00
return (int)_keycodes[p_index].code;
}
const char *keycode_get_name_by_index(int p_index) {
return _keycodes[p_index].text;
}