godot/platform/macos/key_mapping_macos.mm
bruvzg daad4aed62
Cleanup and unify keyboard input.
- Unify keycode values (secondary label printed on a key), remove unused hardcoded Latin-1 codes.
- Unify IME behaviour, add inline composition string display on Windows and X11.
- Add key_label (localized label printed on a key) value to the key events, and allow mapping actions to the unshifted Unicode events.
- Add support for physical keyboard (Bluetooth or Sidecar) handling on iOS.
- Add support for media key handling on macOS.

Co-authored-by: Raul Santos <raulsntos@gmail.com>
2023-01-23 15:08:12 +02:00

426 lines
15 KiB
Plaintext

/**************************************************************************/
/* key_mapping_macos.mm */
/**************************************************************************/
/* This file is part of: */
/* GODOT ENGINE */
/* https://godotengine.org */
/**************************************************************************/
/* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */
/* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */
/* */
/* 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 "key_mapping_macos.h"
#import <Carbon/Carbon.h>
#import <Cocoa/Cocoa.h>
#include "core/templates/hash_map.h"
#include "core/templates/hash_set.h"
struct HashMapHasherKeys {
static _FORCE_INLINE_ uint32_t hash(const Key p_key) { return hash_fmix32(static_cast<uint32_t>(p_key)); }
static _FORCE_INLINE_ uint32_t hash(const char32_t p_uchar) { return hash_fmix32(p_uchar); }
static _FORCE_INLINE_ uint32_t hash(const unsigned p_key) { return hash_fmix32(p_key); }
};
HashSet<unsigned int> numpad_keys;
HashMap<unsigned int, Key, HashMapHasherKeys> keysym_map;
HashMap<Key, unsigned int, HashMapHasherKeys> keysym_map_inv;
HashMap<Key, char32_t, HashMapHasherKeys> keycode_map;
void KeyMappingMacOS::initialize() {
numpad_keys.insert(0x41); //kVK_ANSI_KeypadDecimal
numpad_keys.insert(0x43); //kVK_ANSI_KeypadMultiply
numpad_keys.insert(0x45); //kVK_ANSI_KeypadPlus
numpad_keys.insert(0x47); //kVK_ANSI_KeypadClear
numpad_keys.insert(0x4b); //kVK_ANSI_KeypadDivide
numpad_keys.insert(0x4c); //kVK_ANSI_KeypadEnter
numpad_keys.insert(0x4e); //kVK_ANSI_KeypadMinus
numpad_keys.insert(0x51); //kVK_ANSI_KeypadEquals
numpad_keys.insert(0x52); //kVK_ANSI_Keypad0
numpad_keys.insert(0x53); //kVK_ANSI_Keypad1
numpad_keys.insert(0x54); //kVK_ANSI_Keypad2
numpad_keys.insert(0x55); //kVK_ANSI_Keypad3
numpad_keys.insert(0x56); //kVK_ANSI_Keypad4
numpad_keys.insert(0x57); //kVK_ANSI_Keypad5
numpad_keys.insert(0x58); //kVK_ANSI_Keypad6
numpad_keys.insert(0x59); //kVK_ANSI_Keypad7
numpad_keys.insert(0x5b); //kVK_ANSI_Keypad8
numpad_keys.insert(0x5c); //kVK_ANSI_Keypad9
numpad_keys.insert(0x5f); //kVK_JIS_KeypadComma
keysym_map[0x00] = Key::A;
keysym_map[0x01] = Key::S;
keysym_map[0x02] = Key::D;
keysym_map[0x03] = Key::F;
keysym_map[0x04] = Key::H;
keysym_map[0x05] = Key::G;
keysym_map[0x06] = Key::Z;
keysym_map[0x07] = Key::X;
keysym_map[0x08] = Key::C;
keysym_map[0x09] = Key::V;
keysym_map[0x0a] = Key::SECTION;
keysym_map[0x0b] = Key::B;
keysym_map[0x0c] = Key::Q;
keysym_map[0x0d] = Key::W;
keysym_map[0x0e] = Key::E;
keysym_map[0x0f] = Key::R;
keysym_map[0x10] = Key::Y;
keysym_map[0x11] = Key::T;
keysym_map[0x12] = Key::KEY_1;
keysym_map[0x13] = Key::KEY_2;
keysym_map[0x14] = Key::KEY_3;
keysym_map[0x15] = Key::KEY_4;
keysym_map[0x16] = Key::KEY_6;
keysym_map[0x17] = Key::KEY_5;
keysym_map[0x18] = Key::EQUAL;
keysym_map[0x19] = Key::KEY_9;
keysym_map[0x1a] = Key::KEY_7;
keysym_map[0x1b] = Key::MINUS;
keysym_map[0x1c] = Key::KEY_8;
keysym_map[0x1d] = Key::KEY_0;
keysym_map[0x1e] = Key::BRACERIGHT;
keysym_map[0x1f] = Key::O;
keysym_map[0x20] = Key::U;
keysym_map[0x21] = Key::BRACELEFT;
keysym_map[0x22] = Key::I;
keysym_map[0x23] = Key::P;
keysym_map[0x24] = Key::ENTER;
keysym_map[0x25] = Key::L;
keysym_map[0x26] = Key::J;
keysym_map[0x27] = Key::APOSTROPHE;
keysym_map[0x28] = Key::K;
keysym_map[0x29] = Key::SEMICOLON;
keysym_map[0x2a] = Key::BACKSLASH;
keysym_map[0x2b] = Key::COMMA;
keysym_map[0x2c] = Key::SLASH;
keysym_map[0x2d] = Key::N;
keysym_map[0x2e] = Key::M;
keysym_map[0x2f] = Key::PERIOD;
keysym_map[0x30] = Key::TAB;
keysym_map[0x31] = Key::SPACE;
keysym_map[0x32] = Key::QUOTELEFT;
keysym_map[0x33] = Key::BACKSPACE;
keysym_map[0x35] = Key::ESCAPE;
keysym_map[0x36] = Key::META;
keysym_map[0x37] = Key::META;
keysym_map[0x38] = Key::SHIFT;
keysym_map[0x39] = Key::CAPSLOCK;
keysym_map[0x3a] = Key::ALT;
keysym_map[0x3b] = Key::CTRL;
keysym_map[0x3c] = Key::SHIFT;
keysym_map[0x3d] = Key::ALT;
keysym_map[0x3e] = Key::CTRL;
keysym_map[0x40] = Key::F17;
keysym_map[0x41] = Key::KP_PERIOD;
keysym_map[0x43] = Key::KP_MULTIPLY;
keysym_map[0x45] = Key::KP_ADD;
keysym_map[0x47] = Key::NUMLOCK;
keysym_map[0x48] = Key::VOLUMEUP;
keysym_map[0x49] = Key::VOLUMEDOWN;
keysym_map[0x4a] = Key::VOLUMEMUTE;
keysym_map[0x4b] = Key::KP_DIVIDE;
keysym_map[0x4c] = Key::KP_ENTER;
keysym_map[0x4e] = Key::KP_SUBTRACT;
keysym_map[0x4f] = Key::F18;
keysym_map[0x50] = Key::F19;
keysym_map[0x51] = Key::EQUAL;
keysym_map[0x52] = Key::KP_0;
keysym_map[0x53] = Key::KP_1;
keysym_map[0x54] = Key::KP_2;
keysym_map[0x55] = Key::KP_3;
keysym_map[0x56] = Key::KP_4;
keysym_map[0x57] = Key::KP_5;
keysym_map[0x58] = Key::KP_6;
keysym_map[0x59] = Key::KP_7;
keysym_map[0x5a] = Key::F20;
keysym_map[0x5b] = Key::KP_8;
keysym_map[0x5c] = Key::KP_9;
keysym_map[0x5d] = Key::YEN;
keysym_map[0x5e] = Key::UNDERSCORE;
keysym_map[0x5f] = Key::COMMA;
keysym_map[0x60] = Key::F5;
keysym_map[0x61] = Key::F6;
keysym_map[0x62] = Key::F7;
keysym_map[0x63] = Key::F3;
keysym_map[0x64] = Key::F8;
keysym_map[0x65] = Key::F9;
keysym_map[0x66] = Key::JIS_EISU;
keysym_map[0x67] = Key::F11;
keysym_map[0x68] = Key::JIS_KANA;
keysym_map[0x69] = Key::F13;
keysym_map[0x6a] = Key::F16;
keysym_map[0x6b] = Key::F14;
keysym_map[0x6d] = Key::F10;
keysym_map[0x6e] = Key::MENU;
keysym_map[0x6f] = Key::F12;
keysym_map[0x71] = Key::F15;
keysym_map[0x72] = Key::INSERT;
keysym_map[0x73] = Key::HOME;
keysym_map[0x74] = Key::PAGEUP;
keysym_map[0x75] = Key::KEY_DELETE;
keysym_map[0x76] = Key::F4;
keysym_map[0x77] = Key::END;
keysym_map[0x78] = Key::F2;
keysym_map[0x79] = Key::PAGEDOWN;
keysym_map[0x7a] = Key::F1;
keysym_map[0x7b] = Key::LEFT;
keysym_map[0x7c] = Key::RIGHT;
keysym_map[0x7d] = Key::DOWN;
keysym_map[0x7e] = Key::UP;
for (const KeyValue<unsigned int, Key> &E : keysym_map) {
keysym_map_inv[E.value] = E.key;
}
keycode_map[Key::ESCAPE] = 0x001B;
keycode_map[Key::TAB] = 0x0009;
keycode_map[Key::BACKTAB] = 0x007F;
keycode_map[Key::BACKSPACE] = 0x0008;
keycode_map[Key::ENTER] = 0x000D;
keycode_map[Key::INSERT] = NSInsertFunctionKey;
keycode_map[Key::KEY_DELETE] = 0x007F;
keycode_map[Key::PAUSE] = NSPauseFunctionKey;
keycode_map[Key::PRINT] = NSPrintScreenFunctionKey;
keycode_map[Key::SYSREQ] = NSSysReqFunctionKey;
keycode_map[Key::CLEAR] = NSClearLineFunctionKey;
keycode_map[Key::HOME] = 0x2196;
keycode_map[Key::END] = 0x2198;
keycode_map[Key::LEFT] = 0x001C;
keycode_map[Key::UP] = 0x001E;
keycode_map[Key::RIGHT] = 0x001D;
keycode_map[Key::DOWN] = 0x001F;
keycode_map[Key::PAGEUP] = 0x21DE;
keycode_map[Key::PAGEDOWN] = 0x21DF;
keycode_map[Key::NUMLOCK] = NSClearLineFunctionKey;
keycode_map[Key::SCROLLLOCK] = NSScrollLockFunctionKey;
keycode_map[Key::F1] = NSF1FunctionKey;
keycode_map[Key::F2] = NSF2FunctionKey;
keycode_map[Key::F3] = NSF3FunctionKey;
keycode_map[Key::F4] = NSF4FunctionKey;
keycode_map[Key::F5] = NSF5FunctionKey;
keycode_map[Key::F6] = NSF6FunctionKey;
keycode_map[Key::F7] = NSF7FunctionKey;
keycode_map[Key::F8] = NSF8FunctionKey;
keycode_map[Key::F9] = NSF9FunctionKey;
keycode_map[Key::F10] = NSF10FunctionKey;
keycode_map[Key::F11] = NSF11FunctionKey;
keycode_map[Key::F12] = NSF12FunctionKey;
keycode_map[Key::F13] = NSF13FunctionKey;
keycode_map[Key::F14] = NSF14FunctionKey;
keycode_map[Key::F15] = NSF15FunctionKey;
keycode_map[Key::F16] = NSF16FunctionKey;
keycode_map[Key::F17] = NSF17FunctionKey;
keycode_map[Key::F18] = NSF18FunctionKey;
keycode_map[Key::F19] = NSF19FunctionKey;
keycode_map[Key::F20] = NSF20FunctionKey;
keycode_map[Key::F21] = NSF21FunctionKey;
keycode_map[Key::F22] = NSF22FunctionKey;
keycode_map[Key::F23] = NSF23FunctionKey;
keycode_map[Key::F24] = NSF24FunctionKey;
keycode_map[Key::F25] = NSF25FunctionKey;
keycode_map[Key::F26] = NSF26FunctionKey;
keycode_map[Key::F27] = NSF27FunctionKey;
keycode_map[Key::F28] = NSF28FunctionKey;
keycode_map[Key::F29] = NSF29FunctionKey;
keycode_map[Key::F30] = NSF30FunctionKey;
keycode_map[Key::F31] = NSF31FunctionKey;
keycode_map[Key::F32] = NSF32FunctionKey;
keycode_map[Key::F33] = NSF33FunctionKey;
keycode_map[Key::F34] = NSF34FunctionKey;
keycode_map[Key::F35] = NSF35FunctionKey;
keycode_map[Key::MENU] = NSMenuFunctionKey;
keycode_map[Key::HELP] = NSHelpFunctionKey;
keycode_map[Key::STOP] = NSStopFunctionKey;
keycode_map[Key::LAUNCH0] = NSUserFunctionKey;
keycode_map[Key::SPACE] = 0x0020;
keycode_map[Key::EXCLAM] = '!';
keycode_map[Key::QUOTEDBL] = '\"';
keycode_map[Key::NUMBERSIGN] = '#';
keycode_map[Key::DOLLAR] = '$';
keycode_map[Key::PERCENT] = '\%';
keycode_map[Key::AMPERSAND] = '&';
keycode_map[Key::APOSTROPHE] = '\'';
keycode_map[Key::PARENLEFT] = '(';
keycode_map[Key::PARENRIGHT] = ')';
keycode_map[Key::ASTERISK] = '*';
keycode_map[Key::PLUS] = '+';
keycode_map[Key::COMMA] = ',';
keycode_map[Key::MINUS] = '-';
keycode_map[Key::PERIOD] = '.';
keycode_map[Key::SLASH] = '/';
keycode_map[Key::KEY_0] = '0';
keycode_map[Key::KEY_1] = '1';
keycode_map[Key::KEY_2] = '2';
keycode_map[Key::KEY_3] = '3';
keycode_map[Key::KEY_4] = '4';
keycode_map[Key::KEY_5] = '5';
keycode_map[Key::KEY_6] = '6';
keycode_map[Key::KEY_7] = '7';
keycode_map[Key::KEY_8] = '8';
keycode_map[Key::KEY_9] = '9';
keycode_map[Key::COLON] = ':';
keycode_map[Key::SEMICOLON] = ';';
keycode_map[Key::LESS] = '<';
keycode_map[Key::EQUAL] = '=';
keycode_map[Key::GREATER] = '>';
keycode_map[Key::QUESTION] = '?';
keycode_map[Key::AT] = '@';
keycode_map[Key::A] = 'a';
keycode_map[Key::B] = 'b';
keycode_map[Key::C] = 'c';
keycode_map[Key::D] = 'd';
keycode_map[Key::E] = 'e';
keycode_map[Key::F] = 'f';
keycode_map[Key::G] = 'g';
keycode_map[Key::H] = 'h';
keycode_map[Key::I] = 'i';
keycode_map[Key::J] = 'j';
keycode_map[Key::K] = 'k';
keycode_map[Key::L] = 'l';
keycode_map[Key::M] = 'm';
keycode_map[Key::N] = 'n';
keycode_map[Key::O] = 'o';
keycode_map[Key::P] = 'p';
keycode_map[Key::Q] = 'q';
keycode_map[Key::R] = 'r';
keycode_map[Key::S] = 's';
keycode_map[Key::T] = 't';
keycode_map[Key::U] = 'u';
keycode_map[Key::V] = 'v';
keycode_map[Key::W] = 'w';
keycode_map[Key::X] = 'x';
keycode_map[Key::Y] = 'y';
keycode_map[Key::Z] = 'z';
keycode_map[Key::BRACKETLEFT] = '[';
keycode_map[Key::BACKSLASH] = '\\';
keycode_map[Key::BRACKETRIGHT] = ']';
keycode_map[Key::ASCIICIRCUM] = '^';
keycode_map[Key::UNDERSCORE] = '_';
keycode_map[Key::QUOTELEFT] = '`';
keycode_map[Key::BRACELEFT] = '{';
keycode_map[Key::BAR] = '|';
keycode_map[Key::BRACERIGHT] = '}';
keycode_map[Key::ASCIITILDE] = '~';
}
bool KeyMappingMacOS::is_numpad_key(unsigned int p_key) {
return numpad_keys.has(p_key);
}
// Translates a OS X keycode to a Godot keycode.
Key KeyMappingMacOS::translate_key(unsigned int p_key) {
const Key *key = keysym_map.getptr(p_key);
if (key) {
return *key;
}
return Key::NONE;
}
// Translates a Godot keycode back to a macOS keycode.
unsigned int KeyMappingMacOS::unmap_key(Key p_key) {
const unsigned int *key = keysym_map_inv.getptr(p_key);
if (key) {
return *key;
}
return 127;
}
// Remap key according to current keyboard layout.
Key KeyMappingMacOS::remap_key(unsigned int p_key, unsigned int p_state, bool p_unicode) {
if (is_numpad_key(p_key)) {
return translate_key(p_key);
}
TISInputSourceRef current_keyboard = TISCopyCurrentKeyboardInputSource();
if (!current_keyboard) {
return translate_key(p_key);
}
CFDataRef layout_data = (CFDataRef)TISGetInputSourceProperty(current_keyboard, kTISPropertyUnicodeKeyLayoutData);
if (!layout_data) {
return translate_key(p_key);
}
const UCKeyboardLayout *keyboard_layout = (const UCKeyboardLayout *)CFDataGetBytePtr(layout_data);
String keysym;
UInt32 keys_down = 0;
UniChar chars[256] = {};
UniCharCount real_length = 0;
OSStatus err = UCKeyTranslate(keyboard_layout,
p_key,
kUCKeyActionDisplay,
(p_unicode) ? 0 : (p_state >> 8) & 0xFF,
LMGetKbdType(),
kUCKeyTranslateNoDeadKeysBit,
&keys_down,
sizeof(chars) / sizeof(chars[0]),
&real_length,
chars);
if (err != noErr) {
return translate_key(p_key);
}
keysym = String::utf16((char16_t *)chars, real_length);
if (keysym.is_empty()) {
return translate_key(p_key);
}
char32_t c = keysym[0];
if (p_unicode) {
return fix_key_label(c, translate_key(p_key));
} else {
return fix_keycode(c, translate_key(p_key));
}
}
String KeyMappingMacOS::keycode_get_native_string(Key p_keycode) {
const char32_t *key = keycode_map.getptr(p_keycode);
if (key) {
return String::chr(*key);
}
return String();
}
unsigned int KeyMappingMacOS::keycode_get_native_mask(Key p_keycode) {
unsigned int mask = 0;
if ((p_keycode & KeyModifierMask::CTRL) != Key::NONE) {
mask |= NSEventModifierFlagControl;
}
if ((p_keycode & KeyModifierMask::ALT) != Key::NONE) {
mask |= NSEventModifierFlagOption;
}
if ((p_keycode & KeyModifierMask::SHIFT) != Key::NONE) {
mask |= NSEventModifierFlagShift;
}
if ((p_keycode & KeyModifierMask::META) != Key::NONE) {
mask |= NSEventModifierFlagCommand;
}
if ((p_keycode & KeyModifierMask::KPAD) != Key::NONE) {
mask |= NSEventModifierFlagNumericPad;
}
return mask;
}