mirror of
https://github.com/JGRennison/OpenTTD-patches.git
synced 2024-11-11 13:10:45 +00:00
6c3e5642f8
# Conflicts: # cmake/CompileFlags.cmake # src/crashlog.cpp # src/fileio.cpp # src/fileio_func.h # src/fios_gui.cpp # src/ini_load.cpp # src/ini_type.h # src/lang/english.txt # src/lang/german.txt # src/lang/korean.txt # src/network/network_client.cpp # src/order_base.h # src/order_cmd.cpp # src/os/windows/win32.cpp # src/road_cmd.cpp # src/saveload/saveload.cpp # src/saveload/saveload.h # src/settings.cpp # src/station_cmd.cpp # src/stdafx.h # src/table/settings.ini # src/tree_cmd.cpp # src/tree_gui.cpp # src/vehicle_base.h # src/video/cocoa/cocoa_v.mm # src/video/cocoa/event.mm # src/video/cocoa/wnd_quartz.mm # src/viewport.cpp # src/widgets/tree_widget.h
381 lines
11 KiB
C++
381 lines
11 KiB
C++
/*
|
|
* This file is part of OpenTTD.
|
|
* OpenTTD is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2.
|
|
* OpenTTD is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
|
|
* See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
/** @file hotkeys.cpp Implementation of hotkey related functions */
|
|
|
|
#include "stdafx.h"
|
|
#include "openttd.h"
|
|
#include "hotkeys.h"
|
|
#include "ini_type.h"
|
|
#include "string_func.h"
|
|
#include "window_gui.h"
|
|
|
|
#include "safeguards.h"
|
|
|
|
std::string _hotkeys_file;
|
|
|
|
/**
|
|
* List of all HotkeyLists.
|
|
* This is a pointer to ensure initialisation order with the various static HotkeyList instances.
|
|
*/
|
|
static std::vector<HotkeyList*> *_hotkey_lists = nullptr;
|
|
|
|
/** String representation of a keycode */
|
|
struct KeycodeNames {
|
|
const char *name; ///< Name of the keycode
|
|
WindowKeyCodes keycode; ///< The keycode
|
|
};
|
|
|
|
/** Array of non-standard keycodes that can be used in the hotkeys config file. */
|
|
static const KeycodeNames _keycode_to_name[] = {
|
|
{"SHIFT", WKC_SHIFT},
|
|
{"CTRL", WKC_CTRL},
|
|
{"ALT", WKC_ALT},
|
|
{"META", WKC_META},
|
|
{"GLOBAL", WKC_GLOBAL_HOTKEY},
|
|
{"ESC", WKC_ESC},
|
|
{"BACKSPACE", WKC_BACKSPACE},
|
|
{"INS", WKC_INSERT},
|
|
{"DEL", WKC_DELETE},
|
|
{"PAGEUP", WKC_PAGEUP},
|
|
{"PAGEDOWN", WKC_PAGEDOWN},
|
|
{"END", WKC_END},
|
|
{"HOME", WKC_HOME},
|
|
{"RETURN", WKC_RETURN},
|
|
{"SPACE", WKC_SPACE},
|
|
{"F1", WKC_F1},
|
|
{"F2", WKC_F2},
|
|
{"F3", WKC_F3},
|
|
{"F4", WKC_F4},
|
|
{"F5", WKC_F5},
|
|
{"F6", WKC_F6},
|
|
{"F7", WKC_F7},
|
|
{"F8", WKC_F8},
|
|
{"F9", WKC_F9},
|
|
{"F10", WKC_F10},
|
|
{"F11", WKC_F11},
|
|
{"F12", WKC_F12},
|
|
{"BACKQUOTE", WKC_BACKQUOTE},
|
|
{"PAUSE", WKC_PAUSE},
|
|
{"NUM_DIV", WKC_NUM_DIV},
|
|
{"NUM_MUL", WKC_NUM_MUL},
|
|
{"NUM_MINUS", WKC_NUM_MINUS},
|
|
{"NUM_PLUS", WKC_NUM_PLUS},
|
|
{"NUM_ENTER", WKC_NUM_ENTER},
|
|
{"NUM_DOT", WKC_NUM_DECIMAL},
|
|
{"SLASH", WKC_SLASH},
|
|
{"/", WKC_SLASH}, /* deprecated, use SLASH */
|
|
{"SEMICOLON", WKC_SEMICOLON},
|
|
{";", WKC_SEMICOLON}, /* deprecated, use SEMICOLON */
|
|
{"EQUALS", WKC_EQUALS},
|
|
{"=", WKC_EQUALS}, /* deprecated, use EQUALS */
|
|
{"L_BRACKET", WKC_L_BRACKET},
|
|
{"[", WKC_L_BRACKET}, /* deprecated, use L_BRACKET */
|
|
{"BACKSLASH", WKC_BACKSLASH},
|
|
{"\\", WKC_BACKSLASH}, /* deprecated, use BACKSLASH */
|
|
{"R_BRACKET", WKC_R_BRACKET},
|
|
{"]", WKC_R_BRACKET}, /* deprecated, use R_BRACKET */
|
|
{"SINGLEQUOTE", WKC_SINGLEQUOTE},
|
|
{"'", WKC_SINGLEQUOTE}, /* deprecated, use SINGLEQUOTE */
|
|
{"COMMA", WKC_COMMA},
|
|
{"PERIOD", WKC_PERIOD},
|
|
{".", WKC_PERIOD}, /* deprecated, use PERIOD */
|
|
{"MINUS", WKC_MINUS},
|
|
{"-", WKC_MINUS}, /* deprecated, use MINUS */
|
|
{"HASH", WKC_HASH},
|
|
{"PAGE_UP", WKC_PAGEUP},
|
|
{"PAGE_DOWN", WKC_PAGEDOWN},
|
|
};
|
|
|
|
/**
|
|
* Try to parse a single part of a keycode.
|
|
* @param start Start of the string to parse.
|
|
* @param end End of the string to parse.
|
|
* @return A keycode if a match is found or 0.
|
|
*/
|
|
static uint16 ParseCode(const char *start, const char *end)
|
|
{
|
|
assert(start <= end);
|
|
while (start < end && *start == ' ') start++;
|
|
while (end > start && *end == ' ') end--;
|
|
for (uint i = 0; i < lengthof(_keycode_to_name); i++) {
|
|
if (strlen(_keycode_to_name[i].name) == (size_t)(end - start) && strncasecmp(start, _keycode_to_name[i].name, end - start) == 0) {
|
|
return _keycode_to_name[i].keycode;
|
|
}
|
|
}
|
|
if (end - start == 1) {
|
|
if (*start >= 'a' && *start <= 'z') return *start - ('a'-'A');
|
|
/* Ignore invalid keycodes */
|
|
if (*(const uint8 *)start < 128) return *start;
|
|
}
|
|
return 0;
|
|
}
|
|
|
|
/**
|
|
* Parse a string representation of a keycode.
|
|
* @param start Start of the input.
|
|
* @param end End of the input.
|
|
* @return A valid keycode or 0.
|
|
*/
|
|
static uint16 ParseKeycode(const char *start, const char *end)
|
|
{
|
|
assert(start <= end);
|
|
uint16 keycode = 0;
|
|
for (;;) {
|
|
const char *cur = start;
|
|
while (*cur != '+' && cur != end) cur++;
|
|
uint16 code = ParseCode(start, cur);
|
|
if (code == 0) return 0;
|
|
if (code & WKC_SPECIAL_KEYS) {
|
|
/* Some completely wrong keycode we don't support. */
|
|
if (code & ~WKC_SPECIAL_KEYS) return 0;
|
|
keycode |= code;
|
|
} else {
|
|
/* Ignore the code if it has more then 1 letter. */
|
|
if (keycode & ~WKC_SPECIAL_KEYS) return 0;
|
|
keycode |= code;
|
|
}
|
|
if (cur == end) break;
|
|
assert(cur < end);
|
|
start = cur + 1;
|
|
}
|
|
return keycode;
|
|
}
|
|
|
|
/**
|
|
* Parse a string to the keycodes it represents
|
|
* @param hotkey The hotkey object to add the keycodes to
|
|
* @param value The string to parse
|
|
*/
|
|
static void ParseHotkeys(Hotkey *hotkey, const char *value)
|
|
{
|
|
const char *start = value;
|
|
while (*start != '\0') {
|
|
const char *end = start;
|
|
while (*end != '\0' && *end != ',') end++;
|
|
uint16 keycode = ParseKeycode(start, end);
|
|
if (keycode != 0) hotkey->AddKeycode(keycode);
|
|
start = (*end == ',') ? end + 1: end;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Convert a hotkey to it's string representation so it can be written to the
|
|
* config file. Separate parts of the keycode (like "CTRL" and "F1" are split
|
|
* by a '+'.
|
|
* @param keycode The keycode to convert to a string.
|
|
* @return A string representation of this keycode.
|
|
* @note The return value is a static buffer, stredup the result before calling
|
|
* this function again.
|
|
*/
|
|
static const char *KeycodeToString(uint16 keycode)
|
|
{
|
|
static char buf[32];
|
|
buf[0] = '\0';
|
|
bool first = true;
|
|
if (keycode & WKC_GLOBAL_HOTKEY) {
|
|
strecat(buf, "GLOBAL", lastof(buf));
|
|
first = false;
|
|
}
|
|
if (keycode & WKC_SHIFT) {
|
|
if (!first) strecat(buf, "+", lastof(buf));
|
|
strecat(buf, "SHIFT", lastof(buf));
|
|
first = false;
|
|
}
|
|
if (keycode & WKC_CTRL) {
|
|
if (!first) strecat(buf, "+", lastof(buf));
|
|
strecat(buf, "CTRL", lastof(buf));
|
|
first = false;
|
|
}
|
|
if (keycode & WKC_ALT) {
|
|
if (!first) strecat(buf, "+", lastof(buf));
|
|
strecat(buf, "ALT", lastof(buf));
|
|
first = false;
|
|
}
|
|
if (keycode & WKC_META) {
|
|
if (!first) strecat(buf, "+", lastof(buf));
|
|
strecat(buf, "META", lastof(buf));
|
|
first = false;
|
|
}
|
|
if (!first) strecat(buf, "+", lastof(buf));
|
|
keycode = keycode & ~WKC_SPECIAL_KEYS;
|
|
|
|
for (uint i = 0; i < lengthof(_keycode_to_name); i++) {
|
|
if (_keycode_to_name[i].keycode == keycode) {
|
|
strecat(buf, _keycode_to_name[i].name, lastof(buf));
|
|
return buf;
|
|
}
|
|
}
|
|
assert(keycode < 128);
|
|
char key[2];
|
|
key[0] = keycode;
|
|
key[1] = '\0';
|
|
strecat(buf, key, lastof(buf));
|
|
return buf;
|
|
}
|
|
|
|
/**
|
|
* Convert all keycodes attached to a hotkey to a single string. If multiple
|
|
* keycodes are attached to the hotkey they are split by a comma.
|
|
* @param hotkey The keycodes of this hotkey need to be converted to a string.
|
|
* @return A string representation of all keycodes.
|
|
* @note The return value is a static buffer, stredup the result before calling
|
|
* this function again.
|
|
*/
|
|
const char *SaveKeycodes(const Hotkey *hotkey)
|
|
{
|
|
static char buf[128];
|
|
buf[0] = '\0';
|
|
for (uint i = 0; i < hotkey->keycodes.size(); i++) {
|
|
const char *str = KeycodeToString(hotkey->keycodes[i]);
|
|
if (i > 0) strecat(buf, ",", lastof(buf));
|
|
strecat(buf, str, lastof(buf));
|
|
}
|
|
return buf;
|
|
}
|
|
|
|
/**
|
|
* Create a new Hotkey object with a single default keycode.
|
|
* @param default_keycode The default keycode for this hotkey.
|
|
* @param name The name of this hotkey.
|
|
* @param num Number of this hotkey, should be unique within the hotkey list.
|
|
*/
|
|
Hotkey::Hotkey(uint16 default_keycode, const char *name, int num) :
|
|
name(name),
|
|
num(num)
|
|
{
|
|
if (default_keycode != 0) this->AddKeycode(default_keycode);
|
|
}
|
|
|
|
/**
|
|
* Create a new Hotkey object with multiple default keycodes.
|
|
* @param default_keycodes An array of default keycodes terminated with 0.
|
|
* @param name The name of this hotkey.
|
|
* @param num Number of this hotkey, should be unique within the hotkey list.
|
|
*/
|
|
Hotkey::Hotkey(const uint16 *default_keycodes, const char *name, int num) :
|
|
name(name),
|
|
num(num)
|
|
{
|
|
const uint16 *keycode = default_keycodes;
|
|
while (*keycode != 0) {
|
|
this->AddKeycode(*keycode);
|
|
keycode++;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Add a keycode to this hotkey, from now that keycode will be matched
|
|
* in addition to any previously added keycodes.
|
|
* @param keycode The keycode to add.
|
|
*/
|
|
void Hotkey::AddKeycode(uint16 keycode)
|
|
{
|
|
include(this->keycodes, keycode);
|
|
}
|
|
|
|
HotkeyList::HotkeyList(const char *ini_group, Hotkey *items, GlobalHotkeyHandlerFunc global_hotkey_handler) :
|
|
global_hotkey_handler(global_hotkey_handler), ini_group(ini_group), items(items)
|
|
{
|
|
if (_hotkey_lists == nullptr) _hotkey_lists = new std::vector<HotkeyList*>();
|
|
_hotkey_lists->push_back(this);
|
|
}
|
|
|
|
HotkeyList::~HotkeyList()
|
|
{
|
|
_hotkey_lists->erase(std::find(_hotkey_lists->begin(), _hotkey_lists->end(), this));
|
|
}
|
|
|
|
/**
|
|
* Load HotkeyList from IniFile.
|
|
* @param ini IniFile to load from.
|
|
*/
|
|
void HotkeyList::Load(IniFile *ini)
|
|
{
|
|
IniGroup *group = ini->GetGroup(this->ini_group);
|
|
for (Hotkey *hotkey = this->items; hotkey->name != nullptr; ++hotkey) {
|
|
IniItem *item = group->GetItem(hotkey->name, false);
|
|
if (item != nullptr) {
|
|
hotkey->keycodes.clear();
|
|
if (item->value.has_value()) ParseHotkeys(hotkey, item->value->c_str());
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Save HotkeyList to IniFile.
|
|
* @param ini IniFile to save to.
|
|
*/
|
|
void HotkeyList::Save(IniFile *ini) const
|
|
{
|
|
IniGroup *group = ini->GetGroup(this->ini_group);
|
|
for (const Hotkey *hotkey = this->items; hotkey->name != nullptr; ++hotkey) {
|
|
IniItem *item = group->GetItem(hotkey->name, true);
|
|
item->SetValue(SaveKeycodes(hotkey));
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Check if a keycode is bound to something.
|
|
* @param keycode The keycode that was pressed
|
|
* @param global_only Limit the search to hotkeys defined as 'global'.
|
|
* @return The number of the matching hotkey or -1.
|
|
*/
|
|
int HotkeyList::CheckMatch(uint16 keycode, bool global_only) const
|
|
{
|
|
for (const Hotkey *list = this->items; list->name != nullptr; ++list) {
|
|
auto begin = list->keycodes.begin();
|
|
auto end = list->keycodes.end();
|
|
if (std::find(begin, end, keycode | WKC_GLOBAL_HOTKEY) != end || (!global_only && std::find(begin, end, keycode) != end)) {
|
|
return list->num;
|
|
}
|
|
}
|
|
return -1;
|
|
}
|
|
|
|
|
|
static void SaveLoadHotkeys(bool save)
|
|
{
|
|
IniFile *ini = new IniFile();
|
|
ini->LoadFromDisk(_hotkeys_file, NO_DIRECTORY);
|
|
|
|
for (HotkeyList *list : *_hotkey_lists) {
|
|
if (save) {
|
|
list->Save(ini);
|
|
} else {
|
|
list->Load(ini);
|
|
}
|
|
}
|
|
|
|
if (save) ini->SaveToDisk(_hotkeys_file);
|
|
delete ini;
|
|
}
|
|
|
|
|
|
/** Load the hotkeys from the config file */
|
|
void LoadHotkeysFromConfig()
|
|
{
|
|
SaveLoadHotkeys(false);
|
|
}
|
|
|
|
/** Save the hotkeys to the config file */
|
|
void SaveHotkeysToConfig()
|
|
{
|
|
SaveLoadHotkeys(true);
|
|
}
|
|
|
|
void HandleGlobalHotkeys(WChar key, uint16 keycode)
|
|
{
|
|
for (HotkeyList *list : *_hotkey_lists) {
|
|
if (list->global_hotkey_handler == nullptr) continue;
|
|
|
|
int hotkey = list->CheckMatch(keycode, true);
|
|
if (hotkey >= 0 && (list->global_hotkey_handler(hotkey) == ES_HANDLED)) return;
|
|
}
|
|
}
|
|
|