1

/* $Id$ */

     2

     3

/** @file aircraft.h */

     4

     5

#ifndef AIRCRAFT_H

     6

#define AIRCRAFT_H

     7

     8

#include "station_map.h"

     9

#include "vehicle_base.h"

    10

#include "engine.h"

    11

    12

/** An aircraft can be one ot those types */

    13

enum AircraftSubType {

    14

	AIR_HELICOPTER = 0, ///< an helicopter

    15

	AIR_AIRCRAFT   = 2, ///< an airplane

    16

	AIR_SHADOW     = 4, ///< shadow of the aircraft

    17

	AIR_ROTOR      = 6  ///< rotor of an helicopter

    18

};

    19

    20

    21

/** Check if the aircraft type is a normal flying device; eg

    22

 * not a rotor or a shadow

    23

 * @param v vehicle to check

    24

 * @return Returns true if the aircraft is a helicopter/airplane and

    25

 * false if it is a shadow or a rotor) */

    26

static inline bool IsNormalAircraft(const Vehicle *v)

    27

{

    28

	assert(v->type == VEH_AIRCRAFT);

    29

	/* To be fully correct the commented out functionality is the proper one,

    30

	 * but since value can only be 0 or 2, it is sufficient to only check <= 2

    31

	 * return (v->subtype == AIR_HELICOPTER) || (v->subtype == AIR_AIRCRAFT); */

    32

	return v->subtype <= AIR_AIRCRAFT;

    33

}

    34

    35

/** Checks if an aircraft can use the station in question

    36

 * @param engine The engine to test

    37

 * @param st The station

    38

 * @return true if the aircraft can use the station

    39

 */

    40

static inline bool CanAircraftUseStation(EngineID engine, const Station *st)

    41

{

    42

	const AirportFTAClass *apc = st->Airport();

    43

	const AircraftVehicleInfo *avi = AircraftVehInfo(engine);

    44

    45

	return (apc->flags & (avi->subtype & AIR_CTOL ? AirportFTAClass::AIRPLANES : AirportFTAClass::HELICOPTERS)) != 0;

    46

}

    47

    48

/** Checks if an aircraft can use the station at the tile in question

    49

 * @param engine The engine to test

    50

 * @param tile The tile where the station is

    51

 * @return true if the aircraft can use the station

    52

 */

    53

static inline bool CanAircraftUseStation(EngineID engine, TileIndex tile)

    54

{

    55

	return CanAircraftUseStation(engine, GetStationByTile(tile));

    56

}

    57

    58

/**

    59

 * Calculates cargo capacity based on an aircraft's passenger

    60

 * and mail capacities.

    61

 * @param cid Which cargo type to calculate a capacity for.

    62

 * @param avi Which engine to find a cargo capacity for.

    63

 * @return New cargo capacity value.

    64

 */

    65

uint16 AircraftDefaultCargoCapacity(CargoID cid, const AircraftVehicleInfo *avi);

    66

    67

/**

    68

 * This is the Callback method after the construction attempt of an aircraft

    69

 * @param success indicates completion (or not) of the operation

    70

 * @param tile of depot where aircraft is built

    71

 * @param p1 unused

    72

 * @param p2 unused

    73

 */

    74

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

    75

    76

/** Handle Aircraft specific tasks when a an Aircraft enters a hangar

    77

 * @param *v Vehicle that enters the hangar

    78

 */

    79

void HandleAircraftEnterHangar(Vehicle *v);

    80

    81

/** Get the size of the sprite of an aircraft sprite heading west (used for lists)

    82

 * @param engine The engine to get the sprite from

    83

 * @param width The width of the sprite

    84

 * @param height The height of the sprite

    85

 */

    86

void GetAircraftSpriteSize(EngineID engine, uint &width, uint &height);

    87

    88

/**

    89

 * Updates the status of the Aircraft heading or in the station

    90

 * @param st Station been updated

    91

 */

    92

void UpdateAirplanesOnNewStation(const Station *st);

    93

    94

/** Update cached values of an aircraft.

    95

 * Currently caches callback 36 max speed.

    96

 * @param v Vehicle

    97

 */

    98

void UpdateAircraftCache(Vehicle *v);

    99

   100

/**

   101

 * This class 'wraps' Vehicle; you do not actually instantiate this class.

   102

 * You create a Vehicle using AllocateVehicle, so it is added to the pool

   103

 * and you reinitialize that to a Train using:

   104

 *   v = new (v) Aircraft();

   105

 *

   106

 * As side-effect the vehicle type is set correctly.

   107

 */

   108

struct Aircraft : public Vehicle {

   109

	/** Initializes the Vehicle to an aircraft */

   110

	Aircraft() { this->type = VEH_AIRCRAFT; }

   111

   112

	/** We want to 'destruct' the right class. */

   113

	virtual ~Aircraft() { this->PreDestructor(); }

   114

   115

	const char *GetTypeString() const { return "aircraft"; }

   116

	void MarkDirty();

   117

	void UpdateDeltaXY(Direction direction);

   118

	ExpensesType GetExpenseType(bool income) const { return income ? EXPENSES_AIRCRAFT_INC : EXPENSES_AIRCRAFT_RUN; }

   119

	WindowClass GetVehicleListWindowClass() const { return WC_AIRCRAFT_LIST; }

   120

	bool IsPrimaryVehicle() const { return IsNormalAircraft(this); }

   121

	int GetImage(Direction direction) const;

   122

	int GetDisplaySpeed() const { return this->cur_speed * 10 / 16; }

   123

	int GetDisplayMaxSpeed() const { return this->max_speed * 10 / 16; }

   124

	Money GetRunningCost() const { return AircraftVehInfo(this->engine_type)->running_cost * _price.aircraft_running; }

   125

	bool IsInDepot() const { return (this->vehstatus & VS_HIDDEN) != 0 && IsHangarTile(this->tile); }

   126

	void Tick();

   127

};

   128

   129

#endif /* AIRCRAFT_H */