1

/* $Id$ */

     2

     3

/** @file vehicle_func.h Functions related to vehicles. */

     4

     5

#ifndef VEHICLE_FUNC_H

     6

#define VEHICLE_FUNC_H

     7

     8

#include "tile_type.h"

     9

#include "strings_type.h"

    10

#include "gfx_type.h"

    11

#include "direction_type.h"

    12

#include "cargo_type.h"

    13

#include "command_type.h"

    14

#include "vehicle_type.h"

    15

#include "engine_type.h"

    16

#include "transport_type.h"

    17

    18

#define is_custom_sprite(x) (x >= 0xFD)

    19

#define IS_CUSTOM_FIRSTHEAD_SPRITE(x) (x == 0xFD)

    20

#define IS_CUSTOM_SECONDHEAD_SPRITE(x) (x == 0xFE)

    21

    22

typedef Vehicle *VehicleFromPosProc(Vehicle *v, void *data);

    23

    24

void VehicleServiceInDepot(Vehicle *v);

    25

void VehiclePositionChanged(Vehicle *v);

    26

Vehicle *GetLastVehicleInChain(Vehicle *v);

    27

const Vehicle *GetLastVehicleInChain(const Vehicle *v);

    28

uint CountVehiclesInChain(const Vehicle *v);

    29

bool IsEngineCountable(const Vehicle *v);

    30

void DeleteVehicleChain(Vehicle *v);

    31

void FindVehicleOnPos(TileIndex tile, void *data, VehicleFromPosProc *proc);

    32

void FindVehicleOnPosXY(int x, int y, void *data, VehicleFromPosProc *proc);

    33

bool HasVehicleOnPos(TileIndex tile, void *data, VehicleFromPosProc *proc);

    34

bool HasVehicleOnPosXY(int x, int y, void *data, VehicleFromPosProc *proc);

    35

void CallVehicleTicks();

    36

uint8 CalcPercentVehicleFilled(const Vehicle *v, StringID *color);

    37

    38

void InitializeTrains();

    39

byte VehicleRandomBits();

    40

void ResetVehiclePosHash();

    41

void ResetVehicleColorMap();

    42

    43

bool CanRefitTo(EngineID engine_type, CargoID cid_to);

    44

CargoID FindFirstRefittableCargo(EngineID engine_type);

    45

CommandCost GetRefitCost(EngineID engine_type);

    46

    47

void ViewportAddVehicles(DrawPixelInfo *dpi);

    48

    49

SpriteID GetRotorImage(const Vehicle *v);

    50

    51

uint32 VehicleEnterTile(Vehicle *v, TileIndex tile, int x, int y);

    52

    53

StringID VehicleInTheWayErrMsg(const Vehicle* v);

    54

bool HasVehicleOnTunnelBridge(TileIndex tile, TileIndex endtile, const Vehicle *ignore = NULL);

    55

    56

void DecreaseVehicleValue(Vehicle *v);

    57

void CheckVehicleBreakdown(Vehicle *v);

    58

void AgeVehicle(Vehicle *v);

    59

void VehicleEnteredDepotThisTick(Vehicle *v);

    60

    61

void BeginVehicleMove(const Vehicle *v);

    62

void EndVehicleMove(const Vehicle *v);

    63

void MarkSingleVehicleDirty(const Vehicle *v);

    64

    65

UnitID GetFreeUnitNumber(VehicleType type);

    66

    67

void TrainConsistChanged(Vehicle *v, bool same_length);

    68

void TrainPowerChanged(Vehicle *v);

    69

Money GetTrainRunningCost(const Vehicle *v);

    70

    71

CommandCost SendAllVehiclesToDepot(VehicleType type, uint32 flags, bool service, Owner owner, uint16 vlw_flag, uint32 id);

    72

void VehicleEnterDepot(Vehicle *v);

    73

    74

bool CanBuildVehicleInfrastructure(VehicleType type);

    75

    76

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

    77

    78

/** Position information of a vehicle after it moved */

    79

struct GetNewVehiclePosResult {

    80

	int x, y;  ///< x and y position of the vehicle after moving

    81

	TileIndex old_tile; ///< Current tile of the vehicle

    82

	TileIndex new_tile; ///< Tile of the vehicle after moving

    83

};

    84

    85

GetNewVehiclePosResult GetNewVehiclePos(const Vehicle *v);

    86

Direction GetDirectionTowards(const Vehicle *v, int x, int y);

    87

    88

static inline bool IsCompanyBuildableVehicleType(VehicleType type)

    89

{

    90

	switch (type) {

    91

		case VEH_TRAIN:

    92

		case VEH_ROAD:

    93

		case VEH_SHIP:

    94

		case VEH_AIRCRAFT:

    95

			return true;

    96

    97

		default: return false;

    98

	}

    99

}

   100

   101

static inline bool IsCompanyBuildableVehicleType(const BaseVehicle *v)

   102

{

   103

	return IsCompanyBuildableVehicleType(v->type);

   104

}

   105

   106

const struct Livery *GetEngineLivery(EngineID engine_type, CompanyID company, EngineID parent_engine_type, const Vehicle *v);

   107

   108

/**

   109

 * Get the colour map for an engine. This used for unbuilt engines in the user interface.

   110

 * @param engine_type ID of engine

   111

 * @param company ID of company

   112

 * @return A ready-to-use palette modifier

   113

 */

   114

SpriteID GetEnginePalette(EngineID engine_type, CompanyID company);

   115

   116

/**

   117

 * Get the colour map for a vehicle.

   118

 * @param v Vehicle to get colour map for

   119

 * @return A ready-to-use palette modifier

   120

 */

   121

SpriteID GetVehiclePalette(const Vehicle *v);

   122

   123

extern const uint32 _veh_build_proc_table[];

   124

extern const uint32 _veh_sell_proc_table[];

   125

extern const uint32 _veh_refit_proc_table[];

   126

extern const uint32 _send_to_depot_proc_table[];

   127

   128

/* Functions to find the right command for certain vehicle type */

   129

static inline uint32 GetCmdBuildVeh(VehicleType type)

   130

{

   131

	return _veh_build_proc_table[type];

   132

}

   133

   134

static inline uint32 GetCmdBuildVeh(const BaseVehicle *v)

   135

{

   136

	return GetCmdBuildVeh(v->type);

   137

}

   138

   139

static inline uint32 GetCmdSellVeh(VehicleType type)

   140

{

   141

	return _veh_sell_proc_table[type];

   142

}

   143

   144

static inline uint32 GetCmdSellVeh(const BaseVehicle *v)

   145

{

   146

	return GetCmdSellVeh(v->type);

   147

}

   148

   149

static inline uint32 GetCmdRefitVeh(VehicleType type)

   150

{

   151

	return _veh_refit_proc_table[type];

   152

}

   153

   154

static inline uint32 GetCmdRefitVeh(const BaseVehicle *v)

   155

{

   156

	return GetCmdRefitVeh(v->type);

   157

}

   158

   159

static inline uint32 GetCmdSendToDepot(VehicleType type)

   160

{

   161

	return _send_to_depot_proc_table[type];

   162

}

   163

   164

static inline uint32 GetCmdSendToDepot(const BaseVehicle *v)

   165

{

   166

	return GetCmdSendToDepot(v->type);

   167

}

   168

   169

bool EnsureNoVehicleOnGround(TileIndex tile);

   170

void StopAllVehicles();

   171

   172

extern VehicleID _vehicle_id_ctr_day;

   173

extern const Vehicle *_place_clicked_vehicle;

   174

extern VehicleID _new_vehicle_id;

   175

extern uint16 _returned_refit_capacity;

   176

   177

#endif /* VEHICLE_FUNC_H */