mirror of
https://github.com/JGRennison/OpenTTD-patches.git
synced 2024-10-31 15:20:10 +00:00
fd605e3cf3
# Conflicts: # .github/workflows/commit-checker.yml # src/company_cmd.cpp # src/console_cmds.cpp # src/crashlog.cpp # src/lang/english.txt # src/lang/german.txt # src/lang/indonesian.txt # src/lang/japanese.txt # src/lang/korean.txt # src/lang/swedish.txt # src/linkgraph/linkgraphjob.cpp # src/linkgraph/mcf.cpp # src/network/core/tcp.cpp # src/network/core/tcp.h # src/network/core/tcp_game.h # src/network/core/udp.h # src/network/network.cpp # src/network/network_admin.cpp # src/network/network_admin.h # src/network/network_chat_gui.cpp # src/network/network_client.cpp # src/network/network_client.h # src/network/network_func.h # src/network/network_internal.h # src/network/network_server.cpp # src/network/network_server.h # src/newgrf.cpp # src/newgrf_station.cpp # src/order_gui.cpp # src/rail_cmd.cpp # src/saveload/saveload.cpp # src/settings.cpp # src/settings_gui.cpp # src/settings_internal.h # src/settings_type.h # src/station_cmd.cpp # src/stdafx.h # src/table/currency_settings.ini # src/table/misc_settings.ini # src/table/settings.h.preamble # src/table/settings.ini # src/terraform_cmd.cpp # src/timetable_gui.cpp # src/train_cmd.cpp # src/tree_cmd.cpp # src/water_cmd.cpp
94 lines
3.7 KiB
C++
94 lines
3.7 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 console_internal.h Internally used functions for the console. */
|
|
|
|
#ifndef CONSOLE_INTERNAL_H
|
|
#define CONSOLE_INTERNAL_H
|
|
|
|
#include "gfx_type.h"
|
|
#include <map>
|
|
|
|
static const uint ICON_CMDLN_SIZE = 1024; ///< maximum length of a typed in command
|
|
static const uint ICON_MAX_STREAMSIZE = 2048; ///< maximum length of a totally expanded command
|
|
|
|
/** Return values of console hooks (#IConsoleHook). */
|
|
enum ConsoleHookResult {
|
|
CHR_ALLOW, ///< Allow command execution.
|
|
CHR_DISALLOW, ///< Disallow command execution.
|
|
CHR_HIDE, ///< Hide the existence of the command.
|
|
};
|
|
|
|
/**
|
|
* --Commands--
|
|
* Commands are commands, or functions. They get executed once and any
|
|
* effect they produce are carried out. The arguments to the commands
|
|
* are given to them, each input word separated by a double-quote (") is an argument
|
|
* If you want to handle multiple words as one, enclose them in double-quotes
|
|
* eg. 'say "hello everybody"'
|
|
*/
|
|
typedef bool IConsoleCmdProc(byte argc, char *argv[]);
|
|
typedef ConsoleHookResult IConsoleHook(bool echo);
|
|
struct IConsoleCmd {
|
|
IConsoleCmd(const std::string &name, IConsoleCmdProc *proc, IConsoleHook *hook, bool unlisted) : name(name), proc(proc), hook(hook), unlisted(unlisted) {}
|
|
|
|
std::string name; ///< name of command
|
|
IConsoleCmdProc *proc; ///< process executed when command is typed
|
|
IConsoleHook *hook; ///< any special trigger action that needs executing
|
|
bool unlisted;
|
|
};
|
|
|
|
/**
|
|
* --Aliases--
|
|
* Aliases are like shortcuts for complex functions, variable assignments,
|
|
* etc. You can use a simple alias to rename a longer command (eg 'set' for
|
|
* 'setting' for example), or concatenate more commands into one
|
|
* (eg. 'ng' for 'load %A; unpause; debug_level 5'). Aliases can parse the arguments
|
|
* given to them in the command line.
|
|
* - "%A - %Z" substitute arguments 1 t/m 26
|
|
* - "%+" lists all parameters keeping them separated
|
|
* - "%!" also lists all parameters but presenting them to the aliased command as one argument
|
|
* - ";" allows for combining commands (see example 'ng')
|
|
*/
|
|
struct IConsoleAlias {
|
|
IConsoleAlias(const std::string &name, const std::string &cmdline) : name(name), cmdline(cmdline) {}
|
|
|
|
std::string name; ///< name of the alias
|
|
std::string cmdline; ///< command(s) that is/are being aliased
|
|
};
|
|
|
|
struct IConsole
|
|
{
|
|
typedef std::map<std::string, IConsoleCmd> CommandList;
|
|
typedef std::map<std::string, IConsoleAlias> AliasList;
|
|
|
|
/* console parser */
|
|
static CommandList &Commands();
|
|
static AliasList &Aliases();
|
|
|
|
/* Commands */
|
|
static void CmdRegister(const std::string &name, IConsoleCmdProc *proc, IConsoleHook *hook = nullptr, bool unlisted = false);
|
|
static IConsoleCmd *CmdGet(const std::string &name);
|
|
static void AliasRegister(const std::string &name, const std::string &cmd);
|
|
static IConsoleAlias *AliasGet(const std::string &name);
|
|
};
|
|
|
|
/* console functions */
|
|
void IConsoleClearBuffer();
|
|
|
|
/* console std lib (register ingame commands/aliases) */
|
|
void IConsoleStdLibRegister();
|
|
|
|
/* Supporting functions */
|
|
bool GetArgumentInteger(uint32 *value, const char *arg);
|
|
|
|
void IConsoleGUIInit();
|
|
void IConsoleGUIFree();
|
|
void IConsoleGUIPrint(TextColour colour_code, char *string);
|
|
|
|
#endif /* CONSOLE_INTERNAL_H */
|