OpenTTD Source  20241108-master-g80f628063a
autoreplace_func.h File Reference

Functions related to autoreplacing. More...

#include "command_type.h"
#include "company_base.h"

Go to the source code of this file.

Functions

void RemoveAllEngineReplacement (EngineRenewList *erl)
 Remove all engine replacement settings for the company. More...
 
EngineID EngineReplacement (EngineRenewList erl, EngineID engine, GroupID group, bool *replace_when_old=nullptr)
 Retrieve the engine replacement in a given renewlist for an original engine type. More...
 
CommandCost AddEngineReplacement (EngineRenewList *erl, EngineID old_engine, EngineID new_engine, GroupID group, bool replace_when_old, DoCommandFlag flags)
 Add an engine replacement to the given renewlist. More...
 
CommandCost RemoveEngineReplacement (EngineRenewList *erl, EngineID engine, GroupID group, DoCommandFlag flags)
 Remove an engine replacement from a given renewlist. More...
 
void RemoveAllEngineReplacementForCompany (Company *c)
 Remove all engine replacement settings for the given company. More...
 
EngineID EngineReplacementForCompany (const Company *c, EngineID engine, GroupID group, bool *replace_when_old=nullptr)
 Retrieve the engine replacement for the given company and original engine type. More...
 
bool EngineHasReplacementForCompany (const Company *c, EngineID engine, GroupID group)
 Check if a company has a replacement set up for the given engine. More...
 
bool EngineHasReplacementWhenOldForCompany (const Company *c, EngineID engine, GroupID group)
 Check if a company has a replacement set up for the given engine when it gets old. More...
 
CommandCost AddEngineReplacementForCompany (Company *c, EngineID old_engine, EngineID new_engine, GroupID group, bool replace_when_old, DoCommandFlag flags)
 Add an engine replacement for the company. More...
 
CommandCost RemoveEngineReplacementForCompany (Company *c, EngineID engine, GroupID group, DoCommandFlag flags)
 Remove an engine replacement for the company. More...
 
bool CheckAutoreplaceValidity (EngineID from, EngineID to, CompanyID company)
 Checks some basic properties whether autoreplace is allowed. More...
 

Detailed Description

Functions related to autoreplacing.

Definition in file autoreplace_func.h.

Function Documentation

◆ AddEngineReplacement()

CommandCost AddEngineReplacement ( EngineRenewList erl,
EngineID  old_engine,
EngineID  new_engine,
GroupID  group,
bool  replace_when_old,
DoCommandFlag  flags 
)

Add an engine replacement to the given renewlist.

Parameters
erlThe renewlist to add to.
old_engineThe original engine type.
new_engineThe replacement engine type.
groupThe group related to this replacement.
replace_when_oldReplace when old or always?
flagsThe calling command flags.
Returns
0 on success, CMD_ERROR on failure.

Definition at line 97 of file autoreplace.cpp.

References Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_enginerenew_pool >::CanAllocateItem(), CMD_ERROR, DC_EXEC, GetEngineReplacement(), and EngineRenew::replace_when_old.

Referenced by AddEngineReplacementForCompany().

◆ AddEngineReplacementForCompany()

CommandCost AddEngineReplacementForCompany ( Company c,
EngineID  old_engine,
EngineID  new_engine,
GroupID  group,
bool  replace_when_old,
DoCommandFlag  flags 
)
inline

Add an engine replacement for the company.

Parameters
cCompany.
old_engineThe original engine type.
new_engineThe replacement engine type.
groupThe group related to this replacement.
replace_when_oldReplace when old or always?
flagsThe calling command flags.
Returns
0 on success, CMD_ERROR on failure.

Definition at line 80 of file autoreplace_func.h.

References AddEngineReplacement(), and CompanyProperties::engine_renew_list.

◆ CheckAutoreplaceValidity()

◆ EngineHasReplacementForCompany()

bool EngineHasReplacementForCompany ( const Company c,
EngineID  engine,
GroupID  group 
)
inline

Check if a company has a replacement set up for the given engine.

Parameters
cCompany.
engineEngine type to be replaced.
groupThe group related to this replacement.
Returns
true if a replacement was set up, false otherwise.

Definition at line 51 of file autoreplace_func.h.

References EngineReplacementForCompany(), and INVALID_ENGINE.

Referenced by AgeVehicle(), and ReplaceVehicleWindow::OnPaint().

◆ EngineHasReplacementWhenOldForCompany()

bool EngineHasReplacementWhenOldForCompany ( const Company c,
EngineID  engine,
GroupID  group 
)
inline

Check if a company has a replacement set up for the given engine when it gets old.

Parameters
cCompany.
engineEngine type to be replaced.
groupThe group related to this replacement.
Returns
True if a replacement when old was set up, false otherwise.

Definition at line 63 of file autoreplace_func.h.

References CompanyProperties::engine_renew_list, and EngineReplacement().

◆ EngineReplacement()

EngineID EngineReplacement ( EngineRenewList  erl,
EngineID  engine,
GroupID  group,
bool *  replace_when_old 
)

Retrieve the engine replacement in a given renewlist for an original engine type.

Parameters
erlThe renewlist to search in.
engineEngine type to be replaced.
groupThe group related to this replacement.
[out]replace_when_oldSet to true if the replacement should be done when old.
Returns
The engine type to replace with, or INVALID_ENGINE if no replacement is in the list.

Definition at line 65 of file autoreplace.cpp.

References ALL_GROUP, DEFAULT_GROUP, Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_group_pool >::Get(), GetEngineReplacement(), GF_REPLACE_PROTECTION, HasBit(), INVALID_ENGINE, Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_group_pool >::IsValidID(), and EngineRenew::replace_when_old.

Referenced by EngineHasReplacementWhenOldForCompany(), and EngineReplacementForCompany().

◆ EngineReplacementForCompany()

EngineID EngineReplacementForCompany ( const Company c,
EngineID  engine,
GroupID  group,
bool *  replace_when_old = nullptr 
)
inline

Retrieve the engine replacement for the given company and original engine type.

Parameters
ccompany.
engineEngine type.
groupThe group related to this replacement.
[out]replace_when_oldSet to true if the replacement should be done when old.
Returns
The engine type to replace with, or INVALID_ENGINE if no replacement is in the list.

Definition at line 39 of file autoreplace_func.h.

References CompanyProperties::engine_renew_list, and EngineReplacement().

Referenced by EngineHasReplacementForCompany(), ReplaceVehicleWindow::GenerateLists(), ReplaceVehicleWindow::GenerateReplaceVehList(), GetNewEngineType(), Vehicle::NeedsServicing(), and ReplaceVehicleWindow::OnPaint().

◆ RemoveAllEngineReplacement()

void RemoveAllEngineReplacement ( EngineRenewList erl)

Remove all engine replacement settings for the company.

Parameters
erlThe renewlist for a given company.
Returns
The new renewlist for the company.

Definition at line 43 of file autoreplace.cpp.

Referenced by RemoveAllEngineReplacementForCompany().

◆ RemoveAllEngineReplacementForCompany()

void RemoveAllEngineReplacementForCompany ( Company c)
inline

Remove all engine replacement settings for the given company.

Parameters
cthe company.

Definition at line 25 of file autoreplace_func.h.

References CompanyProperties::engine_renew_list, and RemoveAllEngineReplacement().

Referenced by ChangeOwnershipOfCompanyItems().

◆ RemoveEngineReplacement()

CommandCost RemoveEngineReplacement ( EngineRenewList erl,
EngineID  engine,
GroupID  group,
DoCommandFlag  flags 
)

Remove an engine replacement from a given renewlist.

Parameters
erlThe renewlist from which to remove the replacement
engineThe original engine type.
groupThe group related to this replacement.
flagsThe calling command flags.
Returns
0 on success, CMD_ERROR on failure.

Definition at line 132 of file autoreplace.cpp.

References CMD_ERROR, and DC_EXEC.

Referenced by RemoveEngineReplacementForCompany().

◆ RemoveEngineReplacementForCompany()

CommandCost RemoveEngineReplacementForCompany ( Company c,
EngineID  engine,
GroupID  group,
DoCommandFlag  flags 
)
inline

Remove an engine replacement for the company.

Parameters
cCompany.
engineThe original engine type.
groupThe group related to this replacement.
flagsThe calling command flags.
Returns
0 on success, CMD_ERROR on failure.

Definition at line 93 of file autoreplace_func.h.

References CompanyProperties::engine_renew_list, and RemoveEngineReplacement().

Referenced by CmdDeleteGroup().