mirror of
https://github.com/godotengine/godot.git
synced 2025-11-04 07:31:16 +00:00
471 lines
16 KiB
C++
471 lines
16 KiB
C++
/*************************************************************************/
|
|
/* keyboard.cpp */
|
|
/*************************************************************************/
|
|
/* This file is part of: */
|
|
/* GODOT ENGINE */
|
|
/* https://godotengine.org */
|
|
/*************************************************************************/
|
|
/* Copyright (c) 2007-2022 Juan Linietsky, Ariel Manzur. */
|
|
/* Copyright (c) 2014-2022 Godot Engine contributors (cf. AUTHORS.md). */
|
|
/* */
|
|
/* 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. */
|
|
/*************************************************************************/
|
|
|
|
#include "keyboard.h"
|
|
|
|
#include "core/os/os.h"
|
|
|
|
struct _KeyCodeText {
|
|
Key code;
|
|
const char *text;
|
|
};
|
|
|
|
static const _KeyCodeText _keycodes[] = {
|
|
/* clang-format off */
|
|
{Key::ESCAPE ,"Escape"},
|
|
{Key::TAB ,"Tab"},
|
|
{Key::BACKTAB ,"BackTab"},
|
|
{Key::BACKSPACE ,"BackSpace"},
|
|
{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
|
|
{Key::META ,"Command"},
|
|
#else
|
|
{Key::META ,"Meta"},
|
|
#endif
|
|
{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::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 */
|
|
};
|
|
|
|
bool keycode_has_unicode(Key p_keycode) {
|
|
switch (p_keycode) {
|
|
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::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;
|
|
default: {
|
|
}
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
String keycode_get_string(Key p_code) {
|
|
String codestr;
|
|
if ((p_code & KeyModifierMask::SHIFT) != Key::NONE) {
|
|
codestr += find_keycode_name(Key::SHIFT);
|
|
codestr += "+";
|
|
}
|
|
if ((p_code & KeyModifierMask::ALT) != Key::NONE) {
|
|
codestr += find_keycode_name(Key::ALT);
|
|
codestr += "+";
|
|
}
|
|
if ((p_code & KeyModifierMask::CTRL) != Key::NONE) {
|
|
codestr += find_keycode_name(Key::CTRL);
|
|
codestr += "+";
|
|
}
|
|
if ((p_code & KeyModifierMask::META) != Key::NONE) {
|
|
codestr += find_keycode_name(Key::META);
|
|
codestr += "+";
|
|
}
|
|
|
|
p_code &= KeyModifierMask::CODE_MASK;
|
|
|
|
const _KeyCodeText *kct = &_keycodes[0];
|
|
|
|
while (kct->text) {
|
|
if (kct->code == p_code) {
|
|
codestr += kct->text;
|
|
return codestr;
|
|
}
|
|
kct++;
|
|
}
|
|
|
|
codestr += String::chr((char32_t)p_code);
|
|
|
|
return codestr;
|
|
}
|
|
|
|
Key find_keycode(const String &p_code) {
|
|
const _KeyCodeText *kct = &_keycodes[0];
|
|
|
|
while (kct->text) {
|
|
if (p_code.nocasecmp_to(kct->text) == 0) {
|
|
return kct->code;
|
|
}
|
|
kct++;
|
|
}
|
|
|
|
return Key::NONE;
|
|
}
|
|
|
|
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) {
|
|
return (int)_keycodes[p_index].code;
|
|
}
|
|
|
|
const char *keycode_get_name_by_index(int p_index) {
|
|
return _keycodes[p_index].text;
|
|
}
|