/* $Id$ */

/*

 * This file is part of OpenTTD.

 * OpenTTD is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2.

 * OpenTTD is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

 * See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see <http://www.gnu.org/licenses/>.

 */

/** @file  vehicle_base.h Base class for all vehicles. */

#ifndef VEHICLE_BASE_H

#define VEHICLE_BASE_H

#include "track_type.h"

#include "command_type.h"

#include "order_base.h"

#include "cargopacket.h"

#include "texteff.hpp"

#include "engine_type.h"

#include "order_func.h"

#include "transport_type.h"

#include "group_type.h"

#include "base_consist.h"

/** Vehicle status bits in #Vehicle::vehstatus. */

enum VehStatus {

	VS_HIDDEN          = 0x01, ///< Vehicle is not visible.

	VS_STOPPED         = 0x02, ///< Vehicle is stopped by the player.

	VS_UNCLICKABLE     = 0x04, ///< Vehicle is not clickable by the user (shadow vehicles).

	VS_DEFPAL          = 0x08, ///< Use default vehicle palette. @see DoDrawVehicle

	VS_TRAIN_SLOWING   = 0x10, ///< Train is slowing down.

	VS_SHADOW          = 0x20, ///< Vehicle is a shadow vehicle.

	VS_AIRCRAFT_BROKEN = 0x40, ///< Aircraft is broken down.

	VS_CRASHED         = 0x80, ///< Vehicle is crashed.

};

/** Bit numbers in #Vehicle::vehicle_flags. */

	byte spritenum;

	SpriteID cur_image;                 ///< sprite number for this vehicle

	byte x_extent;                      ///< x-extent of vehicle bounding box

	byte y_extent;                      ///< y-extent of vehicle bounding box

	byte z_extent;                      ///< z-extent of vehicle bounding box

	int8 x_bb_offs;                     ///< x offset of vehicle bounding box

	int8 y_bb_offs;                     ///< y offset of vehicle bounding box

	int8 x_offs;                        ///< x offset for vehicle sprite

	int8 y_offs;                        ///< y offset for vehicle sprite

	EngineID engine_type;               ///< The type of engine used for this vehicle.

	TextEffectID fill_percent_te_id;    ///< a text-effect id to a loading indicator object

	UnitID unitnumber;                  ///< unit number, for display purposes only

	uint16 cur_speed;                   ///< current speed

	byte subspeed;                      ///< fractional speed

	byte acceleration;                  ///< used by train & aircraft

	uint32 motion_counter;              ///< counter to occasionally play a vehicle sound.

	byte progress;                      ///< The percentage (if divided by 256) this vehicle already crossed the tile unit.

	byte random_bits;                   ///< Bits used for determining which randomized variational spritegroups to use when drawing.

	byte waiting_triggers;              ///< Triggers to be yet matched before rerandomizing the random bits.

	StationID last_station_visited;     ///< The last station we stopped at.

	CargoID cargo_type;                 ///< type of cargo this vehicle is carrying

	byte cargo_subtype;                 ///< Used for livery refits (NewGRF variations)

	uint16 cargo_cap;                   ///< total capacity

	VehicleCargoList cargo;             ///< The cargo this vehicle is carrying

	uint16 cargo_age_counter;           ///< Ticks till cargo is aged next.

	byte day_counter;                   ///< Increased by one for each day

	byte tick_counter;                  ///< Increased by one for each tick

	byte running_ticks;                 ///< Number of ticks this vehicle was not stopped this day

	byte vehstatus;                     ///< Status

	Order current_order;                ///< The current order (+ status, like: loading)

	union {

		OrderList *list;            ///< Pointer to the order list for this vehicle

		Order     *old;             ///< Only used during conversion of old save games

	} orders;                           ///< The orders currently assigned to the vehicle.

	uint16 load_unload_ticks;           ///< Ticks to wait before starting next cycle.

	GroupID group_id;                   ///< Index of group Pool array

	byte subtype;                       ///< subtype (Filled with values from #EffectVehicles/#TrainSubTypes/#AircraftSubTypes)

	NewGRFCache grf_cache;              ///< Cache of often used calculated NewGRF values

	VehicleCache vcache;                ///< Cache of often used vehicle values.

	Vehicle(VehicleType type = VEH_INVALID);

	void PreDestructor();

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

	virtual ~Vehicle();

	void BeginLoading();

	void CancelReservation(Station *st);

	void LeaveStation();

	GroundVehicleCache *GetGroundVehicleCache();

	const GroundVehicleCache *GetGroundVehicleCache() const;

	uint16 &GetGroundVehicleFlags();

	const uint16 &GetGroundVehicleFlags() const;

	void DeleteUnreachedImplicitOrders();

	void HandleLoading(bool mode = false);

	/**

	 * Marks the vehicles to be redrawn and updates cached variables

	 *

	 * This method marks the area of the vehicle on the screen as dirty.

	 * It can be use to repaint the vehicle.

	 *

	 * @ingroup dirty

	 */

	virtual void MarkDirty() {}

	/**

	 * Updates the x and y offsets and the size of the sprite used

	 * for this vehicle.

	 * @param direction the direction the vehicle is facing

	 */

	virtual void UpdateDeltaXY(Direction direction) {}

	/**

	 * Determines the effective direction-specific vehicle movement speed.

	 *

	 * This method belongs to the old vehicle movement method:

	 * A vehicle moves a step every 256 progress units.

	 * The vehicle speed is scaled by 3/4 when moving in X or Y direction due to the longer distance.

	 *

	 * Get the first vehicle of this vehicle chain.

	 * @return the first vehicle of the chain.

	 */

	inline Vehicle *FirstShared() const { return (this->orders.list == NULL) ? this->First() : this->orders.list->GetFirstSharedVehicle(); }

	/**

	 * Check if we share our orders with another vehicle.

	 * @return true if there are other vehicles sharing the same order

	 */

	inline bool IsOrderListShared() const { return this->orders.list != NULL && this->orders.list->IsShared(); }

	/**

	 * Get the number of orders this vehicle has.

	 * @return the number of orders this vehicle has.

	 */

	inline VehicleOrderID GetNumOrders() const { return (this->orders.list == NULL) ? 0 : this->orders.list->GetNumOrders(); }

	/**

	 * Get the number of manually added orders this vehicle has.

	 * @return the number of manually added orders this vehicle has.

	 */

	inline VehicleOrderID GetNumManualOrders() const { return (this->orders.list == NULL) ? 0 : this->orders.list->GetNumManualOrders(); }

	/**

	 * Copy certain configurations and statistics of a vehicle after successful autoreplace/renew

	 * The function shall copy everything that cannot be copied by a command (like orders / group etc),

	 * and that shall not be resetted for the new vehicle.

	 * @param src The old vehicle

	 */

	inline void CopyVehicleConfigAndStatistics(const Vehicle *src)

	{

		this->CopyConsistPropertiesFrom(src);

		this->unitnumber = src->unitnumber;

		this->current_order = src->current_order;

		this->dest_tile  = src->dest_tile;

		this->profit_this_year = src->profit_this_year;

		this->profit_last_year = src->profit_last_year;

	}

	bool HandleBreakdown();

	bool NeedsAutorenewing(const Company *c, bool use_renew_setting = true) const;

	bool NeedsServicing() const;