1

/* $Id$ */

     2

     3

/** @file command_type.h Types related to commands. */

     4

     5

#ifndef COMMAND_TYPE_H

     6

#define COMMAND_TYPE_H

     7

     8

#include "economy_type.h"

     9

#include "strings_type.h"

    10

#include "tile_type.h"

    11

    12

/**

    13

 * Common return value for all commands. Wraps the cost and

    14

 * a possible error message/state together.

    15

 */

    16

class CommandCost {

    17

	ExpensesType expense_type; ///< the type of expence as shown on the finances view

    18

	Money cost;       ///< The cost of this action

    19

	StringID message; ///< Warning message for when success is unset

    20

	bool success;     ///< Whether the comment went fine up to this moment

    21

    22

public:

    23

	/**

    24

	 * Creates a command cost return with no cost and no error

    25

	 */

    26

	CommandCost() : expense_type(INVALID_EXPENSES), cost(0), message(INVALID_STRING_ID), success(true) {}

    27

    28

	/**

    29

	 * Creates a command return value the is failed with the given message

    30

	 */

    31

	CommandCost(StringID msg) : expense_type(INVALID_EXPENSES), cost(0), message(msg), success(false) {}

    32

    33

	/**

    34

	 * Creates a command cost with given expense type and start cost of 0

    35

	 * @param ex_t the expense type

    36

	 */

    37

	CommandCost(ExpensesType ex_t) : expense_type(ex_t), cost(0), message(INVALID_STRING_ID), success(true) {}

    38

    39

	/**

    40

	 * Creates a command return value with the given start cost and expense type

    41

	 * @param ex_t the expense type

    42

	 * @param cst the initial cost of this command

    43

	 */

    44

	CommandCost(ExpensesType ex_t, Money cst) : expense_type(ex_t), cost(cst), message(INVALID_STRING_ID), success(true) {}

    45

    46

	/**

    47

	 * Adds the cost of the given command return value to this cost.

    48

	 * Also takes a possible error message when it is set.

    49

	 * @param ret the command to add the cost of.

    50

	 * @return this class.

    51

	 */

    52

	CommandCost AddCost(CommandCost ret);

    53

    54

	/**

    55

	 * Adds the given cost to the cost of the command.

    56

	 * @param cost the cost to add

    57

	 * @return this class.

    58

	 */

    59

	CommandCost AddCost(Money cost)

    60

	{

    61

		this->cost += cost;

    62

		return *this;

    63

	}

    64

    65

	/**

    66

	 * Multiplies the cost of the command by the given factor.

    67

	 * @param factor factor to multiply the costs with

    68

	 * @return this class

    69

	 */

    70

	CommandCost MultiplyCost(int factor)

    71

	{

    72

		this->cost *= factor;

    73

		return *this;

    74

	}

    75

    76

	/**

    77

	 * The costs as made up to this moment

    78

	 * @return the costs

    79

	 */

    80

	Money GetCost() const

    81

	{

    82

		return this->cost;

    83

	}

    84

    85

	/**

    86

	 * The expense type of the cost

    87

	 * @return the expense type

    88

	 */

    89

	ExpensesType GetExpensesType() const

    90

	{

    91

		return this->expense_type;

    92

	}

    93

    94

	/**

    95

	 * Sets the global error message *if* this class has one.

    96

	 */

    97

	void SetGlobalErrorMessage() const

    98

	{

    99

		extern StringID _error_message;

   100

		if (this->message != INVALID_STRING_ID) _error_message = this->message;

   101

	}

   102

   103

	/**

   104

	 * Returns the error message of a command

   105

	 * @return the error message, if succeeded INVALID_STRING_ID

   106

	 */

   107

	StringID GetErrorMessage() const

   108

	{

   109

		extern StringID _error_message;

   110

   111

		if (this->success) return INVALID_STRING_ID;

   112

		if (this->message != INVALID_STRING_ID) return this->message;

   113

		return _error_message;

   114

	}

   115

   116

	/**

   117

	 * Did this command succeed?

   118

	 * @return true if and only if it succeeded

   119

	 */

   120

	bool Succeeded() const

   121

	{

   122

		return this->success;

   123

	}

   124

   125

	/**

   126

	 * Did this command fail?

   127

	 * @return true if and only if it failed

   128

	 */

   129

	bool Failed() const

   130

	{

   131

		return !this->success;

   132

	}

   133

};

   134

   135

/**

   136

 * List of commands.

   137

 *

   138

 * This enum defines all possible commands which can be executed to the game

   139

 * engine. Observing the game like the query-tool or checking the profit of a

   140

 * vehicle don't result in a command which should be executed in the engine

   141

 * nor send to the server in a network game.

   142

 *

   143

 * @see _command_proc_table

   144

 */

   145

enum {

   146

	CMD_BUILD_RAILROAD_TRACK,         ///< build a rail track

   147

	CMD_REMOVE_RAILROAD_TRACK,        ///< remove a rail track

   148

	CMD_BUILD_SINGLE_RAIL,            ///< build a single rail track

   149

	CMD_REMOVE_SINGLE_RAIL,           ///< remove a single rail track

   150

	CMD_LANDSCAPE_CLEAR,              ///< demolish a tile

   151

	CMD_BUILD_BRIDGE,                 ///< build a bridge

   152

	CMD_BUILD_RAILROAD_STATION,       ///< build a railroad station

   153

	CMD_BUILD_TRAIN_DEPOT,            ///< build a train depot

   154

	CMD_BUILD_SIGNALS,                ///< build a signal

   155

	CMD_REMOVE_SIGNALS,               ///< remove a signal

   156

	CMD_TERRAFORM_LAND,               ///< terraform a tile

   157

	CMD_PURCHASE_LAND_AREA,           ///< purchase a tile

   158

	CMD_SELL_LAND_AREA,               ///< sell a bought tile before

   159

	CMD_BUILD_TUNNEL,                 ///< build a tunnel

   160

   161

	CMD_REMOVE_FROM_RAILROAD_STATION, ///< remove a tile station

   162

	CMD_CONVERT_RAIL,                 ///< convert a rail type

   163

   164

	CMD_BUILD_TRAIN_WAYPOINT,         ///< build a waypoint

   165

	CMD_RENAME_WAYPOINT,              ///< rename a waypoint

   166

	CMD_REMOVE_TRAIN_WAYPOINT,        ///< remove a waypoint

   167

   168

	CMD_BUILD_ROAD_STOP,              ///< build a road stop

   169

	CMD_REMOVE_ROAD_STOP,             ///< remove a road stop

   170

	CMD_BUILD_LONG_ROAD,              ///< build a complete road (not a "half" one)

   171

	CMD_REMOVE_LONG_ROAD,             ///< remove a complete road (not a "half" one)

   172

	CMD_BUILD_ROAD,                   ///< build a "half" road

   173

	CMD_REMOVE_ROAD,                  ///< remove a "half" road

   174

	CMD_BUILD_ROAD_DEPOT,             ///< build a road depot

   175

   176

	CMD_BUILD_AIRPORT,                ///< build an airport

   177

   178

	CMD_BUILD_DOCK,                   ///< build a dock

   179

   180

	CMD_BUILD_SHIP_DEPOT,             ///< build a ship depot

   181

	CMD_BUILD_BUOY,                   ///< build a buoy

   182

   183

	CMD_PLANT_TREE,                   ///< plant a tree

   184

   185

	CMD_BUILD_RAIL_VEHICLE,           ///< build a rail vehicle

   186

	CMD_MOVE_RAIL_VEHICLE,            ///< move a rail vehicle (in the depot)

   187

   188

	CMD_SELL_RAIL_WAGON,              ///< sell a rail wagon

   189

   190

	CMD_SEND_TRAIN_TO_DEPOT,          ///< send a train to a depot

   191

	CMD_FORCE_TRAIN_PROCEED,          ///< proceed a train to pass a red signal

   192

	CMD_REVERSE_TRAIN_DIRECTION,      ///< turn a train around

   193

   194

	CMD_MODIFY_ORDER,                 ///< modify an order (like set full-load)

   195

	CMD_SKIP_TO_ORDER,                ///< skip an order to the next of specific one

   196

	CMD_DELETE_ORDER,                 ///< delete an order

   197

	CMD_INSERT_ORDER,                 ///< insert a new order

   198

   199

	CMD_CHANGE_SERVICE_INT,           ///< change the server interval of a vehicle

   200

   201

	CMD_BUILD_INDUSTRY,               ///< build a new industry

   202

   203

	CMD_BUILD_COMPANY_HQ,             ///< build the company headquarter

   204

	CMD_SET_COMPANY_MANAGER_FACE,     ///< set the manager's face of the company

   205

	CMD_SET_COMPANY_COLOR,            ///< set the color of the company

   206

   207

	CMD_INCREASE_LOAN,                ///< increase the loan from the bank

   208

	CMD_DECREASE_LOAN,                ///< decrease the loan from the bank

   209

   210

	CMD_WANT_ENGINE_PREVIEW,          ///< confirm the preview of an engine

   211

   212

	CMD_RENAME_VEHICLE,               ///< rename a whole vehicle

   213

	CMD_RENAME_ENGINE,                ///< rename a engine (in the engine list)

   214

	CMD_RENAME_COMPANY,               ///< change the company name

   215

	CMD_RENAME_PRESIDENT,             ///< change the president name

   216

	CMD_RENAME_STATION,               ///< rename a station

   217

   218

	CMD_SELL_AIRCRAFT,                ///< sell an aircraft

   219

	CMD_BUILD_AIRCRAFT,               ///< build an aircraft

   220

	CMD_SEND_AIRCRAFT_TO_HANGAR,      ///< send an aircraft to a hanger

   221

	CMD_REFIT_AIRCRAFT,               ///< refit the cargo space of an aircraft

   222

   223

	CMD_PLACE_SIGN,                   ///< place a sign

   224

	CMD_RENAME_SIGN,                  ///< rename a sign

   225

   226

	CMD_BUILD_ROAD_VEH,               ///< build a road vehicle

   227

	CMD_SELL_ROAD_VEH,                ///< sell a road vehicle

   228

	CMD_SEND_ROADVEH_TO_DEPOT,        ///< send a road vehicle to the depot

   229

	CMD_TURN_ROADVEH,                 ///< turn a road vehicle around

   230

	CMD_REFIT_ROAD_VEH,               ///< refit the cargo space of a road vehicle

   231

   232

	CMD_PAUSE,                        ///< pause the game

   233

   234

	CMD_BUY_SHARE_IN_COMPANY,         ///< buy a share from a company

   235

	CMD_SELL_SHARE_IN_COMPANY,        ///< sell a share from a company

   236

	CMD_BUY_COMPANY,                  ///< buy a company which is bankrupt

   237

   238

	CMD_BUILD_TOWN,                   ///< build a town

   239

   240

	CMD_RENAME_TOWN,                  ///< rename a town

   241

	CMD_DO_TOWN_ACTION,               ///< do a action from the town detail window (like advertises or bribe)

   242

   243

	CMD_SET_ROAD_DRIVE_SIDE,          ///< set the side where the road vehicles drive

   244

   245

	CMD_SELL_SHIP,                    ///< sell a ship

   246

	CMD_BUILD_SHIP,                   ///< build a new ship

   247

	CMD_SEND_SHIP_TO_DEPOT,           ///< send a ship to a depot

   248

	CMD_REFIT_SHIP,                   ///< refit the cargo space of a ship

   249

   250

	CMD_ORDER_REFIT,                  ///< change the refit informaction of an order (for "goto depot" )

   251

	CMD_CLONE_ORDER,                  ///< clone (and share) an order

   252

	CMD_CLEAR_AREA,                   ///< clear an area

   253

   254

	CMD_MONEY_CHEAT,                  ///< do the money cheat

   255

	CMD_BUILD_CANAL,                  ///< build a canal

   256

   257

	CMD_COMPANY_CTRL,                 ///< used in multiplayer to create a new companies etc.

   258

	CMD_LEVEL_LAND,                   ///< level land

   259

   260

	CMD_REFIT_RAIL_VEHICLE,           ///< refit the cargo space of a train

   261

	CMD_RESTORE_ORDER_INDEX,          ///< restore vehicle order-index and service interval

   262

	CMD_BUILD_LOCK,                   ///< build a lock

   263

   264

	CMD_BUILD_SIGNAL_TRACK,           ///< add signals along a track (by dragging)

   265

	CMD_REMOVE_SIGNAL_TRACK,          ///< remove signals along a track (by dragging)

   266

   267

	CMD_GIVE_MONEY,                   ///< give money to another company

   268

	CMD_CHANGE_PATCH_SETTING,         ///< change a patch setting

   269

   270

	CMD_SET_AUTOREPLACE,              ///< set an autoreplace entry

   271

   272

	CMD_CLONE_VEHICLE,                ///< clone a vehicle

   273

	CMD_START_STOP_VEHICLE,           ///< start or stop a vehicle

   274

	CMD_MASS_START_STOP,              ///< start/stop all vehicles (in a depot)

   275

	CMD_AUTOREPLACE_VEHICLE,          ///< replace/renew a vehicle while it is in a depot

   276

	CMD_DEPOT_SELL_ALL_VEHICLES,      ///< sell all vehicles which are in a given depot

   277

	CMD_DEPOT_MASS_AUTOREPLACE,       ///< force the autoreplace to take action in a given depot

   278

   279

	CMD_CREATE_GROUP,                 ///< create a new group

   280

	CMD_DELETE_GROUP,                 ///< delete a group

   281

	CMD_RENAME_GROUP,                 ///< rename a group

   282

	CMD_ADD_VEHICLE_GROUP,            ///< add a vehicle to a group

   283

	CMD_ADD_SHARED_VEHICLE_GROUP,     ///< add all other shared vehicles to a group which are missing

   284

	CMD_REMOVE_ALL_VEHICLES_GROUP,    ///< remove all vehicles from a group

   285

	CMD_SET_GROUP_REPLACE_PROTECTION, ///< set the autoreplace-protection for a group

   286

   287

	CMD_MOVE_ORDER,                   ///< move an order

   288

	CMD_CHANGE_TIMETABLE,             ///< change the timetable for a vehicle

   289

	CMD_SET_VEHICLE_ON_TIME,          ///< set the vehicle on time feature (timetable)

   290

	CMD_AUTOFILL_TIMETABLE,           ///< autofill the timetable

   291

};

   292

   293

/**

   294

 * List of flags for a command.

   295

 *

   296

 * This enums defines some flags which can be used for the commands.

   297

 */

   298

enum {

   299

	DC_EXEC            = 0x001, ///< execute the given command

   300

	DC_AUTO            = 0x002, ///< don't allow building on structures

   301

	DC_QUERY_COST      = 0x004, ///< query cost only,  don't build.

   302

	DC_NO_WATER        = 0x008, ///< don't allow building on water

   303

	DC_NO_RAIL_OVERLAP = 0x010, ///< don't allow overlap of rails (used in buildrail)

   304

	DC_AI_BUILDING     = 0x020, ///< special building rules for AI

   305

	DC_NO_TOWN_RATING  = 0x040, ///< town rating does not disallow you from building

   306

	DC_BANKRUPT        = 0x080, ///< company bankrupts, skip money check, skip vehicle on tile check in some cases

   307

	DC_AUTOREPLACE     = 0x100, ///< autoreplace/autorenew is in progress, this shall disable vehicle limits when building, and ignore certain restrictions when undoing things (like vehicle attach callback)

   308

};

   309

   310

/**

   311

 * Used to combine a StringID with the command.

   312

 *

   313

 * This macro can be used to add a StringID (the error message to show) on a command-id

   314

 * (CMD_xxx). Use the binary or-operator "|" to combine the command with the result from

   315

 * this macro.

   316

 *

   317

 * @param x The StringID to combine with a command-id

   318

 */

   319

#define CMD_MSG(x) ((x) << 16)

   320

   321

/**

   322

 * Defines some flags.

   323

 *

   324

 * This enumeration defines some flags which are binary-or'ed on a command.

   325

 */

   326

enum {

   327

	CMD_NO_WATER              = 0x0400, ///< dont build on water

   328

	CMD_NETWORK_COMMAND       = 0x0800, ///< execute the command without sending it on the network

   329

	CMD_NO_TEST_IF_IN_NETWORK = 0x1000, ///< When enabled, the command will bypass the no-DC_EXEC round if in network

   330

	CMD_SHOW_NO_ERROR         = 0x2000, ///< do not show the error message

   331

};

   332

   333

/**

   334

 * Command flags for the command table _command_proc_table.

   335

 *

   336

 * This enumeration defines flags for the _command_proc_table.

   337

 */

   338

enum {

   339

	CMD_SERVER  = 0x1, ///< the command can only be initiated by the server

   340

	CMD_OFFLINE = 0x2, ///< the command cannot be executed in a multiplayer game; single-player only

   341

	CMD_AUTO    = 0x4, ///< set the DC_AUTO flag on this command

   342

};

   343

   344

/**

   345

 * Defines the callback type for all command handler functions.

   346

 *

   347

 * This type defines the function header for all functions which handles a CMD_* command.

   348

 * A command handler use the parameters to act according to the meaning of the command.

   349

 * The tile parameter defines the tile to perform an action on.

   350

 * The flag parameter is filled with flags from the DC_* enumeration. The parameters

   351

 * p1 and p2 are filled with parameters for the command like "which road type", "which

   352

 * order" or "direction". Each function should mentioned in there doxygen comments

   353

 * the usage of these parameters.

   354

 *

   355

 * @param tile The tile to apply a command on

   356

 * @param flags Flags for the command, from the DC_* enumeration

   357

 * @param p1 Additional data for the command

   358

 * @param p2 Additional data for the command

   359

 * @return The CommandCost of the command, which can be succeeded or failed.

   360

 */

   361

typedef CommandCost CommandProc(TileIndex tile, uint32 flags, uint32 p1, uint32 p2);

   362

   363

/**

   364

 * Define a command with the flags which belongs to it.

   365

 *

   366

 * This struct connect a command handler function with the flags created with

   367

 * the #CMD_AUTO, #CMD_OFFLINE and #CMD_SERVER values.

   368

 */

   369

struct Command {

   370

	CommandProc *proc;

   371

	byte flags;

   372

};

   373

   374

/**

   375

 * Define a callback function for the client, after the command is finished.

   376

 *

   377

 * Functions of this type are called after the command is finished. The parameters

   378

 * are from the #CommandProc callback type. The boolean parameter indicates if the

   379

 * command succeeded or failed.

   380

 *

   381

 * @param success If the command succeeded or not.

   382

 * @param tile The tile of the command action

   383

 * @param p1 Additional data of the command

   384

 * @param p1 Additional data of the command

   385

 * @see CommandProc

   386

 */

   387

typedef void CommandCallback(bool success, TileIndex tile, uint32 p1, uint32 p2);

   388

   389

#endif /* COMMAND_TYPE_H */