1

/* $Id$ */

     2

     3

/** @file tile_cmd.h Generic 'commands' that can be performed on all tiles. */

     4

     5

#ifndef TILE_CMD_H

     6

#define TILE_CMD_H

     7

     8

#include "slope_type.h"

    10

#include "command_type.h"

    11

#include "vehicle_type.h"

    12

#include "cargo_type.h"

    14

    15

/** The returned bits of VehicleEnterTile. */

    16

enum VehicleEnterTileStatus {

    17

	VETS_ENTERED_STATION  = 1, ///< The vehicle entered a station

    18

	VETS_ENTERED_WORMHOLE = 2, ///< The vehicle either entered a bridge, tunnel or depot tile (this includes the last tile of the bridge/tunnel)

    19

	VETS_CANNOT_ENTER     = 3, ///< The vehicle cannot enter the tile

    20

    21

	/**

    22

	 * Shift the VehicleEnterTileStatus this many bits

    23

	 * to the right to get the station ID when

    24

	 * VETS_ENTERED_STATION is set

    25

	 */

    26

	VETS_STATION_ID_OFFSET = 8,

    27

    28

	/** Bit sets of the above specified bits */

    29

	VETSB_CONTINUE         = 0,                          ///< The vehicle can continue normally

    30

	VETSB_ENTERED_STATION  = 1 << VETS_ENTERED_STATION,  ///< The vehicle entered a station

    31

	VETSB_ENTERED_WORMHOLE = 1 << VETS_ENTERED_WORMHOLE, ///< The vehicle either entered a bridge, tunnel or depot tile (this includes the last tile of the bridge/tunnel)

    32

	VETSB_CANNOT_ENTER     = 1 << VETS_CANNOT_ENTER,     ///< The vehicle cannot enter the tile

    33

};

    34

DECLARE_ENUM_AS_BIT_SET(VehicleEnterTileStatus);

    35

    51

typedef void DrawTileProc(TileInfo *ti);

    52

typedef uint GetSlopeZProc(TileIndex tile, uint x, uint y);

    53

typedef CommandCost ClearTileProc(TileIndex tile, byte flags);

    54

typedef void GetAcceptedCargoProc(TileIndex tile, AcceptedCargo res);

    55

typedef void GetTileDescProc(TileIndex tile, TileDesc *td);

    56

    57

/**

    58

 * GetTileTrackStatusProcs return a value that contains the possible tracks

    59

 * that can be taken on a given tile by a given transport. The return value is

    60

 * composed as follows: 0xaabbccdd. ccdd and aabb are bitmasks of trackdirs,

    61

 * where bit n corresponds to trackdir n. ccdd are the trackdirs that are

    62

 * present in the tile (1==present, 0==not present), aabb is the signal

    63

 * status, if applicable (0==green/no signal, 1==red, note that this is

    64

 * reversed from map3/2[tile] for railway signals).

    65

 *

    66

 * The result (let's call it ts) is often used as follows:

    67

 * tracks = (byte)(ts | ts >>8)

    68

 * This effectively converts the present part of the result (ccdd) to a

    69

 * track bitmask, which disregards directions. Normally, this is the same as just

    70

 * doing (byte)ts I think, although I am not really sure

    71

 *

    72

 * A trackdir is combination of a track and a dir, where the lower three bits

    73

 * are a track, the fourth bit is the direction. these give 12 (or 14)

    74

 * possible options: 0-5 and 8-13, so we need 14 bits for a trackdir bitmask

    75

 * above.

    76

 * @param tile     the tile to get the track status from

    77

 * @param mode     the mode of transportation

    78

 * @param sub_mode used to differentiate between different kinds within the mode

    79

 * @return the above mentions track status information

    80

 */

    81

typedef uint32 GetTileTrackStatusProc(TileIndex tile, TransportType mode, uint sub_mode);

    82

typedef void GetProducedCargoProc(TileIndex tile, CargoID *b);

    83

typedef void ClickTileProc(TileIndex tile);

    84

typedef void AnimateTileProc(TileIndex tile);

    85

typedef void TileLoopProc(TileIndex tile);

    86

typedef void ChangeTileOwnerProc(TileIndex tile, PlayerID old_player, PlayerID new_player);

    87

    88

/** @see VehicleEnterTileStatus to see what the return values mean */

    89

typedef VehicleEnterTileStatus VehicleEnterTileProc(Vehicle *v, TileIndex tile, int x, int y);

    90

typedef Foundation GetFoundationProc(TileIndex tile, Slope tileh);

    91

    92

/**

    93

 * Called when a tile is affected by a terraforming operation.

    94

 * The function has to check if terraforming of the tile is allowed and return extra terraform-cost that depend on the tiletype.

    95

 * With DC_EXEC in flags it has to perform tiletype-specific actions (like clearing land etc., but not the terraforming itself).

    96

 *

    97

 * @note The terraforming has not yet taken place. So GetTileZ() and GetTileSlope() refer to the landscape before the terraforming operation.

    98

 *

    99

 * @param tile      The involved tile.

   100

 * @param flags     Command flags passed to the terraform command (DC_EXEC, DC_QUERY_COST, etc.).

   101

 * @param z_new     TileZ after terraforming.

   102

 * @param tileh_new Slope after terraforming.

   103

 * @return Error code or extra cost for terraforming (like clearing land, building foundations, etc., but not the terraforming itself.)

   104

 */

   105

typedef CommandCost TerraformTileProc(TileIndex tile, uint32 flags, uint z_new, Slope tileh_new);

   106

   107

struct TileTypeProcs {

   108

	DrawTileProc *draw_tile_proc;

   109

	GetSlopeZProc *get_slope_z_proc;

   110

	ClearTileProc *clear_tile_proc;

   111

	GetAcceptedCargoProc *get_accepted_cargo_proc;

   112

	GetTileDescProc *get_tile_desc_proc;

   113

	GetTileTrackStatusProc *get_tile_track_status_proc;

   114

	ClickTileProc *click_tile_proc;

   115

	AnimateTileProc *animate_tile_proc;

   116

	TileLoopProc *tile_loop_proc;

   117

	ChangeTileOwnerProc *change_tile_owner_proc;

   118

	GetProducedCargoProc *get_produced_cargo_proc;

   119

	VehicleEnterTileProc *vehicle_enter_tile_proc;

   120

	GetFoundationProc *get_foundation_proc;

   121

	TerraformTileProc *terraform_tile_proc;

   122

};

   123

   124

extern const TileTypeProcs * const _tile_type_procs[16];

   125

   126

uint32 GetTileTrackStatus(TileIndex tile, TransportType mode, uint sub_mode);

   127

void GetAcceptedCargo(TileIndex tile, AcceptedCargo ac);

   128

void ChangeTileOwner(TileIndex tile, PlayerID old_player, PlayerID new_player);

   129

void AnimateTile(TileIndex tile);

   130

void ClickTile(TileIndex tile);

   131

void GetTileDesc(TileIndex tile, TileDesc *td);

   132

   133

#endif /* TILE_CMD_H */