GUI for trains. More...

#include "stdafx.h"
#include "window_gui.h"
#include "command_func.h"
#include "train.h"
#include "strings_func.h"
#include "vehicle_func.h"
#include "zoom_func.h"
#include "train_cmd.h"
#include "table/strings.h"
#include "safeguards.h"

Data Structures
struct	CargoSummaryItem
	Helper struct for the cargo details information. More...

Typedefs
typedef std::vector< CargoSummaryItem >	CargoSummary
	Container for the cargo summary information.

Functions
void	CcBuildWagon (Commands, const CommandCost &result, VehicleID new_veh_id, uint, uint16_t, CargoArray, TileIndex tile, EngineID, bool, CargoType, ClientID)
	Callback for building wagons.
static int	HighlightDragPosition (int px, int max_width, int y, VehicleID selection, bool chain)
	Highlight the position where a rail vehicle is dragged over by drawing a light gray background.
void	DrawTrainImage (const Train *v, const Rect &r, VehicleID selection, EngineImageType image_type, int skip, VehicleID drag_dest)
	Draws an image of a whole train.
static void	TrainDetailsCargoTab (const CargoSummaryItem *item, int left, int right, int y)
	Draw the details cargo tab for the given vehicle at the given position.
static void	TrainDetailsInfoTab (const Vehicle *v, int left, int right, int y)
	Draw the details info tab for the given vehicle at the given position.
static void	TrainDetailsCapacityTab (const CargoSummaryItem *item, int left, int right, int y)
	Draw the details capacity tab for the given vehicle at the given position.
static void	GetCargoSummaryOfArticulatedVehicle (const Train *v, CargoSummary &summary)
	Collects the cargo transported.
static uint	GetLengthOfArticulatedVehicle (const Train *v)
	Get the length of an articulated vehicle.
int	GetTrainDetailsWndVScroll (VehicleID veh_id, TrainDetailsWindowTabs det_tab)
	Determines the number of lines in the train details window.
void	DrawTrainDetails (const Train *v, const Rect &r, int vscroll_pos, uint16_t vscroll_cap, TrainDetailsWindowTabs det_tab)
	Draw the details for the given vehicle at the given position.

Variables
static const uint	TRAIN_DETAILS_MIN_INDENT = 32
	Minimum indent level in the train details window.
static const uint	TRAIN_DETAILS_MAX_INDENT = 72
	Maximum indent level in the train details window; wider than this and we start on a new line.
static CargoSummary	_cargo_summary
	Reused container of cargo details.

Detailed Description

GUI for trains.

Definition in file train_gui.cpp.

Typedef Documentation

◆ CargoSummary

typedef std::vector<CargoSummaryItem> CargoSummary

Container for the cargo summary information.

Definition at line 199 of file train_gui.cpp.

Function Documentation

◆ CcBuildWagon()

void CcBuildWagon	(	Commands	,
		const CommandCost &	result,
		VehicleID	new_veh_id,
		uint	,
		uint16_t	,
		CargoArray	,
		TileIndex	tile,
		EngineID	,
		bool	,
		CargoType	,
		ClientID	)

Callback for building wagons.

Parameters

result	The result of the command.
new_veh_id	ID of the ne vehicle.
tile	The tile the command was executed on.

Definition at line 29 of file train_gui.cpp.

References CommandCost::Failed(), SpecializedVehicle< Train, Type >::From(), InvalidateWindowClassesData(), Vehicle::IsFrontEngine(), Vehicle::IsStoppedInDepot(), Vehicle::Last(), Vehicle::tile, VEH_TRAIN, and WC_TRAINS_LIST.

◆ DrawTrainDetails()

void DrawTrainDetails	(	const Train *	v,
		const Rect &	r,
		int	vscroll_pos,
		uint16_t	vscroll_cap,
		TrainDetailsWindowTabs	det_tab )

Draw the details for the given vehicle at the given position.

Parameters

v	current vehicle
r	the Rect to draw within
vscroll_pos	Position of scrollbar
vscroll_cap	Number of lines currently displayed
det_tab	Selected details tab

Definition at line 355 of file train_gui.cpp.

References _cargo_summary, _current_text_dir, _settings_game, _sorted_cargo_specs, Crashed, DIR_E, DIR_W, VehicleSpriteSeq::Draw(), DrawString(), EIT_IN_DETAILS, Vehicle::engine_type, FreightWagonMult(), FS_NORMAL, GetCargoSummaryOfArticulatedVehicle(), GetCharacterHeight(), GetColourGradient(), Train::GetDisplayImageWidth(), Engine::GetGRF(), Train::GetImage(), SpecializedVehicle< T, Type >::GetNextVehicle(), GetString(), GetVehiclePalette(), GfxFillRect(), Rect::Height(), Rect::Indent(), Vehicle::IsArticulatedPart(), SpecializedVehicle< T, Type >::Next(), PALETTE_CRASH, Point, Rect, WidgetDimensions::scaled, ScaleSpriteTrad(), TD_RTL, TDW_TAB_CAPACITY, TDW_TAB_CARGO, TDW_TAB_INFO, TDW_TAB_TOTALS, BaseBitSet< Timpl, Tvalue_type, Tstorage, Tmask >::Test(), TRAIN_DETAILS_MAX_INDENT, TRAIN_DETAILS_MIN_INDENT, TrainDetailsCapacityTab(), TrainDetailsCargoTab(), TrainDetailsInfoTab(), GRFFile::traininfo_vehicle_pitch, Vehicle::vehstatus, Rect::WithY(), and Coord2D< T >::x.

Referenced by VehicleDetailsWindow::DrawVehicleDetails().

◆ DrawTrainImage()

void DrawTrainImage	(	const Train *	v,
		const Rect &	r,
		VehicleID	selection,
		EngineImageType	image_type,
		int	skip,
		VehicleID	drag_dest )

Draws an image of a whole train.

Parameters

v	Front vehicle
r	Rect to draw at
selection	Selected vehicle to draw a frame around
image_type	Context where the image is being drawn.
skip	Number of pixels to skip at the front (for scrolling)
drag_dest	The vehicle another one is dragged over, `VehicleID::Invalid()` if none.

Definition at line 99 of file train_gui.cpp.

References _current_text_dir, AddCargoIconOverlay(), BorderOnly, CentreBounds(), Crashed, DIR_E, DIR_W, VehicleSpriteSeq::Draw(), DrawCargoIconOverlays(), DrawFrameRect(), Rect::Expand(), FillDrawPixelInfo(), SpecializedVehicle< Train, Type >::From(), Train::GetDisplayImageWidth(), Train::GetImage(), GetVehiclePalette(), Rect::Height(), HighlightDragPosition(), Vehicle::IsArticulatedPart(), SpecializedVehicle< T, Type >::Next(), PALETTE_CRASH, Point, Rect, WidgetDimensions::scaled, ScaleSpriteTrad(), ShowCargoIconOverlay(), TD_RTL, BaseBitSet< Timpl, Tvalue_type, Tstorage, Tmask >::Test(), Rect::Translate(), Vehicle::vehstatus, Rect::Width(), Coord2D< T >::x, and Coord2D< T >::y.

Referenced by DrawVehicleImage(), and DepotWindow::DrawVehicleInDepot().

◆ GetCargoSummaryOfArticulatedVehicle()

void GetCargoSummaryOfArticulatedVehicle	(	const Train *	v,
		CargoSummary &	summary )

static

Collects the cargo transported.

Parameters

v	Vehicle to process
summary	Space for the result

Definition at line 272 of file train_gui.cpp.

References Engine::CanCarryCargo(), CargoSummaryItem::cargo, Vehicle::cargo, Vehicle::cargo_cap, Vehicle::cargo_type, GetCargoSubtypeText(), Vehicle::GetEngine(), VehicleCargoList::GetFirstStation(), Vehicle::IsArticulatedPart(), IsValidCargoType(), SpecializedVehicle< T, Type >::Next(), VehicleCargoList::StoredCount(), and CargoSummaryItem::subtype.

Referenced by DrawTrainDetails(), and GetTrainDetailsWndVScroll().

◆ GetLengthOfArticulatedVehicle()

uint GetLengthOfArticulatedVehicle ( const Train * v )

static

Get the length of an articulated vehicle.

Parameters

v	the vehicle to get the length of.

Returns: the length in pixels.

Definition at line 304 of file train_gui.cpp.

References Train::GetDisplayImageWidth(), Vehicle::IsArticulatedPart(), and SpecializedVehicle< T, Type >::Next().

Referenced by GetTrainDetailsWndVScroll().

◆ GetTrainDetailsWndVScroll()

int GetTrainDetailsWndVScroll	(	VehicleID	veh_id,
		TrainDetailsWindowTabs	det_tab )

Determines the number of lines in the train details window.

Parameters

veh_id	Train
det_tab	Selected details tab

Returns: Number of line

Definition at line 321 of file train_gui.cpp.

References _cargo_summary, GetCargoSummaryOfArticulatedVehicle(), CargoArray::GetCount(), GetLengthOfArticulatedVehicle(), ScaleSpriteTrad(), TDW_TAB_TOTALS, and TRAIN_DETAILS_MAX_INDENT.

Referenced by VehicleDetailsWindow::OnPaint().

◆ HighlightDragPosition()

int HighlightDragPosition	(	int	px,
		int	max_width,
		int	y,
		VehicleID	selection,
		bool	chain )

static

Highlight the position where a rail vehicle is dragged over by drawing a light gray background.

Parameters

px	The current x position to draw from.
max_width	The maximum space available to draw.
y	The vertical centre position to draw from.
selection	Selected vehicle that is dragged.
chain	Whether a whole chain is dragged.