vehicle_func.h File Reference

Functions related to vehicles. More...

#include "tile_type.h"
#include "strings_type.h"
#include "gfx_type.h"
#include "direction_type.h"
#include "cargo_type.h"
#include "command_type.h"
#include "vehicle_type.h"
#include "engine_type.h"
#include "transport_type.h"
#include "newgrf_config.h"

Go to the source code of this file.

Data Structures

struct  GetNewVehiclePosResult
 Position information of a vehicle after it moved. More...

Defines

#define is_custom_sprite(x)   (x >= 0xFD)
#define IS_CUSTOM_FIRSTHEAD_SPRITE(x)   (x == 0xFD)
#define IS_CUSTOM_SECONDHEAD_SPRITE(x)   (x == 0xFE)

Typedefs

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

Functions

void VehicleServiceInDepot (Vehicle *v)
Vehicle * GetLastVehicleInChain (Vehicle *v)
const Vehicle * GetLastVehicleInChain (const Vehicle *v)
uint CountVehiclesInChain (const Vehicle *v)
bool IsEngineCountable (const Vehicle *v)
 Check if a vehicle is counted in num_engines in each company struct.
void FindVehicleOnPos (TileIndex tile, void *data, VehicleFromPosProc *proc)
 Find a vehicle from a specific location.
void FindVehicleOnPosXY (int x, int y, void *data, VehicleFromPosProc *proc)
 Find a vehicle from a specific location.
bool HasVehicleOnPos (TileIndex tile, void *data, VehicleFromPosProc *proc)
 Checks whether a vehicle in on a specific location.
bool HasVehicleOnPosXY (int x, int y, void *data, VehicleFromPosProc *proc)
 Checks whether a vehicle in on a specific location.
void CallVehicleTicks ()
uint8 CalcPercentVehicleFilled (const Vehicle *v, StringID *colour)
 Calculates how full a vehicle is.
void InitializeTrains ()
byte VehicleRandomBits ()
 Get a value for a vehicle's random_bits.
void ResetVehiclePosHash ()
void ResetVehicleColourMap ()
bool CanRefitTo (EngineID engine_type, CargoID cid_to)
 Check if a given engine type can be refitted to a given cargo.
CargoID FindFirstRefittableCargo (EngineID engine_type)
 Find the first cargo type that an engine can be refitted to.
CommandCost GetRefitCost (EngineID engine_type)
 Learn the price of refitting a certain engine.
void ViewportAddVehicles (DrawPixelInfo *dpi)
SpriteID GetRotorImage (const Vehicle *v)
void ShowNewGrfVehicleError (EngineID engine, StringID part1, StringID part2, GRFBugs bug_type, bool critical)
 Displays a "NewGrf Bug" error message for a engine, and pauses the game if not networking.
StringID VehicleInTheWayErrMsg (const Vehicle *v)
bool HasVehicleOnTunnelBridge (TileIndex tile, TileIndex endtile, const Vehicle *ignore=NULL)
 Finds vehicle in tunnel / bridge.
void DecreaseVehicleValue (Vehicle *v)
void CheckVehicleBreakdown (Vehicle *v)
void AgeVehicle (Vehicle *v)
void VehicleEnteredDepotThisTick (Vehicle *v)
 Adds a vehicle to the list of vehicles, that visited a depot this tick.
void VehicleMove (Vehicle *v, bool update_viewport)
 Move a vehicle in the game state; that is moving it's position in the position hashes and marking it's location in the viewport dirty if requested.
void MarkSingleVehicleDirty (const Vehicle *v)
 Marks viewports dirty where the vehicle's image is In fact, it equals BeginVehicleMove(v); EndVehicleMove(v);.
UnitID GetFreeUnitNumber (VehicleType type)
void TrainConsistChanged (Vehicle *v, bool same_length)
 Recalculates the cached stuff of a train.
void TrainPowerChanged (Vehicle *v)
 Recalculates the cached total power of a train.
Money GetTrainRunningCost (const Vehicle *v)
CommandCost SendAllVehiclesToDepot (VehicleType type, DoCommandFlag flags, bool service, Owner owner, uint16 vlw_flag, uint32 id)
 Send all vehicles of type to depots.
void VehicleEnterDepot (Vehicle *v)
bool CanBuildVehicleInfrastructure (VehicleType type)
 Check whether we can build infrastructure for the given vehicle type.
void CcCloneVehicle (bool success, TileIndex tile, uint32 p1, uint32 p2)
 This is the Callback method after the cloning attempt of a vehicle.
GetNewVehiclePosResult GetNewVehiclePos (const Vehicle *v)
 Get position information of a vehicle when moving one pixel in the direction it is facing.
Direction GetDirectionTowards (const Vehicle *v, int x, int y)
static bool IsCompanyBuildableVehicleType (VehicleType type)
static bool IsCompanyBuildableVehicleType (const BaseVehicle *v)
struct Livery * GetEngineLivery (EngineID engine_type, CompanyID company, EngineID parent_engine_type, const Vehicle *v)
SpriteID GetEnginePalette (EngineID engine_type, CompanyID company)
 Get the colour map for an engine.
SpriteID GetVehiclePalette (const Vehicle *v)
 Get the colour map for a vehicle.
static uint32 GetCmdBuildVeh (VehicleType type)
static uint32 GetCmdBuildVeh (const BaseVehicle *v)
static uint32 GetCmdSellVeh (VehicleType type)
static uint32 GetCmdSellVeh (const BaseVehicle *v)
static uint32 GetCmdRefitVeh (VehicleType type)
static uint32 GetCmdRefitVeh (const BaseVehicle *v)
static uint32 GetCmdSendToDepot (VehicleType type)
static uint32 GetCmdSendToDepot (const BaseVehicle *v)
bool EnsureNoVehicleOnGround (TileIndex tile)
void StopAllVehicles ()
bool CanVehicleUseStation (EngineID engine_type, const struct Station *st)
bool CanVehicleUseStation (const Vehicle *v, const struct Station *st)
void ReleaseDisastersTargetingVehicle (VehicleID vehicle)
 Notify disasters that we are about to delete a vehicle.

Variables

const uint32 _veh_build_proc_table []
const uint32 _veh_sell_proc_table []
const uint32 _veh_refit_proc_table []
const uint32 _send_to_depot_proc_table []
VehicleID _vehicle_id_ctr_day
const Vehicle * _place_clicked_vehicle
VehicleID _new_vehicle_id
uint16 _returned_refit_capacity


Detailed Description

Functions related to vehicles.

Definition in file vehicle_func.h.


Function Documentation

uint8 CalcPercentVehicleFilled ( const Vehicle *  v,
StringID colour 
)

Calculates how full a vehicle is.

Parameters:
v The Vehicle to check. For trains, use the first engine.
colour The string to show depending on if we are unloading or loading
Returns:
A percentage of how full the Vehicle is.

Definition at line 958 of file vehicle.cpp.

References Station::goods, HasBit(), max(), and OLFB_NO_LOAD.

Referenced by LoadUnloadVehicle(), and ProcessConditionalOrder().

bool CanBuildVehicleInfrastructure ( VehicleType  type  ) 

Check whether we can build infrastructure for the given vehicle type.

This to disable building stations etc. when you are not allowed/able to have the vehicle type yet.

Parameters:
type the vehicle type to check this for
Returns:
true if there is any reason why you may build the infrastructure for the given vehicle type

Definition at line 1308 of file vehicle.cpp.

References _settings_client, _settings_game, GUISettings::always_build_infrastructure, ClientSettings::gui, HasBit(), max(), VehicleSettings::max_aircraft, VehicleSettings::max_roadveh, VehicleSettings::max_ships, VehicleSettings::max_trains, and GameSettings::vehicle.

bool CanRefitTo ( EngineID  engine_type,
CargoID  cid_to 
)

Check if a given engine type can be refitted to a given cargo.

Parameters:
engine_type Engine type to check
cid_to check refit to this cargo-type
Returns:
true if it is possible, false otherwise

Definition at line 707 of file vehicle.cpp.

References HasBit().

Referenced by AIEngine::CanRefitCargo(), CmdRefitAircraft(), CmdRefitRailVehicle(), CmdRefitRoadVeh(), and CmdRefitShip().

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

This is the Callback method after the cloning attempt of a vehicle.

Parameters:
success indicates completion (or not) of the operation
tile unused
p1 unused
p2 unused

Definition at line 138 of file depot_gui.cpp.

References ShowVehicleViewWindow().

CargoID FindFirstRefittableCargo ( EngineID  engine_type  ) 

Find the first cargo type that an engine can be refitted to.

Parameters:
engine_type Which engine to find cargo for.
Returns:
A climate dependent cargo type. CT_INVALID is returned if not refittable.

Definition at line 716 of file vehicle.cpp.

References HasBit().

Referenced by CalculateRefitMasks().

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

Find a vehicle from a specific location.

It will call proc for ALL vehicles on the tile and YOU must make SURE that the "best one" is stored in the data value and is ALWAYS the same regardless of the order of the vehicles where proc was called on! When you fail to do this properly you create an almost untraceable DESYNC!

Note:
The return value of proc will be ignored.

Use this when you have the intention that all vehicles should be iterated over.

Parameters:
tile The location on the map
data Arbitrary data passed to proc
proc The proc that determines whether a vehicle will be "found".

Definition at line 356 of file vehicle.cpp.

References VehicleFromPos().

Referenced by CheckTrainCollision(), CmdConvertRail(), DeleteLastWagon(), FloodVehicles(), GetTrainForReservation(), and RemoveRoadStop().

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

Find a vehicle from a specific location.

It will call proc for ALL vehicles on the tile and YOU must make SURE that the "best one" is stored in the data value and is ALWAYS the same regardless of the order of the vehicles where proc was called on! When you fail to do this properly you create an almost untraceable DESYNC!

Note:
The return value of proc will be ignored.

Use this when you have the intention that all vehicles should be iterated over.

Parameters:
x The X location on the map
y The Y location on the map
data Arbitrary data passed to proc
proc The proc that determines whether a vehicle will be "found".

Definition at line 296 of file vehicle.cpp.

References VehicleFromPosXY().

Referenced by CheckTrainCollision().

SpriteID GetEnginePalette ( EngineID  engine_type,
CompanyID  company 
)

Get the colour map for an engine.

This used for unbuilt engines in the user interface.

Parameters:
engine_type ID of engine
company ID of company
Returns:
A ready-to-use palette modifier

Definition at line 1486 of file vehicle.cpp.

Referenced by DrawEngineList().

GetNewVehiclePosResult GetNewVehiclePos ( const Vehicle *  v  ) 

Get position information of a vehicle when moving one pixel in the direction it is facing.

Parameters:
v Vehicle to move
Returns:
Position information after the move

Definition at line 1156 of file vehicle.cpp.

References GetNewVehiclePosResult::new_tile, GetNewVehiclePosResult::old_tile, GetNewVehiclePosResult::x, and GetNewVehiclePosResult::y.

Referenced by AircraftController(), DisasterTick_Airplane(), DisasterTick_Big_Ufo(), DisasterTick_Big_Ufo_Destroyer(), DisasterTick_Helicopter(), DisasterTick_Submarine(), DisasterTick_Ufo(), DisasterTick_Zeppeliner(), UpdateAirplanesOnNewStation(), and UpdateOldAircraft().

CommandCost GetRefitCost ( EngineID  engine_type  ) 

Learn the price of refitting a certain engine.

Parameters:
engine_type Which engine to refit
Returns:
Price for refitting

Definition at line 733 of file vehicle.cpp.

References RAILVEH_WAGON.

Referenced by CmdCloneVehicle(), CmdRefitAircraft(), CmdRefitRailVehicle(), CmdRefitRoadVeh(), and CmdRefitShip().

SpriteID GetVehiclePalette ( const Vehicle *  v  ) 

Get the colour map for a vehicle.

Parameters:
v Vehicle to get colour map for
Returns:
A ready-to-use palette modifier

Definition at line 1491 of file vehicle.cpp.

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

Checks whether a vehicle in on a specific location.

It will call proc for vehicles until it returns non-NULL.

Note:
Use FindVehicleOnPos when you have the intention that all vehicles should be iterated over.
Parameters:
tile The location on the map
data Arbitrary data passed to proc
proc The proc that determines whether a vehicle will be "found".
Returns:
True if proc returned non-NULL.

Definition at line 371 of file vehicle.cpp.

References VehicleFromPos().

Referenced by CheckRoadBlockedForOvertaking(), EnsureNoTrainOnTrack(), ExploreSegment(), FollowTrainReservation(), HasVehicleOnTunnelBridge(), TrainApproachingCrossing(), and UpdateLevelCrossing().

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

Checks whether a vehicle in on a specific location.

It will call proc for vehicles until it returns non-NULL.

Note:
Use FindVehicleOnPosXY when you have the intention that all vehicles should be iterated over.
Parameters:
x The X location on the map
y The Y location on the map
data Arbitrary data passed to proc
proc The proc that determines whether a vehicle will be "found".
Returns:
True if proc returned non-NULL.

Definition at line 312 of file vehicle.cpp.

References VehicleFromPosXY().

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

Finds vehicle in tunnel / bridge.

Parameters:
tile first end
endtile second end
ignore Ignore this vehicle when searching
Returns:
true if the bridge has a vehicle

Definition at line 184 of file vehicle.cpp.

References GetVehicleTunnelBridgeProc(), and HasVehicleOnPos().

Referenced by ClearPathReservation(), CmdBuildRoad(), CmdConvertRail(), and RemoveRoad().

bool IsEngineCountable ( const Vehicle *  v  ) 

Check if a vehicle is counted in num_engines in each company struct.

Parameters:
*v Vehicle to test
Returns:
true if the vehicle is counted in num_engines

Definition at line 517 of file vehicle.cpp.

References IsArticulatedPart(), IsNormalAircraft(), and IsRearDualheaded().

Referenced by CmdAddVehicleGroup(), SetCachedEngineCounts(), SetTrainGroupID(), and UpdateTrainGroupID().

void MarkSingleVehicleDirty ( const Vehicle *  v  ) 

Marks viewports dirty where the vehicle's image is In fact, it equals BeginVehicleMove(v); EndVehicleMove(v);.

Parameters:
v vehicle to mark dirty
See also:
BeginVehicleMove()

EndVehicleMove()

Definition at line 1147 of file vehicle.cpp.

References MarkAllViewportsDirty().

Referenced by DisasterTick_Ufo(), and InitializeDisasterVehicle().

void ReleaseDisastersTargetingVehicle ( VehicleID  vehicle  ) 

Notify disasters that we are about to delete a vehicle.

So make them head elsewhere.

Parameters:
vehicle deleted vehicle

Definition at line 1031 of file disaster_cmd.cpp.

References RandomTile.

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

Send all vehicles of type to depots.

Parameters:
type type of vehicle
flags the flags used for DoCommand()
service should the vehicles only get service in the depots
owner owner of the vehicles to send
vlw_flag tells what kind of list requested the goto depot
Returns:
0 for success and CMD_ERROR if no vehicle is able to go to depot

Definition at line 517 of file vehicle_cmd.cpp.

References CMD_ERROR, CmdSucceeded(), DC_EXEC, DEPOT_DONT_CANCEL, DoCommand(), GenerateVehicleSortList(), and SmallVector< T, S >::Length().

Referenced by CmdSendAircraftToHangar(), CmdSendRoadVehToDepot(), CmdSendShipToDepot(), and CmdSendTrainToDepot().

void ShowNewGrfVehicleError ( EngineID  engine,
StringID  part1,
StringID  part2,
GRFBugs  bug_type,
bool  critical 
)

Displays a "NewGrf Bug" error message for a engine, and pauses the game if not networking.

Parameters:
engine The engine that caused the problem
part1 Part 1 of the error message, taking the grfname as parameter 1
part2 Part 2 of the error message, taking the engine as parameter 2
bug_type Flag to check and set in grfconfig
critical Shall the "OpenTTD might crash"-message be shown when the player tries to unpause?

Definition at line 114 of file vehicle.cpp.

References GRFConfig::grf_bugs, HasBit(), lastof, GRFConfig::name, SetBit(), and SetDParamStr().

Referenced by CheckConsistencyOfArticulatedVehicle(), and RailVehicleLengthChanged().

void TrainConsistChanged ( Vehicle *  v,
bool  same_length 
)

Recalculates the cached stuff of a train.

Should be called each time a vehicle is added to/removed from the chain, and when the game is loaded. Note: this needs to be called too for 'wagon chains' (in the depot, without an engine)

Parameters:
v First vehicle of the chain.
same_length should length of vehicles stay the same?

Definition at line 216 of file train_cmd.cpp.

References _settings_game, CALLBACK_FAILED, CBID_TRAIN_WAGON_POWER, CBID_VEHICLE_LENGTH, CBM_TRAIN_WAGON_POWER, CBM_VEHICLE_LENGTH, Clamp(), ClrBit(), EF_RAIL_TILTS, GB(), GetRailTypeInfo(), GetVehicleCallback(), HasBit(), InvalidateWindow(), IsArticulatedPart(), IsFreeWagon(), IsFrontEngine(), IsTrainEngine(), IsTrainWagon(), min(), RailtypeInfo::powered_railtypes, RAILTYPE_RAIL, RAILTYPES_NONE, RAILTYPES_RAIL, RAILVEH_WAGON, RailVehicleLengthChanged(), SetBit(), TrainCargoChanged(), UsesWagonOverride(), GameSettings::vehicle, and VehicleSettings::wagon_speed_limits.

Referenced by AfterLoadVehicles(), CmdBuildRailVehicle(), CmdBuildRailWagon(), CmdMoveRailVehicle(), CmdRefitRailVehicle(), CmdSellRailWagon(), DeleteLastWagon(), StateGameLoop(), and TransferCargo().

void TrainPowerChanged ( Vehicle *  v  ) 

Recalculates the cached total power of a train.

Should be called when the consist is changed

Parameters:
v First vehicle of the consist.

Definition at line 88 of file train_cmd.cpp.

References GetRailType(), HasBit(), HasPowerOnRail(), InvalidateWindow(), InvalidateWindowWidget(), IsArticulatedPart(), and IsMultiheaded().

Referenced by SettingsDisableElrail(), TrainCargoChanged(), and UpdateTrainPowerProc().

void VehicleEnteredDepotThisTick ( Vehicle *  v  ) 

Adds a vehicle to the list of vehicles, that visited a depot this tick.

Parameters:
*v vehicle to add

Definition at line 611 of file vehicle.cpp.

void VehicleMove ( Vehicle *  v,
bool  update_viewport 
)

Move a vehicle in the game state; that is moving it's position in the position hashes and marking it's location in the viewport dirty if requested.

Parameters:
v vehicle to move
update_viewport whether to dirty the viewport

Definition at line 1112 of file vehicle.cpp.

References Rect::bottom, Rect::left, MarkAllViewportsDirty(), max(), min(), Rect::right, ST_NORMAL, Rect::top, Point::x, and Point::y.

Referenced by AfterLoadVehicles(), CmdBuildAircraft(), CmdBuildRailVehicle(), CmdBuildRailWagon(), CmdBuildRoadVeh(), CmdBuildShip(), DisasterTick_Helicopter_Rotors(), and InitializeDisasterVehicle().

byte VehicleRandomBits (  ) 

Get a value for a vehicle's random_bits.

Returns:
A random value from 0 to 255.

Definition at line 205 of file vehicle.cpp.

References GB().

Referenced by CmdBuildAircraft(), CmdBuildRailVehicle(), CmdBuildRailWagon(), CmdBuildRoadVeh(), and CmdBuildShip().


Generated on Sun Sep 13 08:19:37 2009 for OpenTTD by  doxygen 1.5.6