# OverrideManagerBase Class Reference

Inheritance diagram for OverrideManagerBase:

## Public Member Functions

| OverrideManagerBase (uint16 offset, uint16 maximum, uint16 invalid)
| Constructor of generic class.
virtual | ~OverrideManagerBase ()
| Destructor of the generic class.
void | ResetOverride ()
| Resets the override, which is used while initializing game.
void | ResetMapping ()
| Resets the mapping, which is used while initializing game.
void | Add (uint8 local_id, uint32 grfid, uint entity_type)
| Since the entity IDs defined by the GRF file does not necessarily correlate to those used by the game, the IDs used for overriding old entities must be translated when the entity spec is set.
virtual uint16 | AddEntityID (byte grf_local_id, uint32 grfid, byte substitute_id)
| Reserves a place in the mapping array for an entity to be installed.
uint16 | GetSubstituteID (uint16 entity_id)
| Gives the substitute of the entity, as specified by the grf file.
virtual uint16 | GetID (uint8 grf_local_id, uint32 grfid)
| Return the ID (if ever available) of a previously inserted entity.
uint16 | GetMaxMapping ()
uint16 | GetMaxOffset ()

## Data Fields

EntityIDMapping * | mapping_ID
| mapping of ids from grf files. Public out of convenience

## Protected Member Functions

virtual bool | CheckValidNewID (uint16 testid)

## Protected Attributes

uint16 * | entity_overrides
uint32 * | grfid_overrides
uint16 | max_offset
| what is the length of the original entity's array of specs
uint16 | max_new_entities
| what is the amount of entities, old and new summed
uint16 | invalid_ID
| ID used to dected invalid entities;.

## Detailed Description

Definition at line 37 of file newgrf_commons.h.

## Constructor & Destructor Documentation

OverrideManagerBase::OverrideManagerBase | ( | uint16 | offset,
|  | uint16 | maximum,
|  | uint16 | invalid |
| ) |  |  |

Constructor of generic class.

Parameters:

  | offset | end of original data for this entity. i.e: houses = 110
  | maximum | of entities this manager can deal with. i.e: houses = 512
  | invalid | is the ID used to identify an invalid entity id

Definition at line 29 of file newgrf_commons.cpp.

References invalid_ID, mapping_ID, max_new_entities, and max_offset.

OverrideManagerBase::~OverrideManagerBase | ( |  | ) | `[virtual]`

Destructor of the generic class.

Frees allocated memory of constructor

Definition at line 44 of file newgrf_commons.cpp.

References mapping_ID.

## Member Function Documentation

void OverrideManagerBase::Add | ( | uint8 | local_id,
|  | uint32 | grfid,
|  | uint | entity_type |
| ) |  |  |

Since the entity IDs defined by the GRF file does not necessarily correlate to those used by the game, the IDs used for overriding old entities must be translated when the entity spec is set.

Parameters:

  | local_id | ID in grf file
  | grfid | ID of the grf file
  | entity_type | original entity type

Definition at line 58 of file newgrf_commons.cpp.

References invalid_ID, and max_offset.

Referenced by TownHouseChangeInfo().

uint16 OverrideManagerBase::AddEntityID | ( | byte | grf_local_id,
|  | uint32 | grfid,
|  | byte | substitute_id |
| ) |  |  | `[virtual]`

Reserves a place in the mapping array for an entity to be installed.

Parameters:

  | grf_local_id | is an arbitrary id given by the grf's author. Also known as setid
  | grfid | is the id of the grf file itself
  | substitute_id | is the original entity from which data is copied for the new one

Returns:
  the proper usable slot id, or invalid marker if none is found

Reimplemented in IndustryOverrideManager.

Definition at line 107 of file newgrf_commons.cpp.

References EntityIDMapping::entity_id, GetID(), EntityIDMapping::grfid, invalid_ID, mapping_ID, max_new_entities, max_offset, and EntityIDMapping::substitute_id.

Referenced by HouseOverrideManager::SetEntitySpec().

uint16 OverrideManagerBase::GetID | ( | uint8 | grf_local_id,
|  | uint32 | grfid |
| ) |  |  | `[virtual]`

Return the ID (if ever available) of a previously inserted entity.

Parameters:

  | grf_local_id | ID of this enity withing the grfID
  | grfid | ID of the grf file

Returns:
  the ID of the candidate, of the Invalid flag item ID

Reimplemented in IndustryOverrideManager.

Definition at line 87 of file newgrf_commons.cpp.

References EntityIDMapping::entity_id, EntityIDMapping::grfid, invalid_ID, mapping_ID, and max_new_entities.

Referenced by AddEntityID(), and HouseGetVariable().

uint16 OverrideManagerBase::GetSubstituteID | ( | uint16 | entity_id | ) |

Gives the substitute of the entity, as specified by the grf file.

Parameters:

  | entity_id | of the entity being queried

Returns:
  mapped id

Definition at line 139 of file newgrf_commons.cpp.

References mapping_ID, and EntityIDMapping::substitute_id.

Referenced by UpdateHousesAndTowns().

The documentation for this class was generated from the following files:

- src/newgrf_commons.h
- src/newgrf_commons.cpp