28 static std::vector<HouseClassMapping> _class_mapping{};
44 std::vector<HouseSpec> _house_specs;
61 return static_cast<HouseID>(
this - _house_specs.data());
75 if (house_id >= _house_specs.size())
return ∅
76 return &_house_specs[house_id];
107 CallbackID callback, uint32_t param1, uint32_t param2,
108 bool not_yet_constructed, uint8_t initial_random_bits, CargoTypes watched_cargo_triggers,
int view)
110 house_scope(*this, house_id, tile, town, not_yet_constructed, initial_random_bits, watched_cargo_triggers, view),
111 town_scope(*this, town, not_yet_constructed)
129 void ResetHouseClassIDs()
131 _class_mapping.clear();
134 _class_mapping.emplace_back();
137 HouseClassID AllocateHouseClassID(uint8_t grf_class_id, uint32_t grfid)
140 auto it = std::find_if(std::next(std::begin(_class_mapping)), std::end(_class_mapping), [grf_class_id, grfid](
const HouseClassMapping &map) {
return map.
class_id == grf_class_id && map.
grfid == grfid; });
143 if (it == std::end(_class_mapping)) it = _class_mapping.insert(it, {.grfid = grfid, .class_id = grf_class_id});
145 return static_cast<HouseClassID>(std::distance(std::begin(_class_mapping), it));
165 _building_counts.id_count.clear();
166 _building_counts.class_count.clear();
168 _building_counts.class_count.resize(_class_mapping.size());
181 return _building_counts.id_count;
195 _building_counts.id_count[house_id]++;
197 if (class_id == HOUSE_NO_CLASS)
return;
200 _building_counts.class_count[class_id]++;
214 if (_building_counts.id_count[house_id] > 0) _building_counts.id_count[house_id]--;
216 if (class_id == HOUSE_NO_CLASS)
return;
219 if (_building_counts.class_count[class_id] > 0) _building_counts.class_count[class_id]--;
234 static uint32_t GetNumHouses(
HouseID house_id,
const Town *town)
238 uint8_t map_id_count = ClampTo<uint8_t>(_building_counts.id_count[house_id]);
239 uint8_t map_class_count = ClampTo<uint8_t>(_building_counts.class_count[class_id]);
243 return map_class_count << 24 | town_class_count << 16 | map_id_count << 8 | town_id_count;
280 if (north_tile == nbhd->
north_tile)
return false;
304 if (north_tile == nbhd->
north_tile)
return false;
328 if (north_tile == nbhd->
north_tile)
return false;
354 uint8_t searchtype =
GB(parameter, 6, 2);
355 uint8_t searchradius =
GB(parameter, 0, 6);
356 if (searchtype >=
lengthof(search_procs))
return 0;
357 if (searchradius < 1)
return 0;
364 if (
CircularTileSearch(&found_tile, 2 * searchradius + 1, search_procs[searchtype], &nbhd)) {
392 case 0x66:
return 0xFFFFFFFF;
396 Debug(grf, 1,
"Unhandled house variable 0x{:X}", variable);
415 case 0x44:
return GetNumHouses(this->
house_id, this->
town);
435 return new_house == INVALID_HOUSE_ID ? 0 : GetNumHouses(new_house, this->
town);
486 if (hs->
class_id != HOUSE_NO_CLASS) {
488 houseclass |= _class_mapping[hs->
class_id].class_id;
491 uint local_houseid = 0;
493 local_houseid = nearby_house_id;
498 return houseclass << 16 | local_houseid;
513 Debug(grf, 1,
"Unhandled house variable 0x{:X}", variable);
520 bool not_yet_constructed, uint8_t initial_random_bits, CargoTypes watched_cargo_triggers,
int view)
523 not_yet_constructed, initial_random_bits, watched_cargo_triggers, view);
524 return object.ResolveCallback();
537 palette =
HasBit(callback, 14) ?
GB(callback, 0, 8) + SPR_2CCMAP_BASE : callback;
559 bool draw_old_one =
true;
572 if (group !=
nullptr && group->type == SGT_TILELAYOUT) {
581 uint16_t GetSimpleHouseCallback(
CallbackID callback, uint32_t param1, uint32_t param2,
const HouseSpec *spec,
Town *town,
TileIndex tile, CargoTypes extra_data)
583 return GetHouseCallback(callback, param1, param2, spec -
HouseSpec::Get(0), town, tile,
false, 0, extra_data);
598 if (hs ==
nullptr)
return;
603 void AnimateNewHouseConstruction(
TileIndex tile)
630 static void AnimationControl(
TileIndex tile, uint16_t random_bits)
649 TriggerHouse(tile, HOUSE_TRIGGER_TILE_LOOP);
650 if (hs->
building_flags & BUILDING_HAS_1_TILE) TriggerHouse(tile, HOUSE_TRIGGER_TILE_LOOP_TOP);
658 uint16_t random =
GB(Random(), 0, 16);
660 if (hs->
building_flags & BUILDING_HAS_1_TILE) AnimationControl(tile, random);
665 AnimationControl(tile, 0);
683 static void DoTriggerHouse(
TileIndex tile, HouseTrigger trigger, uint8_t base_random,
bool first)
698 if (group ==
nullptr)
return;
704 uint8_t new_random_bits = Random();
706 uint32_t reseed =
object.GetReseedSum();
707 random_bits &= ~reseed;
708 random_bits |= (first ? new_random_bits : base_random) & reseed;
712 case HOUSE_TRIGGER_TILE_LOOP:
716 case HOUSE_TRIGGER_TILE_LOOP_TOP:
723 if (hs->
building_flags & BUILDING_2_TILES_Y) DoTriggerHouse(
TileAddXY(tile, 0, 1), trigger, random_bits,
false);
724 if (hs->
building_flags & BUILDING_2_TILES_X) DoTriggerHouse(
TileAddXY(tile, 1, 0), trigger, random_bits,
false);
725 if (hs->
building_flags & BUILDING_HAS_4_TILES) DoTriggerHouse(
TileAddXY(tile, 1, 1), trigger, random_bits,
false);
730 void TriggerHouse(
TileIndex t, HouseTrigger trigger)
732 DoTriggerHouse(t, trigger, 0,
true);
745 uint32_t cb_info = random << 16 | (uint8_t)diff.
y << 8 | (uint8_t)diff.
x;
763 if (trigger_cargoes == 0)
return;
766 uint16_t r = Random();
constexpr debug_inline bool HasBit(const T x, const uint8_t y)
Checks if a bit in a value is set.
constexpr T SetBit(T &x, const uint8_t y)
Set a bit in a variable.
constexpr static debug_inline uint GB(const T x, const uint8_t s, const uint8_t n)
Fetch n bits from x, started at bit s.
uint8_t CargoID
Cargo slots to indicate a cargo type within a game.
bool IsValidCargoID(CargoID t)
Test whether cargo type is not INVALID_CARGO.
uint32_t GetGRFID(uint16_t entity_id) const
Gives the GRFID of the file the entity belongs to.
virtual uint16_t GetID(uint16_t grf_local_id, uint32_t grfid) const
Return the ID (if ever available) of a previously inserted entity.
void ResetOverride()
Resets the override, which is used while initializing game.
Structure contains cached list of stations nearby.
const StationList * GetStations()
Run a tile loop to find stations around a tile, on demand.
Definition of stuff that is very close to a company, like the company struct itself.
CompanyID _current_company
Company currently doing an action.
Functions related to companies.
@ OWNER_NONE
The tile has no ownership.
@ OWNER_WATER
The tile/execution is done by "water".
Functions related to debugging.
#define Debug(category, level, format_string,...)
Ouptut a line of debugging information.
constexpr debug_inline bool HasFlag(const T x, const T y)
Checks if a value in a bitset enum is set.
bool _generating_world
Whether we are generating the map or not.
Functions related to world/map generation.
uint32_t SpriteID
The number of a sprite, without mapping bits and colourtables.
uint32_t PaletteID
The number of the palette.
void MarkTileDirtyByTile(TileIndex tile, int bridge_level_offset, int tile_height_override)
Mark a tile given by its index dirty for repaint.
static const HouseID NUM_HOUSES
Total number of houses.
static const HouseID NEW_HOUSE_OFFSET
Offset for new houses.
static const uint8_t TOWN_HOUSE_COMPLETED
Simple value that indicates the house has reached the final stage of construction.
@ BUILDING_IS_PROTECTED
towns and AI will not remove this house, while human players will be able to
@ SYNCHRONISED_CALLBACK_1B
synchronized callback 1B will be performed, on multi tile houses
@ CALLBACK_1A_RANDOM_BITS
callback 1A needs random bits
uint16_t HouseClassID
Classes of houses.
uint16_t HouseID
OpenTTD ID of house types.
void DrawFoundation(TileInfo *ti, Foundation f)
Draw foundation f at tile ti.
Functions related to OTTD's landscape.
bool CircularTileSearch(TileIndex *tile, uint size, TestTileOnSearchProc proc, void *user_data)
Function performing a search around a center tile and going outward, thus in circle.
uint DistanceManhattan(TileIndex t0, TileIndex t1)
Gets the Manhattan distance between the two given tiles.
TileIndex TileAddXY(TileIndex tile, int x, int y)
Adds a given offset to a tile.
TileIndexDiff TileDiffXY(int x, int y)
Calculates an offset for the given coordinate(-offset).
bool TestTileOnSearchProc(TileIndex tile, void *user_data)
A callback function type for searching tiles.
static debug_inline uint TileY(TileIndex tile)
Get the Y component of a tile.
static debug_inline uint TileX(TileIndex tile)
Get the X component of a tile.
TileIndexDiffC TileIndexToTileIndexDiffC(TileIndex tile_a, TileIndex tile_b)
Returns the diff between two tiles.
Function implementations related to NewGRF animation.
CallbackID
List of implemented NewGRF callbacks.
@ CBID_HOUSE_ANIMATION_START_STOP
Called for periodically starting or stopping the animation.
@ CBID_HOUSE_CONSTRUCTION_STATE_CHANGE
Called whenever the construction state of a house changes.
@ CBID_HOUSE_COLOUR
Called to determine the colour of a town building.
@ CBID_HOUSE_DRAW_FOUNDATIONS
Called to determine the type (if any) of foundation to draw for house tile.
@ CBID_HOUSE_ANIMATION_SPEED
Called to indicate how long the current animation frame should last.
@ CBID_HOUSE_ANIMATION_NEXT_FRAME
Determine the next animation frame for a house.
@ CBID_HOUSE_DENY_DESTRUCTION
Called to determine whether a town building can be destroyed.
@ CBID_HOUSE_WATCHED_CARGO_ACCEPTED
Called when a cargo type specified in property 20 is accepted.
@ CBID_RANDOM_TRIGGER
Set when calling a randomizing trigger (almost undocumented).
@ CBID_HOUSE_DESTRUCTION
Called periodically to determine if a house should be destroyed.
static const uint CALLBACK_FAILED
Different values for Callback result evaluations.
HouseCallbackMask
Callback masks for houses.
@ CBM_HOUSE_COLOUR
decide the colour of the building
@ CBM_HOUSE_ANIMATION_SPEED
decides animation speed
@ CBM_HOUSE_ANIMATION_NEXT_FRAME
decides next animation frame
@ CBM_HOUSE_ANIMATION_START_STOP
periodically start/stop the animation
@ CBM_HOUSE_CONSTRUCTION_STATE_CHANGE
change animation when construction state changes
@ CBM_HOUSE_DESTRUCTION
trigger destruction of building
@ CBM_HOUSE_DRAW_FOUNDATIONS
decides if default foundations need to be drawn
@ CBM_HOUSE_DENY_DESTRUCTION
conditional protection
CargoID GetCargoTranslation(uint8_t cargo, const GRFFile *grffile, bool usebit)
Translate a GRF-local cargo slot/bitnum into a CargoID.
Cargo support for NewGRFs.
bool Convert8bitBooleanCallback(const GRFFile *grffile, uint16_t cbid, uint16_t cb_res)
Converts a callback result into a boolean.
bool ConvertBooleanCallback(const GRFFile *grffile, uint16_t cbid, uint16_t cb_res)
Converts a callback result into a boolean.
uint32_t GetTerrainType(TileIndex tile, TileContext context)
Function used by houses (and soon industries) to get information on type of "terrain" the tile it is ...
TileIndex GetNearbyTile(uint8_t parameter, TileIndex tile, bool signed_offsets, Axis axis)
Get the tile at the given offset.
void DecreaseBuildingCount(Town *t, HouseID house_id)
DecreaseBuildingCount() Decrease the number of a building when it is deleted.
static bool SearchNearbyHouseClass(TileIndex tile, void *user_data)
Callback function to search a house by its classID.
void IncreaseBuildingCount(Town *t, HouseID house_id)
IncreaseBuildingCount() Increase the count of a building when it has been added by a town.
static uint32_t GetDistanceFromNearbyHouse(uint8_t parameter, TileIndex tile, HouseID house)
This function will activate a search around a central tile, looking for some houses that fit the requ...
void WatchedCargoCallback(TileIndex tile, CargoTypes trigger_cargoes)
Run watched cargo accepted callback for a house.
std::span< const uint > GetBuildingHouseIDCounts()
Get read-only span of total HouseID building counts.
void DoWatchedCargoCallback(TileIndex tile, TileIndex origin, CargoTypes trigger_cargoes, uint16_t random)
Run the watched cargo accepted callback for a single house tile.
void InitializeBuildingCounts(Town *t)
Initialise building counts for a town.
static const GRFFile * GetHouseSpecGrf(HouseID house_id)
Retrieve the grf file associated with a house.
static bool SearchNearbyHouseID(TileIndex tile, void *user_data)
Callback function to search a house by its HouseID.
static bool SearchNearbyHouseGRFID(TileIndex tile, void *user_data)
Callback function to search a house by its grfID.
static uint32_t GetNearbyTileInformation(uint8_t parameter, TileIndex tile, bool grf_version8)
Get information about a nearby tile.
Functions related to NewGRF houses.
static void DrawTileLayout(const TileInfo *ti, const TileLayoutSpriteGroup *group, const ObjectSpec *spec)
Draw an group of sprites on the map.
Functions related to NewGRF provided sounds.
uint32_t GetRegister(uint i)
Gets the value of a so-called newgrf "register".
Functions to handle the town part of NewGRF towns.
A number of safeguards to prevent using unsafe methods.
@ FOUNDATION_LEVELED
The tile is leveled up to a flat slope.
void DrawNewGRFTileSeq(const struct TileInfo *ti, const DrawTileSprites *dts, TransparencyOption to, uint32_t stage, PaletteID default_palette)
Draw NewGRF industrytile or house sprite layout.
PaletteID GroundSpritePaletteTransform(SpriteID image, PaletteID pal, PaletteID default_pal)
Applies PALETTE_MODIFIER_COLOUR to a palette entry of a ground sprite.
static constexpr uint8_t SPRITE_MODIFIER_CUSTOM_SPRITE
these masks change the colours of the palette for a sprite.
static constexpr uint8_t SPRITE_WIDTH
number of bits for the sprite number
Base classes/functions for stations.
std::set< Station *, StationCompare > StationList
List of stations.
Definition of base types and functions in a cross-platform compatible way.
#define lengthof(array)
Return the length of an fixed size array.
Helper class for a unified approach to NewGRF animation.
static void AnimateTile(const HouseSpec *spec, Town *obj, TileIndex tile, bool random_animation, CargoTypes extra_data=0)
Animate a single tile.
static void ChangeAnimationFrame(CallbackID cb, const HouseSpec *spec, Town *obj, TileIndex tile, uint32_t random_bits, uint32_t trigger, CargoTypes extra_data=0)
Check a callback to determine what the next animation step is and execute that step.
static bool IsValidHumanID(size_t index)
Is this company a valid company, not controlled by a NoAI program?
Ground palette sprite of a tile, together with its sprite layout.
PalSpriteID ground
Palette and sprite for the ground.
uint16_t local_id
id defined by the grf file for this entity
const struct GRFFile * grffile
grf file that introduced this entity
std::array< const struct SpriteGroup *, Tcnt > spritegroup
pointers to the different sprites of the entity
Dynamic data of a loaded NewGRF.
@ GES_LAST_MONTH
Set when cargo was delivered for final delivery last month.
@ GES_CURRENT_MONTH
Set when cargo was delivered for final delivery this month.
@ GES_EVER_ACCEPTED
Set when a vehicle ever delivered cargo to the station for final delivery.
@ GES_ACCEPTED_BIGTICK
Set when cargo was delivered for final delivery during the current STATION_ACCEPTANCE_TICKS interval.
Helper class for animation control.
Makes class IDs unique to each GRF file.
uint8_t class_id
The class id within the grf file.
uint32_t grfid
The GRF ID of the file this class belongs to.
Resolver object to be used for houses (feature 07 spritegroups).
HouseResolverObject(HouseID house_id, TileIndex tile, Town *town, CallbackID callback=CBID_NO_CALLBACK, uint32_t param1=0, uint32_t param2=0, bool not_yet_constructed=false, uint8_t initial_random_bits=0, CargoTypes watched_cargo_triggers=0, int view=0)
Construct a resolver for a house.
uint32_t GetDebugID() const override
Get an identifier for the item being resolved.
GrfSpecFeature GetFeature() const override
Get the feature number being resolved for.
int view
View when house does yet exist.
Town * town
Town of this house.
TileIndex tile
Tile of this house.
CargoTypes watched_cargo_triggers
Cargo types that triggered the watched cargo callback.
uint16_t initial_random_bits
Random bits during construction checks.
uint32_t GetRandomBits() const override
Get a few random bits.
HouseID house_id
Type of house being queried.
uint32_t GetTriggers() const override
Get the triggers.
bool not_yet_constructed
True for construction check.
uint32_t GetVariable(uint8_t variable, [[maybe_unused]] uint32_t parameter, bool &available) const override
CargoTypes watched_cargoes
Cargo types watched for acceptance.
static HouseSpec * Get(size_t house_id)
Get the spec for a house ID.
BuildingFlags building_flags
some flags that describe the house (size, stadium etc...)
uint8_t processing_time
Periodic refresh multiplier.
HouseExtraFlags extra_flags
some more flags
HouseID Index() const
Gets the index of this spec.
HouseClassID class_id
defines the class this house has (not grf file based)
GRFFileProps grf_prop
Properties related the the grf file.
Colours random_colour[4]
4 "random" colours
uint16_t callback_mask
Bitmask of house callbacks that have to be called.
static std::vector< HouseSpec > & Specs()
Get a reference to all HouseSpecs.
static TileIndex WrapToMap(TileIndex tile)
'Wraps' the given "tile" so it is within the map.
SpriteID sprite
The 'real' sprite.
PaletteID pal
The palette (use PAL_NONE) if not needed)
static Pool::IterateWrapper< Titem > Iterate(size_t from=0)
Returns an iterable ensemble of all valid Titem.
Interface for SpriteGroup-s to access the gamestate.
const GRFFile * grffile
GRFFile the resolved SpriteGroup belongs to.
const SpriteGroup * root_spritegroup
Root SpriteGroup to use for resolving.
ResolverObject & ro
Surrounding resolver object.
Structure with user-data for SearchNearbyHouseXXX - functions.
TileIndex north_tile
Northern tile of the house.
const HouseSpec * hs
Specs of the house that started the search.
virtual const SpriteGroup * Resolve([[maybe_unused]] ResolverObject &object) const
Base sprite group resolver.
A pair-construct of a TileIndexDiff.
int16_t x
The x value of the coordinate.
int16_t y
The y value of the coordinate.
Tile information, used while rendering the tile.
int x
X position of the tile in unit coordinates.
Slope tileh
Slope of the tile.
TileIndex tile
Tile index.
int y
Y position of the tile in unit coordinates.
Action 2 sprite layout for houses, industry tiles, objects and airport tiles.
const DrawTileSprites * ProcessRegisters(uint8_t *stage) const
Process registers and the construction stage into the sprite layout.
BuildingCounts< uint16_t > building_counts
The number of each type of building in the town.
TownCache cache
Container for all cacheable data.
uint8_t GetAnimationFrame(Tile t)
Get the current animation frame.
bool IsValidTile(Tile tile)
Checks if a tile is valid.
uint TileHash2Bit(uint x, uint y)
Get the last two bits of the TileHash from a tile position.
static debug_inline bool IsTileType(Tile tile, TileType type)
Checks if a tile is a given tiletype.
constexpr TileIndex INVALID_TILE
The very nice invalid tile marker.
@ MP_HOUSE
A house by a town.
OrthogonalTileArea TileArea
Shorthand for the much more common orthogonal tile area.
HouseZonesBits GetTownRadiusGroup(const Town *t, TileIndex tile)
Returns the bit corresponding to the town zone of the specified tile.
TileIndexDiff GetHouseNorthPart(HouseID &house)
Determines if a given HouseID is part of a multitile house.
void ClearTownHouse(Town *t, TileIndex tile)
Clear a town house.
const HouseSpec _original_house_specs[]
House specifications from original data.
HouseID GetHouseType(Tile t)
Get the type of this house, which is an index into the house spec array.
void SetHouseRandomBits(Tile t, uint8_t random)
Set the random bits for this house.
uint8_t GetHouseRandomBits(Tile t)
Get the random bits for this house.
void SetHouseTriggers(Tile t, uint8_t triggers)
Set the activated triggers bits for this house.
TimerGameCalendar::Year GetHouseAge(Tile t)
Get the age of the house.
void DecHouseProcessingTime(Tile t)
Decrease the amount of time remaining before the tile loop processes this tile.
uint8_t GetHouseBuildingStage(Tile t)
House Construction Scheme.
uint8_t GetHouseTriggers(Tile t)
Get the already activated triggers bits for this house.
void SetHouseProcessingTime(Tile t, uint8_t time)
Set the amount of time remaining before the tile loop processes this tile.
uint8_t GetHouseProcessingTime(Tile t)
Get the amount of time remaining before the tile loop processes this tile.
@ TO_HOUSES
town buildings
void DrawGroundSprite(SpriteID image, PaletteID pal, const SubSprite *sub, int extra_offs_x, int extra_offs_y)
Draws a ground sprite for the current tile.