1

/* $Id$ */

     2

     3

#ifndef DEPOT_H

     4

#define DEPOT_H

     5

     6

/** @file depot.h Header files for depots (not hangars)

     7

  * @see depot.c */

     8

     9

#include "direction.h"

    10

#include "pool.h"

    12

#include "tile.h"

    13

#include "variables.h"

    14

    15

struct Depot {

    16

	TileIndex xy;

    17

	uint16 town_index;

    18

	uint16 index;

    19

};

    20

    21

extern MemoryPool _depot_pool;

    22

    23

/**

    24

 * Get the pointer to the depot with index 'index'

    25

 */

    26

static inline Depot *GetDepot(uint index)

    27

{

    28

	return (Depot*)GetItemFromPool(&_depot_pool, index);

    29

}

    30

    31

/**

    32

 * Get the current size of the DepotPool

    33

 */

    34

static inline uint16 GetDepotPoolSize(void)

    35

{

    36

	return _depot_pool.total_items;

    37

}

    38

    39

static inline bool IsDepotIndex(uint index)

    40

{

    41

	return index < GetDepotPoolSize();

    42

}

    43

    44

#define FOR_ALL_DEPOTS_FROM(d, start) for (d = GetDepot(start); d != NULL; d = (d->index + 1 < GetDepotPoolSize()) ? GetDepot(d->index + 1) : NULL)

    45

#define FOR_ALL_DEPOTS(d) FOR_ALL_DEPOTS_FROM(d, 0)

    46

    47

#define MIN_SERVINT_PERCENT  5

    48

#define MAX_SERVINT_PERCENT 90

    49

#define MIN_SERVINT_DAYS    30

    50

#define MAX_SERVINT_DAYS   800

    51

    52

/** Get the service interval domain.

    53

 * Get the new proposed service interval for the vehicle is indeed, clamped

    54

 * within the given bounds. @see MIN_SERVINT_PERCENT ,etc.

    55

 * @param index proposed service interval

    56

 */

    57

static inline uint16 GetServiceIntervalClamped(uint index)

    58

{

    59

	return (_patches.servint_ispercent) ? clamp(index, MIN_SERVINT_PERCENT, MAX_SERVINT_PERCENT) : clamp(index, MIN_SERVINT_DAYS, MAX_SERVINT_DAYS);

    60

}

    61

    62

VARDEF TileIndex _last_built_train_depot_tile;

    63

VARDEF TileIndex _last_built_road_depot_tile;

    64

VARDEF TileIndex _last_built_aircraft_depot_tile;

    65

VARDEF TileIndex _last_built_ship_depot_tile;

    66

    67

/**

    68

 * Check if a depot really exists.

    69

 */

    70

static inline bool IsValidDepot(const Depot* depot)

    71

{

    72

	return depot->xy != 0; /* XXX: Replace by INVALID_TILE someday */

    73

}

    74

    75

/**

    76

 * Check if a tile is a depot of the given type.

    77

 */

    78

static inline bool IsTileDepotType(TileIndex tile, TransportType type)

    79

{

    80

	switch (type)

    81

	{

    82

		case TRANSPORT_RAIL:

    83

			return IsTileType(tile, MP_RAILWAY) && (_m[tile].m5 & 0xFC) == 0xC0;

    84

    85

		case TRANSPORT_ROAD:

    86

			return IsTileType(tile, MP_STREET) && (_m[tile].m5 & 0xF0) == 0x20;

    87

    88

		case TRANSPORT_WATER:

    89

			return IsTileType(tile, MP_WATER) && (_m[tile].m5 & ~3) == 0x80;

    90

    91

		default:

    92

			assert(0);

    93

			return false;

    94

	}

    95

}

    96

    97

/**

    98

 * Returns the direction the exit of the depot on the given tile is facing.

    99

 */

   100

static inline DiagDirection GetDepotDirection(TileIndex tile, TransportType type)

   101

{

   102

	assert(IsTileDepotType(tile, type));

   103

   104

	switch (type)

   105

	{

   108

		case TRANSPORT_WATER:

   109

			/* Water is stubborn, it stores the directions in a different order. */

   110

			switch (GB(_m[tile].m5, 0, 2)) {

   111

				case 0: return DIAGDIR_NE;

   112

				case 1: return DIAGDIR_SW;

   113

				case 2: return DIAGDIR_NW;

   114

				case 3: return DIAGDIR_SE;

   115

			}

   116

		default:

   117

			return INVALID_DIAGDIR; /* Not reached */

   118

	}

   119

}

   120

   121

/**

   122

	Find out if the slope of the tile is suitable to build a depot of given direction

   123

	@param direction The direction in which the depot's exit points. Starts with 0 as NE and goes Clockwise

   124

	@param tileh The slope of the tile in question

   125

	@return true if the construction is possible

   126

   127

   128

    This is checked by the ugly 0x4C >> direction magic, which does the following:

   129

      0x4C is 0100 1100 and tileh has only bits 0..3 set (steep tiles are ruled out)

   130

      So: for direction (only the significant bits are shown)<p>

   131

      00 (exit towards NE) we need either bit 2 or 3 set in tileh: 0x4C >> 0 = 1100<p>

   132

      01 (exit towards SE) we need either bit 1 or 2 set in tileh: 0x4C >> 1 = 0110<p>

   133

      02 (exit towards SW) we need either bit 0 or 1 set in tileh: 0x4C >> 2 = 0011<p>

   134

      03 (exit towards NW) we need either bit 0 or 4 set in tileh: 0x4C >> 3 = 1001<p>

   135

      So ((0x4C >> p2) & tileh) determines whether the depot can be built on the current tileh

   136

*/

   137

static inline bool CanBuildDepotByTileh(uint32 direction, uint tileh)

   138

{

   139

	return (0x4C >> direction) & tileh;

   140

}

   141

   142

   143

Depot *GetDepotByTile(TileIndex tile);

   144

void InitializeDepot(void);

   145

Depot *AllocateDepot(void);

   146

void DoDeleteDepot(TileIndex tile);

   147

   148

#endif /* DEPOT_H */