Base for all engine handling. More...

#include "stdafx.h"
#include "company_func.h"
#include "command_func.h"
#include "news_func.h"
#include "aircraft.h"
#include "newgrf.h"
#include "newgrf_engine.h"
#include "strings_func.h"
#include "core/random_func.hpp"
#include "window_func.h"
#include "autoreplace_gui.h"
#include "string_func.h"
#include "ai/ai.hpp"
#include "core/pool_func.hpp"
#include "engine_gui.h"
#include "engine_func.h"
#include "engine_base.h"
#include "company_base.h"
#include "vehicle_func.h"
#include "articulated_vehicles.h"
#include "error.h"
#include "timer/timer.h"
#include "timer/timer_game_tick.h"
#include "timer/timer_game_calendar.h"
#include "table/strings.h"
#include "table/engines.h"
#include "safeguards.h"

Functions
void	SetupEngines ()
	Initialise the engine pool with the data from the original vehicles.

void	ShowEnginePreviewWindow (EngineID engine)

static bool	IsWagon (EngineID index)
	Determine whether an engine type is a wagon (and not a loco). More...

static void	ClearLastVariant (EngineID engine_id, VehicleType type)
	Ensure engine is not set as the last used variant for any other engine. More...

void	CalcEngineReliability (Engine *e, bool new_month)
	Update Engine::reliability and (if needed) update the engine GUIs. More...

void	SetYearEngineAgingStops ()
	Compute the value for _year_engine_aging_stops.

void	StartupOneEngine (Engine *e, const TimerGameCalendar::YearMonthDay &aging_ymd, uint32_t seed)
	Start/initialise one engine. More...

void	StartupEngines ()
	Start/initialise all our engines. More...

static void	EnableEngineForCompany (EngineID eid, CompanyID company)
	Allows engine eid to be used by a company company. More...

static void	DisableEngineForCompany (EngineID eid, CompanyID company)
	Forbids engine eid to be used by a company company. More...

static void	AcceptEnginePreview (EngineID eid, CompanyID company, int recursion_depth=0)
	Company company accepts engine eid for preview. More...

static CompanyID	GetPreviewCompany (Engine *e)
	Get the best company for an engine preview. More...

static bool	IsVehicleTypeDisabled (VehicleType type, bool ai)
	Checks if a vehicle type is disabled for all/ai companies. More...

void	ClearEnginesHiddenFlagOfCompany (CompanyID cid)
	Clear the 'hidden' flag for all engines of a new company. More...

CommandCost	CmdSetVehicleVisibility (DoCommandFlag flags, EngineID engine_id, bool hide)
	Set the visibility of an engine. More...

CommandCost	CmdWantEnginePreview (DoCommandFlag flags, EngineID engine_id)
	Accept an engine prototype. More...

CommandCost	CmdEngineCtrl (DoCommandFlag flags, EngineID engine_id, CompanyID company_id, bool allow)
	Allow or forbid a specific company to use an engine. More...

static void	NewVehicleAvailable (Engine *e)
	An engine has become available for general use. More...

void	CalendarEnginesMonthlyLoop ()
	Monthly update of the availability, reliability, and preview offers of the engines.

static bool	IsUniqueEngineName (const std::string &name)
	Is name still free as name for an engine? More...

CommandCost	CmdRenameEngine (DoCommandFlag flags, EngineID engine_id, const std::string &text)
	Rename an engine. More...

bool	IsEngineBuildable (EngineID engine, VehicleType type, CompanyID company)
	Check if an engine is buildable. More...

bool	IsEngineRefittable (EngineID engine)
	Check if an engine is refittable. More...

void	CheckEngines ()
	Check for engines that have an appropriate availability.

Variables
EnginePool	_engine_pool ("Engine")

EngineOverrideManager	_engine_mngr

static TimerGameCalendar::Year	_year_engine_aging_stops
	Year that engine aging stops. More...

const uint8_t	_engine_counts [4]
	Number of engines of each vehicle type in original engine data. More...

const uint8_t	_engine_offsets [4]
	Offset of the first engine of each vehicle type in original engine data. More...

static IntervalTimer< TimerGameCalendar >	_calendar_engines_daily ({TimerGameCalendar::DAY, TimerGameCalendar::Priority::ENGINE}, [](auto) { for(Company c :Company::Iterate()) { c->avail_railtypes=AddDateIntroducedRailTypes(c->avail_railtypes, TimerGameCalendar::date);c->avail_roadtypes=AddDateIntroducedRoadTypes(c->avail_roadtypes, TimerGameCalendar::date);} if(TimerGameCalendar::year >=_year_engine_aging_stops) return;for(Engine e :Engine::Iterate()) { EngineID i=e->index;if(e->flags &ENGINE_EXCLUSIVE_PREVIEW) { if(e->preview_company !=INVALID_COMPANY) { if(!--e->preview_wait) { CloseWindowById(WC_ENGINE_PREVIEW, i);e->preview_company=INVALID_COMPANY;} } else if(CountBits(e->preview_asked)< MAX_COMPANIES) { e->preview_company=GetPreviewCompany(e);if(e->preview_company==INVALID_COMPANY) { e->preview_asked=MAX_UVALUE(CompanyMask);continue;} SetBit(e->preview_asked, e->preview_company);e->preview_wait=20;if(!IsVehicleTypeDisabled(e->type, true)) AI::NewEvent(e->preview_company, new ScriptEventEnginePreview(i));if(IsInteractiveCompany(e->preview_company)) ShowEnginePreviewWindow(i);} } } })
	Daily check to offer an exclusive engine preview to the companies.

static IntervalTimer< TimerGameCalendar >	_calendar_engines_monthly ({TimerGameCalendar::MONTH, TimerGameCalendar::Priority::ENGINE}, [](auto) { CalendarEnginesMonthlyLoop();})

Detailed Description

Base for all engine handling.

Definition in file engine.cpp.

Function Documentation

◆ AcceptEnginePreview()

static void AcceptEnginePreview	(	EngineID	eid,
		CompanyID	company,
		int	recursion_depth = `0`
	)

static

Company company accepts engine eid for preview.

Parameters

eid	Engine being accepted (is under preview).
company	Current company previewing the engine.
recursion_depth	Recursion depth to avoid infinite loop.

Definition at line 847 of file engine.cpp.

References EnableEngineForCompany(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_engine_pool >::Get(), HasFlag(), INVALID_COMPANY, InvalidateWindowData(), Engine::IterateType(), JoinPreview, MAX_UVALUE, Engine::preview_asked, Engine::preview_company, Engine::type, and WC_ENGINE_PREVIEW.

Referenced by CmdWantEnginePreview().

◆ CalcEngineReliability()

void CalcEngineReliability	(	Engine *	e,
		bool	new_month
	)

Update Engine::reliability and (if needed) update the engine GUIs.

Parameters

e	Engine to update.

Definition at line 611 of file engine.cpp.

References _settings_game, AddRemoveEngineFromAutoreplaceAndBuildWindows(), Engine::age, EngineInfo::base_life, ClearLastVariant(), Engine::company_avail, Engine::duration_phase_1, Engine::duration_phase_2, Engine::duration_phase_3, Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_engine_pool >::Get(), HasFlag(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem< Tpool >::index, INVALID_ENGINE, VehicleSettings::never_expire_vehicles, Engine::reliability, Engine::reliability_final, Engine::reliability_max, Engine::reliability_start, EngineInfo::retire_early, SyncReliability, Engine::type, EngineInfo::variant_id, and GameSettings::vehicle.

Referenced by CalendarEnginesMonthlyLoop().

◆ ClearEnginesHiddenFlagOfCompany()

void ClearEnginesHiddenFlagOfCompany ( CompanyID cid )

Clear the 'hidden' flag for all engines of a new company.

Parameters

cid	Company being created.

Definition at line 969 of file engine.cpp.

References Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_engine_pool >::Iterate(), and SB().

◆ ClearLastVariant()

static void ClearLastVariant	(	EngineID	engine_id,
		VehicleType	type
	)

static

Ensure engine is not set as the last used variant for any other engine.

Parameters

engine_id	Engine being removed.
type	Type of engine.

Definition at line 600 of file engine.cpp.

References INVALID_ENGINE, and Engine::IterateType().

Referenced by CalcEngineReliability(), and DisableEngineForCompany().

◆ CmdEngineCtrl()

CommandCost CmdEngineCtrl	(	DoCommandFlag	flags,
		EngineID	engine_id,
		CompanyID	company_id,
		bool	allow
	)

Allow or forbid a specific company to use an engine.

Parameters

flags	operation to perform
engine_id	engine id
company_id	Company to allow/forbid the use of an engine.
allow	false to forbid, true to allow.

Returns: the cost of this operation or an error

Definition at line 1022 of file engine.cpp.

References _current_company, CMD_ERROR, DC_EXEC, DisableEngineForCompany(), EnableEngineForCompany(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_company_pool >::IsValidID(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_engine_pool >::IsValidID(), and OWNER_DEITY.

◆ CmdRenameEngine()

CommandCost CmdRenameEngine	(	DoCommandFlag	flags,
		EngineID	engine_id,
		const std::string &	text
	)

Rename an engine.

Parameters

flags	operation to perform
engine_id	engine ID to rename
text	the new name or an empty string when resetting to the default

Returns: the cost of this operation or an error

Definition at line 1184 of file engine.cpp.

References CMD_ERROR, DC_EXEC, Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_engine_pool >::GetIfValid(), IsUniqueEngineName(), MarkWholeScreenDirty(), MAX_LENGTH_ENGINE_NAME_CHARS, Engine::name, return_cmd_error, and Utf8StringLength().

◆ CmdSetVehicleVisibility()

CommandCost CmdSetVehicleVisibility	(	DoCommandFlag	flags,
		EngineID	engine_id,
		bool	hide
	)

Set the visibility of an engine.

Parameters

flags	Operation to perform.
engine_id	Engine id..
hide	Set for hidden, unset for visible.

Returns: The cost of this operation or an error.

Definition at line 983 of file engine.cpp.

References _current_company, AddRemoveEngineFromAutoreplaceAndBuildWindows(), AssignBit(), CMD_ERROR, Engine::company_hidden, DC_EXEC, Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_engine_pool >::GetIfValid(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem< Tpool >::index, IsEngineBuildable(), MAX_COMPANIES, and Engine::type.

◆ CmdWantEnginePreview()

CommandCost CmdWantEnginePreview	(	DoCommandFlag	flags,
		EngineID	engine_id
	)

Accept an engine prototype.

XXX - it is possible that the top-company changes while you are waiting to accept the offer? Then it becomes invalid

Parameters

flags	operation to perform
engine_id	engine-prototype offered

Returns: the cost of this operation or an error

Definition at line 1004 of file engine.cpp.

References _current_company, AcceptEnginePreview(), CMD_ERROR, DC_EXEC, ENGINE_EXCLUSIVE_PREVIEW, Engine::flags, Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_engine_pool >::GetIfValid(), and Engine::preview_company.

◆ DisableEngineForCompany()

static void DisableEngineForCompany	(	EngineID	eid,
		CompanyID	company
	)

static

Forbids engine eid to be used by a company company.

Parameters

eid	The engine to disable.
company	The company to forbid using the engine.

Definition at line 823 of file engine.cpp.

References _local_company, AddRemoveEngineFromAutoreplaceAndBuildWindows(), Company::avail_railtypes, Company::avail_roadtypes, ClearLastVariant(), ClrBit(), Engine::company_avail, Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_engine_pool >::Get(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_company_pool >::Get(), GetCompanyRailTypes(), GetCompanyRoadTypes(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem< Tpool >::index, Engine::type, VEH_ROAD, and VEH_TRAIN.

Referenced by CmdEngineCtrl().

◆ EnableEngineForCompany()

static void EnableEngineForCompany	(	EngineID	eid,
		CompanyID	company
	)

static

Allows engine eid to be used by a company company.

Parameters

eid	The engine to enable.
company	The company to allow using the engine.

Definition at line 795 of file engine.cpp.

References _local_company, AddRemoveEngineFromAutoreplaceAndBuildWindows(), Company::avail_railtypes, Company::avail_roadtypes, Engine::company_avail, Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_engine_pool >::Get(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_company_pool >::Get(), GetCompanyRailTypes(), GetCompanyRoadTypes(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem< Tpool >::index, InvalidateWindowData(), SetBit(), TRANSPORT_AIR, TRANSPORT_ROAD, TRANSPORT_WATER, Engine::type, VEH_AIRCRAFT, VEH_ROAD, VEH_SHIP, VEH_TRAIN, WC_BUILD_TOOLBAR, and WC_MAIN_TOOLBAR.

Referenced by AcceptEnginePreview(), and CmdEngineCtrl().

◆ GetPreviewCompany()

static CompanyID GetPreviewCompany ( Engine * e )

static

Get the best company for an engine preview.

Parameters

e	Engine to preview.

Returns: Best company if it exists, INVALID_COMPANY otherwise.

Definition at line 879 of file engine.cpp.

References GetUnionOfArticulatedRefitMasks(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem< Tpool >::index, INVALID_COMPANY, Engine::type, and VEH_TRAIN.

◆ IsEngineBuildable()

bool IsEngineBuildable	(	EngineID	engine,
		VehicleType	type,
		CompanyID	company
	)

Check if an engine is buildable.

Parameters

engine	index of the engine to check.
type	the type the engine should be.
company	index of the company.

Returns: True if an engine is valid, of the specified type, and buildable by the given company.

Definition at line 1218 of file engine.cpp.

References Company::avail_railtypes, Company::avail_roadtypes, Engine::company_avail, ENGINE_AVAILABLE, Engine::flags, Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_company_pool >::Get(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_engine_pool >::GetIfValid(), GetRailTypeInfo(), GetRoadTypeInfo(), HasBit(), Engine::IsEnabled(), OWNER_DEITY, RoadTypeInfo::powered_roadtypes, RailVehicleInfo::railtype, RoadVehicleInfo::roadtype, ROADTYPES_NONE, Engine::type, VEH_ROAD, and VEH_TRAIN.

Referenced by CheckAutoreplaceValidity(), CmdBuildVehicle(), CmdSetVehicleVisibility(), and GetNewEngineType().

◆ IsEngineRefittable()

bool IsEngineRefittable ( EngineID engine )

Check if an engine is refittable.

Note: Likely you want to use IsArticulatedVehicleRefittable().

Parameters

engine index of the engine to check.

Returns: true if the engine is refittable.

Definition at line 1259 of file engine.cpp.

References EngineInfo::callback_mask, Engine::CanCarryCargo(), CBM_VEHICLE_CARGO_SUFFIX, Engine::GetDefaultCargoType(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_engine_pool >::GetIfValid(), HasBit(), IsValidCargoID(), and SetBit().

Referenced by IsArticulatedVehicleRefittable(), IsVehicleRefitable(), and OrdersWindow::UpdateAutoRefitState().

◆ IsUniqueEngineName()

static bool IsUniqueEngineName ( const std::string & name )

static

Is name still free as name for an engine?

Parameters

name	New name of an engine.

Returns: false if the name is being used already, else true.

Definition at line 1168 of file engine.cpp.

References Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_engine_pool >::Iterate().

Referenced by CmdRenameEngine().

◆ IsVehicleTypeDisabled()

static bool IsVehicleTypeDisabled	(	VehicleType	type,
		bool	ai
	)

static

Checks if a vehicle type is disabled for all/ai companies.

Parameters

type	The vehicle type which shall be checked.
ai	If true, check if the type is disabled for AI companies, otherwise check if the vehicle type is disabled for human companies.

Returns: Whether or not a vehicle type is disabled.

Definition at line 913 of file engine.cpp.

References _settings_game, GameSettings::ai, AISettings::ai_disable_veh_aircraft, AISettings::ai_disable_veh_roadveh, AISettings::ai_disable_veh_ship, AISettings::ai_disable_veh_train, VehicleSettings::max_aircraft, VehicleSettings::max_roadveh, VehicleSettings::max_ships, VehicleSettings::max_trains, VEH_AIRCRAFT, VEH_ROAD, VEH_SHIP, VEH_TRAIN, and GameSettings::vehicle.

Referenced by CalendarEnginesMonthlyLoop(), and NewVehicleAvailable().

◆ IsWagon()

static bool IsWagon ( EngineID index )

static

Determine whether an engine type is a wagon (and not a loco).

Parameters

index Engine getting queried.

Returns: Whether the queried engine is a wagon.

Definition at line 589 of file engine.cpp.

References Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_engine_pool >::Get(), RAILVEH_WAGON, Engine::type, and VEH_TRAIN.

Referenced by CalendarEnginesMonthlyLoop(), and NewVehicleAvailable().

◆ NewVehicleAvailable()

static void NewVehicleAvailable ( Engine * e )

static

An engine has become available for general use.

Also handle the exclusive engine preview contract.

Parameters

e	Engine generally available as of now.

Definition at line 1044 of file engine.cpp.

References AddDateIntroducedRailTypes(), AddDateIntroducedRoadTypes(), AddNewsItem(), AddRemoveEngineFromAutoreplaceAndBuildWindows(), AI::BroadcastNewEvent(), CloseWindowById(), Engine::company_avail, TimerGameCalendar::date, ENGINE_AVAILABLE, ENGINE_EXCLUSIVE_PREVIEW, Engine::flags, SpecializedVehicle< Aircraft, VEH_AIRCRAFT >::From(), GetEngineCategoryName(), GetRailTypeInfo(), GetRoadTypeInfo(), HasBit(), HasFlag(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem< Tpool >::index, RailTypeInfo::introduces_railtypes, RoadTypeInfo::introduces_roadtypes, InvalidateWindowData(), Aircraft::IsNormalAircraft(), IsVehicleTypeDisabled(), IsWagon(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_vehicle_pool >::Iterate(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_company_pool >::Iterate(), MAX_UVALUE, NF_VEHICLE, NoNews, NR_ENGINE, NT_NEW_VEHICLES, PackEngineNameDParam(), PreviewNews, RailVehicleInfo::railtype, RAILTYPE_END, RoadVehicleInfo::roadtype, ROADTYPE_END, SetDParam(), TRANSPORT_AIR, TRANSPORT_ROAD, TRANSPORT_WATER, Engine::type, VEH_AIRCRAFT, VEH_ROAD, VEH_SHIP, VEH_TRAIN, WC_BUILD_TOOLBAR, and WC_ENGINE_PREVIEW.

Referenced by CalendarEnginesMonthlyLoop().

◆ StartupEngines()

void StartupEngines ( )

Start/initialise all our engines.

Must be called whenever there are changes to the NewGRF config.

Definition at line 763 of file engine.cpp.

References _year_engine_aging_stops, TimerGameCalendar::ConvertDateToYMD(), TimerGameCalendar::ConvertYMDToDate(), and TimerGameCalendar::date.

Referenced by DEF_CONSOLE_CMD().

◆ StartupOneEngine()

void StartupOneEngine	(	Engine *	e,
		const TimerGameCalendar::YearMonthDay &	aging_ymd,
		uint32_t	seed
	)

Start/initialise one engine.

Parameters

e	The engine to initialise.
aging_date	The date used for age calculations.
seed	Random seed.

Definition at line 682 of file engine.cpp.

References _settings_game, Engine::age, EngineInfo::base_intro, Engine::company_avail, Engine::company_hidden, Engine::flags, GameSettings::game_creation, GameCreationSettings::generation_seed, Engine::GetGRFID(), SaveRandomSeeds(), SetRandomSeed(), and Engine::type.

Variable Documentation

◆ _engine_counts

const uint8_t _engine_counts[4]

Initial value:

= {
  lengthof(_orig_rail_vehicle_info),
  lengthof(_orig_road_vehicle_info),
  lengthof(_orig_ship_vehicle_info),
  lengthof(_orig_aircraft_vehicle_info),
}

Number of engines of each vehicle type in original engine data.

Definition at line 53 of file engine.cpp.

Referenced by EngineOverrideManager::ResetToDefaultMapping().

◆ _engine_offsets

const uint8_t _engine_offsets[4]

Initial value:

= {
  0,
  lengthof(_orig_rail_vehicle_info),
  lengthof(_orig_rail_vehicle_info) + lengthof(_orig_road_vehicle_info),
  lengthof(_orig_rail_vehicle_info) + lengthof(_orig_road_vehicle_info) + lengthof(_orig_ship_vehicle_info),
}

Offset of the first engine of each vehicle type in original engine data.

Definition at line 61 of file engine.cpp.

◆ _year_engine_aging_stops

TimerGameCalendar::Year _year_engine_aging_stops

static

Year that engine aging stops.

Engines will not reduce in reliability and no more engines will be introduced

Definition at line 50 of file engine.cpp.

Referenced by CalendarEnginesMonthlyLoop(), SetYearEngineAgingStops(), and StartupEngines().

Functions

Variables

Detailed Description

Function Documentation

◆ AcceptEnginePreview()

◆ CalcEngineReliability()

◆ ClearEnginesHiddenFlagOfCompany()

◆ ClearLastVariant()

◆ CmdEngineCtrl()

◆ CmdRenameEngine()

◆ CmdSetVehicleVisibility()

◆ CmdWantEnginePreview()

◆ DisableEngineForCompany()

◆ EnableEngineForCompany()

◆ GetPreviewCompany()

◆ IsEngineBuildable()

◆ IsEngineRefittable()

◆ IsUniqueEngineName()

◆ IsVehicleTypeDisabled()

◆ IsWagon()

◆ NewVehicleAvailable()

◆ StartupEngines()

◆ StartupOneEngine()

Variable Documentation

◆ _engine_counts

◆ _engine_offsets

◆ _year_engine_aging_stops