16#include "viewport_kdtree.h"
61#include "table/strings.h"
73void RebuildTownKdtree()
75 std::vector<TownID> townids;
76 for (
const Town *town :
Town::Iterate()) {
77 townids.push_back(town->index);
79 _town_kdtree.
Build(townids.begin(), townids.end());
121 assert(i->town !=
this);
126 assert(o->town !=
this);
151 for (
auto &psa : this->psa_list) {
154 this->psa_list.clear();
201 size_t index = std::numeric_limits<size_t>::max();
217void Town::FillCachedName()
const
228 return (_price[PR_CLEAR_HOUSE] * this->
removal_cost) >> 8;
234static void TownDrawHouseLift(
const TileInfo *ti)
239typedef void TownDrawTileProc(
const TileInfo *ti);
240static TownDrawTileProc *
const _town_draw_tile_procs[1] = {
267 DrawNewHouseTile(ti, house_id);
288 ti->
x + dcts->subtile_x,
289 ti->
y + dcts->subtile_y,
301 int proc = dcts->draw_proc - 1;
303 if (proc >= 0) _town_draw_tile_procs[proc](ti);
307static int GetSlopePixelZ_Town(
TileIndex tile, uint, uint,
bool)
344 AnimateNewHouseTile(tile);
375 pos += (pos < dest) ? 1 : -1;
394 if (_town_kdtree.
Count() == 0)
return false;
411 _viewport_sign_kdtree.
Insert(ViewportSignKdtreeItem::MakeTown(this->
index));
420 t->UpdateVirtCoord();
428 t->cached_name.clear();
471 bool covers_area = st->TileIsInCatchment(tile);
472 if (flags.
Any(BUILDING_2_TILES_Y)) covers_area |= st->TileIsInCatchment(tile +
TileDiffXY(0, 1));
473 if (flags.
Any(BUILDING_2_TILES_X)) covers_area |= st->TileIsInCatchment(tile +
TileDiffXY(1, 0));
474 if (flags.
Any(BUILDING_HAS_4_TILES)) covers_area |= st->TileIsInCatchment(tile +
TileDiffXY(1, 1));
496 TriggerHouseAnimation_ConstructionStageChanged(tile,
false);
530 if (amount == 0)
return;
534 amount = (amount + 1) >> 1;
541 t->
supplied[cargo].new_max += amount;
556 if (
GB(r, 0, 8) < rate) {
558 uint amt = (
GB(r, 0, 8) * cs->town_production_multiplier / TOWN_PRODUCTION_DIVISOR) / 8 + 1;
579 int genmax = (rate + 7) / 8;
580 uint32_t genmask = (genmax >= 32) ? 0xFFFFFFFF : ((1 << genmax) - 1);
583 uint amt =
CountBits(r & genmask) * cs->town_production_multiplier / TOWN_PRODUCTION_DIVISOR;
619 Town *t = Town::GetByTile(tile);
625 for (uint i = 0; i < 256; i++) {
633 uint amt =
GB(callback, 0, 8);
634 if (amt == 0)
continue;
666 CanDeleteHouse(tile) &&
674 if (
GB(r, 24, 8) >= 12) {
682 int x =
Clamp(grid_pos.
x, 0, 1);
683 int y =
Clamp(grid_pos.
y, 0, 1);
710 if (!CanDeleteHouse(tile))
return CMD_ERROR;
718 Town *t = Town::GetByTile(tile);
723 if (rating > RATING_MAXIMUM) {
745 Town *t = Town::GetByTile(tile);
748 for (uint i = 0; i < 256; i++) {
761 produced[cs->Index()]++;
766 produced[cs->Index()]++;
782 acceptance[cargo] += amount;
783 SetBit(always_accepted, cargo);
800 for (uint8_t i = 0; i <
lengthof(accepts); i++) {
832 for (uint8_t i = 0; i <
lengthof(accepts); i++) {
837static void AddAcceptedCargo_Town(
TileIndex tile,
CargoArray &acceptance, CargoTypes &always_accepted)
850 CargoTypes always_accepted{};
865 std::array<int32_t, 1> regs100;
866 uint16_t callback_res = GetHouseCallback(
CBID_HOUSE_CUSTOM_NAME, house_completed ? 1 : 0, 0, house,
Town::GetByTile(tile), tile, regs100);
869 if (callback_res == 0x40F) {
871 }
else if (callback_res > 0x400) {
876 if (new_name != STR_NULL && new_name != STR_UNDEFINED) {
881 if (!house_completed) {
883 td.
str = STR_LAI_TOWN_INDUSTRY_DESCRIPTION_UNDER_CONSTRUCTION;
930 if (_game_mode == GM_EDITOR)
return;
957 const uint16_t assume_max_speed = 50;
960 if (RoadTypeIsTram(rt))
continue;
965 if (rti->
label == 0)
continue;
973 if (best !=
nullptr) {
992 if (RoadTypeIsTram(rt))
continue;
994 if (rti->
label == 0)
continue;
1014 if (min_date < INT32_MAX) {
1017 GetEncodedString(STR_ERROR_NO_TOWN_ROADTYPES_AVAILABLE_YET_EXPLANATION, min_date),
1048 dist_multi = (dist_multi + 1) * 4;
1049 for (uint pos = 4; pos < dist_multi; pos++) {
1054 if (pos & 2) cur += tid_lt[2];
1097 if (desired_slope != cur_slope &&
ComplementSlope(desired_slope) != cur_slope) {
1115static bool TerraformTownTile(
TileIndex tile,
Slope edges,
bool dir)
1120 if (r.
Failed() || r.
GetCost() >= (_price[PR_TERRAFORM] + 2) * 8)
return false;
1125static void LevelTownLand(
TileIndex tile)
1155 default: NOT_REACHED();
1158 if ((grid_pos.
x % 3) == 0) rcmd |=
ROAD_Y;
1159 if ((grid_pos.
y % 3) == 0) rcmd |=
ROAD_X;
1163 if ((grid_pos.
x % 4) == 0) rcmd |=
ROAD_Y;
1164 if ((grid_pos.
y % 4) == 0) rcmd |=
ROAD_X;
1174 default: rb_template =
ROAD_ALL;
break;
1321 uint bridge_length = 0;
1328 const uint TOWN_BRIDGE_LENGTH_CAP = 11;
1329 uint base_bridge_length = 5;
1330 uint max_bridge_length = std::min(t->
cache.
population / 1000 + base_bridge_length, TOWN_BRIDGE_LENGTH_CAP);
1335 if (bridge_length++ >= base_bridge_length) {
1339 bridge_tile += delta;
1343 if (bridge_length++ >= max_bridge_length) {
1347 bridge_tile += delta;
1352 if (bridge_length == 1)
return false;
1371 for (uint8_t times = 0; times <= 22; times++) {
1408 int max_tunnel_length = 0;
1414 for (uint8_t tiles = 0; tiles < 4; tiles++) {
1418 slope_tile += delta;
1425 max_tunnel_length = 5;
1428 uint8_t tunnel_length = 0;
1433 if (tunnel_length++ >= max_tunnel_length)
return false;
1434 tunnel_tile += delta;
1439 if (tunnel_length == 1)
return false;
1462 static const TileIndexDiffC tiles[] = { {-1, -1}, {-1, 0}, {-1, 1}, {0, -1}, {0, 1}, {1, -1}, {1, 0}, {1, 1} };
1465 for (
const auto &ptr : tiles) {
1472 RoadType road_rt = GetRoadTypeRoad(cur_tile);
1473 RoadType tram_rt = GetRoadTypeTram(cur_tile);
1493 RoadType rt = GetRoadTypeRoad(tile);
1507enum class TownGrowthResult {
1550 default: NOT_REACHED();
1555 if (rcmd ==
ROAD_NONE)
return TownGrowthResult::SearchStopped;
1560 if (!
IsRoadAllowedHere(t1, tile, target_dir))
return TownGrowthResult::SearchStopped;
1566 do target_dir =
RandomDiagDir();
while (target_dir == source_dir);
1572 if (target_dir !=
ReverseDiagDir(source_dir))
return TownGrowthResult::SearchStopped;
1577 return TownGrowthResult::SearchStopped;
1597 default: NOT_REACHED();
1610 bool allow_house =
true;
1618 return TownGrowthResult::Continue;
1627 if (cur_rb & target_rb) {
1635 if ((cur_rb &
ROAD_X) != target_rb)
return TownGrowthResult::Continue;
1653 return TownGrowthResult::Continue;
1663 if (!
IsValidTile(house_tile))
return TownGrowthResult::Continue;
1665 TownGrowthResult result = TownGrowthResult::Continue;
1669 default: NOT_REACHED();
1673 result = TownGrowthResult::Succeed;
1679 allow_house = (rcmd & target_rb) ==
ROAD_NONE;
1684 result = TownGrowthResult::Succeed;
1703 if (
Chance16(1, 6)) LevelTownLand(house_tile);
1708 result = TownGrowthResult::Succeed;
1722 if (rcmd ==
ROAD_NONE)
return TownGrowthResult::SearchStopped;
1728 return TownGrowthResult::Succeed;
1731 return TownGrowthResult::Succeed;
1735 return TownGrowthResult::Succeed;
1737 return TownGrowthResult::SearchStopped;
1779 return (target_rb & back_rb) != 0 && (target_rb & ~back_rb) != 0;
1822 case TownGrowthResult::Succeed:
1824 case TownGrowthResult::SearchStopped:
1848 }
while (!(cur_rb & target_bits));
1849 cur_rb &= ~target_bits;
1867 }
while (--iterations >= 0);
1882 uint a =
GB(r, 0, 2);
1883 uint b =
GB(r, 8, 2);
1917 for (
const auto &ptr : _town_coord_mod) {
1930 for (
const auto &ptr : _town_coord_mod) {
1954 static const std::array<std::array<uint32_t, NUM_HOUSE_ZONES>, 23> _town_squared_town_zone_radius_data = {{
1967 { 81, 36, 25, 0, 9},
1968 { 81, 36, 25, 16, 9},
1969 { 81, 49, 0, 25, 9},
1970 { 81, 64, 0, 25, 9},
1971 { 81, 64, 0, 36, 9},
1972 { 81, 64, 0, 36, 16},
1973 {100, 81, 0, 49, 16},
1974 {100, 81, 0, 49, 25},
1975 {121, 81, 0, 49, 25},
1976 {121, 81, 0, 49, 25},
1977 {121, 81, 0, 49, 36},
1980 if (t->
cache.
num_houses < std::size(_town_squared_town_zone_radius_data) * 4) {
2044 case LandscapeType::Arctic:
2048 case LandscapeType::Tropic:
2068 t->townnamegrfid = tnp.
grfid;
2069 t->townnametype = tnp.
type;
2071 t->townnameparts = townnameparts;
2077 int x = (int)size * 16 + 3;
2109 return CommandCost(STR_ERROR_TOO_CLOSE_TO_EDGE_OF_MAP_SUB);
2114 return CommandCost(STR_ERROR_TOO_CLOSE_TO_ANOTHER_TOWN);
2133 if (!t->
name.empty() && t->
name == name)
return false;
2162 if (random_location)
return {
CMD_ERROR, 0, TownID::Invalid() };
2164 return {
CMD_ERROR, 0, TownID::Invalid() };
2168 return {
CMD_ERROR, 0, TownID::Invalid() };
2183 if (!random_location) {
2185 if (ret.
Failed())
return { ret, 0, TownID::Invalid() };
2188 static const uint8_t price_mult[][
TSZ_RANDOM + 1] = {{ 15, 25, 40, 25 }, { 20, 35, 55, 35 }};
2190 static_assert(
lengthof(price_mult[0]) == 4);
2193 uint8_t mult = price_mult[city][size];
2198 TownID new_town = TownID::Invalid();
2207 if (random_location) {
2211 DoCreateTown(t, tile, townnameparts, size, city, layout,
true);
2215 old_generating_world.
Restore();
2217 if (t ==
nullptr)
return {
CommandCost(STR_ERROR_NO_SPACE_FOR_TOWN), 0, TownID::Invalid() };
2219 new_town = t->
index;
2221 if (!text.empty()) {
2226 if (_game_mode != GM_EDITOR) {
2228 assert(!random_location);
2240 return { cost, 0, new_town };
2257 default:
return tile;
2275 default:
return true;
2303 if (dist > max_dist) {
2326 default: NOT_REACHED();
2362 DoCreateTown(t, tile, townnameparts, size, city, layout,
false);
2378 }
while (--attempts != 0);
2390 static const uint8_t num_initial_towns[4] = {5, 11, 23, 46};
2406 uint current_number = 0;
2408 if (number.has_value()) {
2409 total = number.value();
2417 uint32_t townnameparts;
2418 TownNames town_names;
2424 town_names.insert(town->GetCachedName());
2446 RebuildTownKdtree();
2448 if (current_number != 0)
return true;
2478 HouseZone smallest = HouseZone::TownEdge;
2480 if (dist < t->cache.squared_town_zone_radius[
to_underlying(i)]) smallest = i;
2617 if ((grid_pos.
x % 3) == 0 || (grid_pos.
y % 3) == 0)
return false;
2621 if ((grid_pos.
x % 4) == 0 || (grid_pos.
y % 4) == 0)
return false;
2651 if ((grid_pos.
x != 2 && grid_pos.
x != -1) ||
2652 (grid_pos.
y != 2 && grid_pos.
y != -1))
return false;
2656 if ((grid_pos.
x & 3) < 2 || (grid_pos.
y & 3) < 2)
return false;
2732 uint8_t construction_counter = 0;
2733 uint8_t construction_stage = 0;
2736 uint32_t construction_random =
Random();
2744 construction_counter =
GB(construction_random, 2, 2);
2748 MakeTownHouse(tile, t, construction_counter, construction_stage, house, random_bits, is_protected);
2754 TriggerHouseAnimation_ConstructionStageChanged(tile,
true);
2755 if (size.
Any(BUILDING_2_TILES_Y)) TriggerHouseAnimation_ConstructionStageChanged(tile +
TileDiffXY(0, 1),
true);
2756 if (size.
Any(BUILDING_2_TILES_X)) TriggerHouseAnimation_ConstructionStageChanged(tile +
TileDiffXY(1, 0),
true);
2757 if (size.
Any(BUILDING_HAS_4_TILES)) TriggerHouseAnimation_ConstructionStageChanged(tile +
TileDiffXY(1, 1),
true);
2791 static std::vector<std::pair<HouseID, uint>> probs;
2794 uint probability_max = 0;
2802 if (hs.
class_id != HOUSE_NO_CLASS) {
2811 probability_max += cur_prob;
2812 probs.emplace_back(hs.
Index(), cur_prob);
2817 while (probability_max > 0) {
2827 for (i = 0; i < probs.size(); i++) {
2828 if (probs[i].second > r)
break;
2829 r -= probs[i].second;
2832 HouseID house = probs[i].first;
2833 probability_max -= probs[i].second;
2836 probs[i] = probs.back();
2856 if (t->
flags & oneof)
continue;
2860 if (noslope && slope !=
SLOPE_FLAT)
continue;
2872 uint8_t random_bits =
Random();
2958 DoClearSquare(tile);
2973 if (
HouseSpec::Get(house - 1)->building_flags.Test(BuildingFlag::Size2x1)) {
2976 }
else if (
HouseSpec::Get(house - 1)->building_flags.Any(BUILDING_2_TILES_Y)) {
2979 }
else if (
HouseSpec::Get(house - 2)->building_flags.Any(BUILDING_HAS_4_TILES)) {
2982 }
else if (
HouseSpec::Get(house - 3)->building_flags.Any(BUILDING_HAS_4_TILES)) {
3043 bool reset = text.empty();
3060 ClearAllStationCachedNames();
3061 ClearAllIndustryCachedNames();
3075 if (cs->town_acceptance_effect == effect)
return cs;
3102 t->
goal[tae] = goal;
3125 if (!text.empty()) t->
text = text;
3147 if (growth_rate == 0) {
3186 int16_t new_rating =
Clamp(rating, RATING_MINIMUM, RATING_MAXIMUM);
3188 t->
ratings[company_id] = new_rating;
3210 if (grow_amount == 0) {
3215 uint n = amount * 10;
3220 for (; grow_amount > 0; grow_amount--) {
3222 for (uint i = 0; i < 25; i++)
if (
GrowTown(t))
break;
3247 if (st->town == t) {
3252 if (ret.
Failed())
return ret;
3273 if (ret.
Failed())
return ret;
3279 bool try_clear =
false;
3316 if (ret.
Failed())
return ret;
3341 static const uint8_t town_action_costs[] = {
3342 2, 4, 9, 35, 48, 53, 117, 175
3344 static_assert(std::size(town_action_costs) ==
to_underlying(TownAction::End));
3346 assert(
to_underlying(action) < std::size(town_action_costs));
3441 static const int STATUE_NUMBER_INNER_TILES = 25;
3444 uint tile_count = 0;
3455 best_position = tile;
3462 if (tile_count <= STATUE_NUMBER_INNER_TILES) {
3465 best_position = tile;
3469 if (tile_count == STATUE_NUMBER_INNER_TILES && best_position !=
INVALID_TILE)
break;
3474 best_position = tile;
3570 for (
GoodsEntry &ge : st->goods) ge.rating = 0;
3598static TownActionProc *
const _town_action_proc[] = {
3608static_assert(std::size(_town_action_proc) ==
to_underlying(TownAction::End));
3628 for (
TownAction cur = {}; cur != TownAction::End; ++cur) {
3636 if (t->
ratings[cid] >= RATING_BRIBE_MAXIMUM) {
3682 if (ret.
Failed())
return ret;
3691template <
typename Func>
3692static void ForAllStationsNearTown(
Town *t, Func func)
3700 if (DistanceSquare(st->xy, t->xy) <= t->cache.squared_town_zone_radius[to_underlying(HouseZone::TownEdge)]) {
3719 ForAllStationsNearTown(t, [&](
const Station *st) {
3720 if (st->time_since_load <= 20 || st->time_since_unload <= 20) {
3721 if (Company::IsValidID(st->owner)) {
3722 int new_rating = t->ratings[st->owner] + RATING_STATION_UP_STEP;
3723 t->ratings[st->owner] = std::min<int>(new_rating, INT16_MAX);
3727 int new_rating = t->ratings[st->owner] + RATING_STATION_DOWN_STEP;
3728 t->ratings[st->owner] = std::max(new_rating, INT16_MIN);
3734 for (uint i = 0; i < MAX_COMPANIES; i++) {
3766 ForAllStationsNearTown(t, [&](
const Station * st) {
3767 if (st->time_since_load <= 20 || st->time_since_unload <= 20) {
3787 static const uint16_t _grow_count_values[2][6] = {
3788 { 120, 120, 120, 100, 80, 60 },
3789 { 320, 420, 300, 220, 160, 100 }
3797 m >>= growth_multiplier;
3831 for (
int i = TAE_BEGIN; i <
TAE_END; i++) {
3832 switch (t->
goal[i]) {
3914 if (tid == TownID::Invalid()) {
3931 return Town::GetByTile(tile);
3948 static int ref_count = 0;
3950 if (ref_count == 0) {
3955 assert(ref_count > 0);
3997 if (rating < max) rating = max;
4002 if (rating > max) rating = max;
4068 for (
auto &supplied : t->supplied) supplied.NewMonth();
4069 for (
auto &received : t->received) received.NewMonth();
4081 for (
const auto t :
Map::Iterate()) {
4097 bool allow_terraform =
true;
4104 uint16_t res = GetHouseCallback(
CBID_HOUSE_AUTOSLOPE, 0, 0, house, Town::GetByTile(tile), tile);
4118 GetSlopePixelZ_Town,
4120 AddAcceptedCargo_Town,
4122 GetTileTrackStatus_Town,
4126 ChangeTileOwner_Town,
4127 AddProducedCargo_Town,
4133std::span<const DrawBuildingsTileStruct> GetTownDrawTileData()
Base functions for all AIs.
@ AT_OILRIG
Oilrig airport.
void AddAnimatedTile(TileIndex tile, bool mark_dirty)
Add the given tile to the animated tile table (if it does not exist yet).
void DeleteAnimatedTile(TileIndex tile, bool immediate)
Stops animation on the given tile.
Functions related to autoslope.
bool AutoslopeEnabled()
Tests if autoslope is enabled for _current_company.
Class for backupping variables and making sure they are restored later.
debug_inline constexpr 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 uint CountBits(T value)
Counts the number of set bits in a variable.
debug_inline static constexpr uint GB(const T x, const uint8_t s, const uint8_t n)
Fetch n bits from x, started at bit s.
constexpr T ClrBit(T &x, const uint8_t y)
Clears a bit in a variable.
static const uint MAX_BRIDGES
Maximal number of available bridge specs.
bool IsBridgeTile(Tile t)
checks if there is a bridge on this tile
bool IsBridgeAbove(Tile t)
checks if a bridge is set above the ground of this tile
Axis GetBridgeAxis(Tile t)
Get the axis of the bridge that goes over the tile.
uint8_t CargoType
Cargo slots to indicate a cargo type within a game.
bool IsValidCargoType(CargoType cargo)
Test whether cargo type is not INVALID_CARGO.
TownProductionEffect
Town effect when producing cargo.
@ TPE_PASSENGERS
Cargo behaves passenger-like for production.
@ TPE_MAIL
Cargo behaves mail-like for production.
TownAcceptanceEffect
Town growth effect when delivering cargo.
@ TAE_END
End of town effects.
@ TAE_FOOD
Cargo behaves food/fizzy-drinks-like.
@ TAE_WATER
Cargo behaves water-like.
Cheats _cheats
All the cheats.
Types related to cheating.
static void BroadcastNewEvent(ScriptEvent *event, CompanyID skip_company=CompanyID::Invalid())
Broadcast a new event to all active AIs.
constexpr bool All(const Timpl &other) const
Test if all of the values are set.
constexpr bool Test(Tvalue_type value) const
Test if the value-th bit is set.
constexpr Timpl & Set()
Set all bits.
constexpr bool Any(const Timpl &other) const
Test if any of the given values are set.
Common return value for all commands.
bool Succeeded() const
Did this command succeed?
void AddCost(const Money &cost)
Adds the given cost to the cost of the command.
Money GetCost() const
The costs as made up to this moment.
bool Failed() const
Did this command fail?
void MultiplyCost(int factor)
Multiplies the cost of the command by the given factor.
Container for an encoded string, created by GetEncodedString.
static void NewEvent(class ScriptEvent *event)
Queue a new event for a Game Script.
An interval timer will fire every interval, and will continue to fire until it is deleted.
K-dimensional tree, specialised for 2-dimensional space.
void Build(It begin, It end)
Clear and rebuild the tree from a new sequence of elements,.
size_t Count() const
Get number of elements stored in tree.
void Insert(const T &element)
Insert a single element in the tree.
void Remove(const T &element)
Remove a single element from the tree, if it exists.
T FindNearest(CoordT x, CoordT y) const
Find the element closest to given coordinate, in Manhattan distance.
RoadTypeLabel label
Unique 32 bit road type identifier.
TimerGameCalendar::Date introduction_date
Introduction date.
RoadTypeFlags flags
Bit mask of road type flags.
uint16_t max_speed
Maximum speed for vehicles travelling on this road type.
Generate TileIndices around a center tile or tile area, with increasing distance.
Structure contains cached list of stations nearby.
const StationList & GetStations()
Run a tile loop to find stations around a tile, on demand.
static constexpr TimerGameTick::Ticks TOWN_GROWTH_TICKS
Cycle duration for towns trying to grow (this originates from the size of the town array in TTD).
static Date date
Current date in days (day counter).
static Year year
Current year, starting at 0.
static constexpr TimerGame< struct Calendar >::Date MAX_DATE
The date of the last day of the max year.
static bool UsingWallclockUnits(bool newgame=false)
Check if we are using wallclock units.
static TickCounter counter
Monotonic counter, in ticks, since start of game.
CommandCost CommandCostWithParam(StringID str, uint64_t value)
Return an error status, with string and parameter.
Functions related to commands.
static constexpr DoCommandFlags CommandFlagsToDCFlags(CommandFlags cmd_flags)
Extracts the DC flags needed for DoCommand from the flags returned by GetCommandFlags.
static const CommandCost CMD_ERROR
Define a default return value for a failed command.
@ Execute
execute the given command
@ NoModifyTownRating
do not change town rating
@ NoTestTownRating
town rating does not disallow you from building
@ NoWater
don't allow building on water
@ Auto
don't allow building on structures
Definition of stuff that is very close to a company, like the company struct itself.
Money GetAvailableMoneyForCommand()
This functions returns the money which can be used to execute a command.
Money GetAvailableMoney(CompanyID company)
Get the amount of money that a company has available, or INT64_MAX if there is no such valid company.
CompanyID _current_company
Company currently doing an action.
Functions related to companies.
bool IsLocalCompany()
Is the current company the local company?
static constexpr Owner OWNER_DEITY
The object is owned by a superuser / goal script.
static constexpr CompanyID COMPANY_SPECTATOR
The client is spectating.
static constexpr Owner OWNER_TOWN
A town owns the tile, or a town is expanding.
static constexpr Owner OWNER_NONE
The tile has no ownership.
Base for all depots (except hangars)
DiagDirection ReverseDiagDir(DiagDirection d)
Returns the reverse direction of the given DiagDirection.
bool IsValidDiagDirection(DiagDirection d)
Checks if an integer value is a valid DiagDirection.
DiagDirection ChangeDiagDir(DiagDirection d, DiagDirDiff delta)
Applies a difference on a DiagDirection.
Axis DiagDirToAxis(DiagDirection d)
Convert a DiagDirection to the axis.
@ DIAGDIRDIFF_90RIGHT
90 degrees right
@ DIAGDIRDIFF_90LEFT
90 degrees left
DiagDirection
Enumeration for diagonal directions.
@ DIAGDIR_END
Used for iterations.
@ DIAGDIR_BEGIN
Used for iterations.
bool EconomyIsInRecession()
Is the economy in recession?
uint ScaleByCargoScale(uint num, bool town)
Scale a number by the cargo scale setting.
@ EXPENSES_CONSTRUCTION
Construction costs.
@ EXPENSES_OTHER
Other expenses.
constexpr std::underlying_type_t< enum_type > to_underlying(enum_type e)
Implementation of std::to_underlying (from C++23)
Functions related to errors.
@ WL_CRITICAL
Critical errors, the MessageBox is shown in all cases.
@ WL_INFO
Used for DoCommand-like (and some non-fatal AI GUI) errors/information.
void ShowErrorMessage(EncodedString &&summary_msg, int x, int y, CommandCost &cc)
Display an error message in a window.
Base functions for all Games.
bool _generating_world
Whether we are generating the map or not.
Functions related to world/map generation.
void IncreaseGeneratingWorldProgress(GenWorldProgress cls)
Increases the current stage of the world generation with one.
@ GWP_TOWN
Generate towns.
void SetGeneratingWorldProgress(GenWorldProgress cls, uint total)
Set the total of a stage of the world generation.
uint32_t SpriteID
The number of a sprite, without mapping bits and colourtables.
uint8_t GetSnowLine()
Get the current snow line, either variable or static.
uint8_t HighestSnowLine()
Get the highest possible snow line height, either variable or static.
void MarkWholeScreenDirty()
This function mark the whole screen as dirty.
void MarkTileDirtyByTile(TileIndex tile, int bridge_level_offset, int tile_height_override)
Mark a tile given by its index dirty for repaint.
@ BuildingIsHistorical
this house will only appear during town generation in random games, thus the historical
@ BuildingIsProtected
towns and AI will not remove this house, while human players will be able to
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.
@ ClimateSubarcticAboveSnow
Building can appear in sub-arctic climate above the snow line.
@ ClimateSubarcticBelowSnow
Building can appear in sub-arctic climate below the snow line.
@ ClimateTemperate
Building can appear in temperate climate.
@ ClimateToyland
Building can appear in toyland climate.
@ ClimateSubtropic
Building can appear in subtropical climate.
uint16_t HouseID
OpenTTD ID of house types.
void DrawFoundation(TileInfo *ti, Foundation f)
Draw foundation f at tile ti.
std::tuple< Slope, int > GetFoundationSlope(TileIndex tile)
Get slope of a tile on top of a (possible) foundation If a tile does not have a foundation,...
Functions related to OTTD's landscape.
Point RemapCoords2(int x, int y)
Map 3D world or tile coordinate to equivalent 2D coordinate as used in the viewports and smallmap.
Command definitions related to landscape (slopes etc.).
@ Random
Randomise borders.
uint DistanceSquare(TileIndex t0, TileIndex t1)
Gets the 'Square' distance between the two given tiles.
uint DistanceFromEdge(TileIndex tile)
Param the minimum distance to an edge.
uint DistanceManhattan(TileIndex t0, TileIndex t1)
Gets the Manhattan distance between the two given tiles.
uint GetClosestWaterDistance(TileIndex tile, bool water)
Finds the distance for the closest tile with water/land given a tile.
TileIndex TileAddXY(TileIndex tile, int x, int y)
Adds a given offset to a tile.
TileIndex TileAddByDir(TileIndex tile, Direction dir)
Adds a Direction to a tile.
static debug_inline TileIndex TileXY(uint x, uint y)
Returns the TileIndex of a coordinate.
TileIndexDiff ToTileIndexDiff(TileIndexDiffC tidc)
Return the offset between two tiles from a TileIndexDiffC struct.
TileIndex TileAddByDiagDir(TileIndex tile, DiagDirection dir)
Adds a DiagDir to a tile.
TileIndexDiff TileDiffXY(int x, int y)
Calculates an offset for the given coordinate(-offset).
constexpr TileIndex TileAdd(TileIndex tile, TileIndexDiff offset)
Adds a given offset to a tile.
#define RandomTile()
Get a valid random tile.
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.
TileIndexDiff TileOffsByDiagDir(DiagDirection dir)
Convert a DiagDirection to a TileIndexDiff.
TileIndexDiffC TileIndexToTileIndexDiffC(TileIndex tile_a, TileIndex tile_b)
Returns the diff between two tiles.
int32_t TileIndexDiff
An offset value between two tiles.
constexpr bool IsInsideMM(const size_t x, const size_t min, const size_t max) noexcept
Checks if a value is in an interval.
constexpr int RoundDivSU(int a, uint b)
Computes round(a / b) for signed a and unsigned b.
constexpr T Clamp(const T a, const T min, const T max)
Clamp a value between an interval.
@ GSF_FAKE_TOWNS
Fake town GrfSpecFeature for NewGRF debugging (parent scope)
@ CBID_HOUSE_DRAW_FOUNDATIONS
Called to determine the type (if any) of foundation to draw for house tile.
@ CBID_HOUSE_CARGO_ACCEPTANCE
Called to decide how much cargo a town building can accept.
@ CBID_HOUSE_AUTOSLOPE
Called to determine if one can alter the ground below a house tile.
@ CBID_HOUSE_CUSTOM_NAME
Called on the Get Tile Description for an house tile.
@ CBID_HOUSE_ALLOW_CONSTRUCTION
Determine whether the house can be built on the specified tile.
@ CBID_HOUSE_ACCEPT_CARGO
Called to determine which cargoes a town building should accept.
@ CBID_HOUSE_PRODUCE_CARGO
Called to determine how much cargo a town building produces.
static const uint CALLBACK_FAILED
Different values for Callback result evaluations.
@ AllowConstruction
decide whether the house can be built on a given tile
@ AcceptCargo
decides accepted types
@ CargoAcceptance
decides amount of cargo acceptance
@ DrawFoundations
decides if default foundations need to be drawn
@ ProduceCargo
custom cargo production
@ Autoslope
decides allowance of autosloping
static const uint CALLBACK_HOUSEPRODCARGO_END
Sentinel indicating that the loop for CBID_HOUSE_PRODUCE_CARGO has ended.
CargoType GetCargoTranslation(uint8_t cargo, const GRFFile *grffile, bool usebit)
Translate a GRF-local cargo slot/bitnum into a CargoType.
Cargo support for NewGRFs.
void ErrorUnknownCallbackResult(uint32_t grfid, uint16_t cbid, uint16_t cb_res)
Record that a NewGRF returned an unknown/invalid callback result.
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.
GRFConfig * GetGRFConfig(uint32_t grfid, uint32_t mask)
Retrieve a NewGRF from the current config by its grfid.
Functions/types related to NewGRF debugging.
void DeleteNewGRFInspectWindow(GrfSpecFeature feature, uint index)
Delete inspect window for a given feature and index.
void DecreaseBuildingCount(Town *t, HouseID house_id)
DecreaseBuildingCount() Decrease the number of a building when it is deleted.
void IncreaseBuildingCount(Town *t, HouseID house_id)
IncreaseBuildingCount() Increase the count of a building when it has been added by a town.
void InitializeBuildingCounts()
Initialise global building counts and all town building counts.
Functions related to NewGRF houses.
StringID GetGRFStringID(uint32_t grfid, GRFStringID stringid)
Returns the index for this stringid associated with its grfID.
Header of Action 04 "universal holder" structure and functions.
static constexpr GRFStringID GRFSTR_MISC_GRF_TEXT
Miscellaneous GRF text range.
Functions related to news.
void AddNewsItem(EncodedString &&headline, NewsType type, NewsStyle style, NewsFlags flags, NewsReference ref1={}, NewsReference ref2={}, std::unique_ptr< NewsAllocatedData > &&data=nullptr, AdviceType advice_type=AdviceType::Invalid)
Add a new newsitem to be shown.
@ General
General news (from towns)
@ IndustryOpen
Opening of industries.
@ Company
Company news item. (Newspaper with face)
@ Normal
Normal news item. (Newspaper with text only)
Functions related to objects.
void BuildObject(ObjectType type, TileIndex tile, CompanyID owner=OWNER_NONE, struct Town *town=nullptr, uint8_t view=0)
Actually build the object.
Map accessors for object tiles.
static const ObjectType OBJECT_STATUE
Statue in towns.
Some methods of Pool are placed here in order to reduce compilation time and binary size.
#define INSTANTIATE_POOL_METHODS(name)
Force instantiation of pool methods so we don't get linker errors.
static debug_inline bool IsPlainRailTile(Tile t)
Checks whether the tile is a rail tile or rail tile with signals.
Randomizer _random
Random used in the game state calculations.
Pseudo random number generator.
uint32_t RandomRange(uint32_t limit, const std::source_location location=std::source_location::current())
Pick a random number between 0 and limit - 1, inclusive.
bool Chance16(const uint32_t a, const uint32_t b, const std::source_location location=std::source_location::current())
Flips a coin with given probability.
RoadBits CleanUpRoadBits(const TileIndex tile, RoadBits org_rb)
Clean up unnecessary RoadBits of a planned tile.
@ NoHouses
Bit number for setting this roadtype as not house friendly.
@ TownBuild
Bit number for allowing towns to build this roadtype.
const RoadTypeInfo * GetRoadTypeInfo(RoadType roadtype)
Returns a pointer to the Roadtype information for a given roadtype.
void UpdateNearestTownForRoadTiles(bool invalidate)
Updates cached nearest town for all road tiles.
RoadBits DiagDirToRoadBits(DiagDirection d)
Create the road-part which belongs to the given DiagDirection.
Functions used internally by the roads.
RoadBits GetAnyRoadBits(Tile tile, RoadTramType rtt, bool straight_tunnel_bridge_entrance)
Returns the RoadBits on an arbitrary tile Special behaviour:
void SetRoadOwner(Tile t, RoadTramType rtt, Owner o)
Set the owner of a specific road type.
bool HasTownOwnedRoad(Tile t)
Checks if given tile has town owned road.
static debug_inline bool IsNormalRoadTile(Tile t)
Return whether a tile is a normal road tile.
static debug_inline bool IsRoadDepot(Tile t)
Return whether a tile is a road depot.
DisallowedRoadDirections GetDisallowedRoadDirections(Tile t)
Gets the disallowed directions.
bool HasTileRoadType(Tile t, RoadTramType rtt)
Check if a tile has a road or a tram road type.
DiagDirection GetRoadDepotDirection(Tile t)
Get the direction of the exit of a road depot.
static debug_inline bool IsRoadDepotTile(Tile t)
Return whether a tile is a road depot tile.
bool IsRoadOwner(Tile t, RoadTramType rtt, Owner o)
Check if a specific road type is owned by an owner.
RoadBits
Enumeration for the road parts on a tile.
@ ROAD_SW
South-west part.
@ ROAD_ALL
Full 4-way crossing.
@ ROAD_NONE
No road-part is build.
@ ROAD_E
Road at the two eastern edges.
@ ROAD_NE
North-east part.
@ ROAD_N
Road at the two northern edges.
@ ROAD_SE
South-east part.
@ ROAD_Y
Full road along the y-axis (north-west + south-east)
@ ROAD_S
Road at the two southern edges.
@ ROAD_W
Road at the two western edges.
@ ROAD_NW
North-west part.
@ ROAD_X
Full road along the x-axis (south-west + north-east)
RoadType
The different roadtypes we support.
@ INVALID_ROADTYPE
flag for invalid roadtype
@ ROADTYPE_ROAD
Basic road type.
@ ROADTYPE_END
Used for iterations.
@ ROADTYPE_BEGIN
Used for iterations.
@ DRD_NONE
None of the directions are disallowed.
A number of safeguards to prevent using unsafe methods.
GameSettings _settings_game
Game settings of a running game or the scenario editor.
GameSettings _settings_newgame
Game settings for new games (updated from the intro screen).
ClientSettings _settings_client
The current settings for this game.
static constexpr int GetSlopeMaxZ(Slope s)
Returns the height of the highest corner of a slope relative to TileZ (= minimal height)
bool IsSlopeWithOneCornerRaised(Slope s)
Tests if a specific slope has exactly one corner raised.
static constexpr bool IsSteepSlope(Slope s)
Checks if a slope is steep.
Foundation FlatteningFoundation(Slope s)
Returns the foundation needed to flatten a slope.
Slope InclinedSlope(DiagDirection dir)
Returns the slope that is inclined in a specific direction.
Slope ComplementSlope(Slope s)
Return the complement of a slope.
Slope
Enumeration for the slope-type.
@ SLOPE_W
the west corner of the tile is raised
@ SLOPE_ELEVATED
bit mask containing all 'simple' slopes
@ SLOPE_E
the east corner of the tile is raised
@ SLOPE_S
the south corner of the tile is raised
@ SLOPE_N
the north corner of the tile is raised
@ SLOPE_SW
south and west corner are raised
@ SLOPE_STEEP_W
a steep slope falling to east (from west)
@ SLOPE_NE
north and east corner are raised
@ SLOPE_STEEP_E
a steep slope falling to west (from east)
@ SLOPE_SE
south and east corner are raised
@ SLOPE_NW
north and west corner are raised
@ SLOPE_STEEP_N
a steep slope falling to south (from north)
@ SLOPE_STEEP_S
a steep slope falling to north (from south)
Foundation
Enumeration for Foundations.
@ FOUNDATION_LEVELED
The tile is leveled up to a flat slope.
@ FOUNDATION_NONE
The tile has no foundation, the slope remains unchanged.
@ Town
Source/destination is a town.
Base classes/functions for stations.
void ForAllStationsAroundTiles(const TileArea &ta, Func func)
Call a function on all stations that have any part of the requested area within their catchment.
void UpdateAllStationVirtCoords()
Update the virtual coords needed to draw the station sign for all stations.
void UpdateAirportsNoise()
Recalculate the noise generated by the airports of each town.
Declarations for accessing the k-d tree of stations.
void ForAllStationsRadius(TileIndex center, uint radius, Func func)
Call a function on all stations whose sign is within a radius of a center tile.
bool IsBayRoadStopTile(Tile t)
Is tile t a bay (non-drive through) road stop station?
bool IsDriveThroughStopTile(Tile t)
Is tile t a drive through road stop station or waypoint?
Axis GetDriveThroughStopAxis(Tile t)
Gets the axis of the drive through stop.
DiagDirection GetBayRoadStopDir(Tile t)
Gets the direction the bay road stop entrance points towards.
bool IsAnyRoadStopTile(Tile t)
Is tile t a road stop station?
@ Airport
Station with an airport.
Definition of base types and functions in a cross-platform compatible way.
#define lengthof(array)
Return the length of an fixed size array.
size_t Utf8StringLength(std::string_view str)
Get the length of an UTF-8 encoded string in number of characters and thus not the number of bytes th...
Functions related to low-level strings.
EncodedString GetEncodedString(StringID str)
Encode a string with no parameters into an encoded string.
std::string GetString(StringID string)
Resolve the given StringID into a std::string with formatting but no parameters.
Functions related to OTTD's strings.
uint32_t StringID
Numeric value that represents a string, independent of the selected language.
Class to backup a specific variable and restore it upon destruction of this object to prevent stack v...
Class to backup a specific variable and restore it later.
void Restore()
Restore the variable.
Owner owner
The owner of this station.
Class for storing amounts of cargo.
static void InvalidateAllFrom(Source src)
Invalidates (sets source_id to INVALID_SOURCE) all cargo packets from given source.
Specification of a cargo type.
static IterateWrapper Iterate(size_t from=0)
Returns an iterable ensemble of all valid CargoSpec.
static std::array< std::vector< const CargoSpec * >, NUM_TPE > town_production_cargoes
List of cargo specs for each Town Product Effect.
bool value
tells if the bool cheat is active or not
Cheat magic_bulldozer
dynamite industries, objects
GUISettings gui
settings related to the GUI
bool build_on_slopes
allow building on slopes
uint8_t number_towns
the amount of towns
uint8_t town_council_tolerance
minimum required town ratings to be allowed to demolish stuff
This structure is the same for both Industries and Houses.
bool bribe
enable bribing the local authority
TownFounding found_town
town founding.
PlaceHouses place_houses
players are allowed to place town houses.
bool exclusive_rights
allow buying exclusive rights
uint8_t initial_city_size
multiplier for the initial size of the cities compared to towns
TownLayout town_layout
select town layout,
bool allow_town_level_crossings
towns are allowed to build level crossings
uint8_t town_growth_rate
town growth rate
bool allow_town_roads
towns are allowed to build roads (always allowed when generating world / in SE)
bool fund_buildings
allow funding new buildings
bool fund_roads
allow funding local road reconstruction
TownCargoGenMode town_cargogen_mode
algorithm for generating cargo from houses,
uint8_t dist_local_authority
distance for town local authority, default 20
uint8_t larger_towns
the number of cities to build. These start off larger and grow twice as fast
Information about GRF, used in the game and (part of it) in savegames.
std::string GetName() const
Get the name of this grf.
const struct GRFFile * grffile
grf file that introduced this entity
uint32_t grfid
grfid that introduced this entity.
bool HasGrfFile() const
Test if this entity was introduced by NewGRF.
bool population_in_label
show the population of a town in its label?
uint16_t custom_town_number
manually entered number of towns
LandscapeType landscape
the landscape we're currently in
uint8_t town_name
the town name generator used for town names
EconomySettings economy
settings to change the economy
ConstructionSettings construction
construction of things in-game
DifficultySettings difficulty
settings related to the difficulty
GameCreationSettings game_creation
settings used during the creation of a game (map)
Stores station stats for a single cargo.
CargoType accepts_cargo[HOUSE_NUM_ACCEPTS]
input cargo slots
SubstituteGRFFileProps grf_prop
Properties related the the grf file.
uint8_t probability
Relative probability of appearing (16 is the standard value)
uint8_t removal_cost
cost multiplier for removing it
uint8_t mail_generation
mail generation multiplier (tile based, as the acceptances below)
bool enabled
the house is available to build (true by default, but can be disabled by newgrf)
Money GetRemovalCost() const
Get the cost for removing this house.
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...)
TimerGameCalendar::Year max_year
last year it can be built
HouseCallbackMasks callback_mask
Bitmask of house callbacks that have to be called.
uint16_t remove_rating_decrease
rating decrease if removed
uint8_t population
population (Zero on other tiles in multi tile house.)
HouseExtraFlags extra_flags
some more flags
uint8_t cargo_acceptance[HOUSE_NUM_ACCEPTS]
acceptance level for the cargo slots
HouseID Index() const
Gets the index of this spec.
HouseClassID class_id
defines the class this house has (not grf file based)
StringID building_name
building name
uint8_t minimum_life
The minimum number of years this house will survive before the town rebuilds it.
HouseZones building_availability
where can it be built (climates, zones)
static std::vector< HouseSpec > & Specs()
Get a reference to all HouseSpecs.
Defines the internal data of a functional industry.
static Industry * GetByTile(TileIndex tile)
Get the industry of the given tile.
Size related data of the map.
static uint ScaleBySize(uint n)
Scales the given value by the map size, where the given value is for a 256 by 256 map.
static IterateWrapper Iterate()
Returns an iterable ensemble of all Tiles.
static debug_inline uint Size()
Get the size of the map.
An object, such as transmitter, on the map.
ObjectType type
Type of the object.
Town * town
Town the object is built in.
static Object * GetByTile(TileIndex tile)
Get the object associated with a tile.
Represents the covered area of e.g.
void Add(TileIndex to_add)
Add a single tile to a tile area; enlarge if needed.
SpriteID sprite
The 'real' sprite.
PaletteID pal
The palette (use PAL_NONE) if not needed)
Coordinates of a point in 2D.
static Pool::IterateWrapper< Titem > Iterate(size_t from=0)
Returns an iterable ensemble of all valid Titem.
static size_t GetPoolSize()
Returns first unused index.
static Titem * Get(auto index)
Returns Titem with given index.
static size_t GetNumItems()
Returns number of valid items in the pool.
Tindex index
Index of this pool item.
static bool CanAllocateItem(size_t n=1)
Helper functions so we can use PoolItem::Function() instead of _poolitem_pool.Function()
static bool IsValidID(auto index)
Tests whether given index can be used to get valid (non-nullptr) Titem.
static bool CleaningPool()
Returns current state of pool cleaning - yes or no.
static Titem * GetIfValid(auto index)
Returns Titem with given index.
Base class for all pools.
static constexpr size_t MAX_SIZE
Make template parameter accessible from outside.
A location from where cargo can come from (or go to).
static Pool::IterateWrapper< Station > Iterate(size_t from=0)
Returns an iterable ensemble of all valid stations of type T.
bool CatchmentCoversTown(TownID t) const
Test if the given town ID is covered by our catchment area.
uint16_t override_id
id of the entity been replaced by
Tile description for the 'land area information' tool.
std::optional< std::string > grf
newGRF used for the tile contents
StringID str
Description of the tile.
std::array< Owner, 4 > owner
Name of the owner(s)
uint64_t dparam
Parameter of the str string.
std::optional< bool > town_can_upgrade
Whether the town can upgrade this house during town growth.
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.
Set of callback functions for performing tile operations of a given tile type.
uint32_t population
Current population of people.
uint32_t num_houses
Amount of houses.
TrackedViewportSign sign
Location of name sign, UpdateVirtCoord updates this.
BuildingCounts< uint16_t > building_counts
The number of each type of building in the town.
std::array< uint32_t, NUM_HOUSE_ZONES > squared_town_zone_radius
UpdateTownRadius updates this given the house count.
Struct holding parameters used to generate town name.
uint16_t type
town name style
uint32_t grfid
newgrf ID (0 if not used)
EncodedString text
General text with additional information.
bool larger_town
if this is a larger town and should grow more quickly
CompanyMask statues
which companies have a statue?
uint16_t time_until_rebuild
time until we rebuild a house
ReferenceThroughBaseContainer< std::array< int16_t, MAX_COMPANIES > > ratings
ratings of each company for this town
std::string cached_name
NOSAVE: Cache of the resolved name of the town, if not using a custom town name.
TileIndex xy
town center tile
uint8_t fund_buildings_months
fund buildings program in action?
TownLayout layout
town specific road layout
static Town * GetRandom()
Return a random valid town.
ReferenceThroughBaseContainer< std::array< uint8_t, MAX_COMPANIES > > unwanted
how many months companies aren't wanted by towns (bribe)
std::string name
Custom town name. If empty, the town was not renamed and uses the generated name.
uint16_t grow_counter
counter to count when to grow, value is smaller than or equal to growth_rate
uint8_t flags
See TownFlags.
TownCache cache
Container for all cacheable data.
CompanyID exclusivity
which company has exclusivity
std::array< TransportedCargoStat< uint32_t >, NUM_CARGO > supplied
Cargo statistics about supplied cargo.
void InitializeLayout(TownLayout layout)
Assign the town layout.
bool show_zone
NOSAVE: mark town to show the local authority zone in the viewports.
uint8_t exclusive_counter
months till the exclusivity expires
void UpdateVirtCoord()
Resize the sign (label) of the town after it changes population.
CompanyMask have_ratings
which companies have a rating
uint16_t growth_rate
town growth rate
StationList stations_near
NOSAVE: List of nearby stations.
static void PostDestructor(size_t index)
Invalidating of the "nearest town cache" has to be done after removing item from the pool.
uint8_t road_build_months
fund road reconstruction in action?
std::array< TransportedCargoStat< uint16_t >, NUM_TAE > received
Cargo statistics about received cargotypes.
std::array< uint32_t, NUM_TAE > goal
Amount of cargo required for the town to grow.
void UpdatePosition(int center, int top, std::string_view str, std::string_view str_small={})
Update the position of the viewport sign.
bool kdtree_valid
Are the sign data valid for use with the _viewport_sign_kdtree?
Representation of a waypoint.
void DeleteSubsidyWith(Source source)
Delete the subsidies associated with a given cargo source type and id.
Functions related to subsidies.
bool IsTileFlat(TileIndex tile, int *h)
Check if a given tile is flat.
int GetTileMaxZ(TileIndex t)
Get top height of the tile inside the map.
int GetTileZ(TileIndex tile)
Get bottom height of the tile.
uint TileHash(uint x, uint y)
Calculate a hash value from a tile position.
bool IsTileOwner(Tile tile, Owner owner)
Checks if a tile belongs to the given owner.
int GetTileMaxPixelZ(TileIndex tile)
Get top height of the tile.
static debug_inline TileType GetTileType(Tile tile)
Get the tiletype of a given tile.
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.
TropicZone GetTropicZone(Tile tile)
Get the tropic zone.
static debug_inline bool IsTileType(Tile tile, TileType type)
Checks if a tile is a given tiletype.
Slope GetTileSlope(TileIndex tile)
Return the slope of a given tile inside the map.
static debug_inline uint TileHeight(Tile tile)
Returns the height of a tile.
static const uint TILE_SIZE
Tile size in world coordinates.
@ TROPICZONE_DESERT
Tile is desert.
constexpr TileIndex INVALID_TILE
The very nice invalid tile marker.
@ MP_TREES
Tile got trees.
@ MP_ROAD
A tile with road (or tram tracks)
@ MP_STATION
A tile of a station.
@ MP_TUNNELBRIDGE
Tunnel entry/exit and bridge heads.
@ MP_CLEAR
A tile without any structures, i.e. grass, rocks, farm fields etc.
@ MP_HOUSE
A house by a town.
@ MP_INDUSTRY
Part of an industry.
@ MP_VOID
Invisible tiles at the SW and SE border.
@ MP_OBJECT
Contains objects such as transmitters and owned land.
OrthogonalTileArea TileArea
Shorthand for the much more common orthogonal tile area.
Definition of Interval and OneShot timers.
Definition of the game-calendar-timer.
Definition of the game-economy-timer.
Definition of the tick-based game-timer.
static const uint TOWN_GROWTH_WINTER
The town only needs this cargo in the winter (any amount)
static const uint TOWN_GROWTH_DESERT
The town needs the cargo for growth when on desert (any amount)
@ TOWN_HAS_CHURCH
There can be only one church by town.
@ TOWN_HAS_STADIUM
There can be only one stadium by town.
@ TOWN_IS_GROWING
Conditions for town growth are met. Grow according to Town::growth_rate.
@ TOWN_CUSTOM_GROWTH
Growth rate is controlled by GS.
TownRatingCheckType
Action types that a company must ask permission for to a town authority.
@ TOWN_RATING_CHECK_TYPE_COUNT
Number of town checking action types.
static const uint CUSTOM_TOWN_NUMBER_DIFFICULTY
value for custom town number in difficulty settings
Town * CalcClosestTownFromTile(TileIndex tile, uint threshold=UINT_MAX)
Return the town closest to the given tile within threshold.
TownAction
Town actions of a company.
@ RoadRebuild
Rebuild the roads.
@ Bribe
Try to bribe the council.
@ BuildStatue
Build a statue.
@ BuyRights
Buy exclusive transport rights.
@ FundBuildings
Fund new buildings.
static const uint16_t TOWN_GROWTH_RATE_NONE
Special value for Town::growth_rate to disable town growth.
static bool RoadTypesAllowHouseHere(TileIndex t)
Checks whether at least one surrounding road allows to build a house here.
static bool CheckFree2x2Area(TileIndex tile, int z, bool noslope)
Checks if a house of size 2x2 can be built at this tile.
static bool TownLayoutAllows2x2HouseHere(Town *t, TileIndex tile)
Checks if the current town layout allows a 2x2 building here.
std::tuple< CommandCost, Money, TownID > CmdFoundTown(DoCommandFlags flags, TileIndex tile, TownSize size, bool city, TownLayout layout, bool random_location, uint32_t townnameparts, const std::string &text)
Create a new town.
void ChangeTownRating(Town *t, int add, int max, DoCommandFlags flags)
Changes town rating of the current company.
HouseZones GetClimateMaskForLandscape()
Get the HouseZones climate mask for the current landscape type.
static CommandCost TownActionAdvertiseSmall(Town *t, DoCommandFlags flags)
Perform the "small advertising campaign" town action.
static bool GrowTownWithExtraHouse(Town *t, TileIndex tile)
Grows the town with an extra house.
static CommandCost TownActionFundBuildings(Town *t, DoCommandFlags flags)
Perform the "fund new buildings" town action.
static bool IsTileAlignedToGrid(TileIndex tile, TownLayout layout)
Towns must all be placed on the same grid or when they eventually interpenetrate their road networks ...
static CommandCost TownActionBuildStatue(Town *t, DoCommandFlags flags)
Perform a 9x9 tiles circular search from the center of the town in order to find a free tile to place...
static CommandCost TownActionBribe(Town *t, DoCommandFlags flags)
Perform the "bribe" town action.
TileIndexDiff GetHouseNorthPart(HouseID &house)
Determines if a given HouseID is part of a multitile house.
static int GetRating(const Town *t)
Get the rating of a town for the _current_company.
uint GetDefaultTownsForMapSize()
Calculate the number of towns which should be on the map according to the current "town density" newg...
void ClearTownHouse(Town *t, TileIndex tile)
Clear a town house.
static uint GetNormalGrowthRate(Town *t)
Calculates town growth rate in normal conditions (custom growth rate not set).
TownActions GetMaskOfTownActions(CompanyID cid, const Town *t)
Get a list of available town authority actions.
static CommandCost TownActionBuyRights(Town *t, DoCommandFlags flags)
Perform the "buy exclusive transport rights" town action.
static bool GrowTownWithBridge(const Town *t, const TileIndex tile, const DiagDirection bridge_dir)
Grows the town with a bridge.
const CargoSpec * FindFirstCargoWithTownAcceptanceEffect(TownAcceptanceEffect effect)
Determines the first cargo with a certain town effect.
static TileIndex FindNearestGoodCoastalTownSpot(TileIndex tile, TownLayout layout)
Given a spot on the map (presumed to be a water tile), find a good coastal spot to build a city.
Town * ClosestTownFromTile(TileIndex tile, uint threshold)
Return the town closest (in distance or ownership) to a given tile, within a given threshold.
static bool IsRoadAllowedHere(Town *t, TileIndex tile, DiagDirection dir)
Check if a Road is allowed on a given tile.
static bool CanRoadContinueIntoNextTile(const Town *t, const TileIndex tile, const DiagDirection road_dir)
Checks if a town road can be continued into the next tile.
static void UpdateTownGrowCounter(Town *t, uint16_t prev_growth_rate)
Updates town grow counter after growth rate change.
static int CountActiveStations(Town *t)
Calculates amount of active stations in the range of town (HZB_TOWN_EDGE).
static CommandCost TownCanBePlacedHere(TileIndex tile)
Check if it's possible to place a town on a given tile.
static bool IsNeighbourRoadTile(TileIndex tile, const DiagDirection dir, uint dist_multi)
Check for parallel road inside a given distance.
CommandCost CmdPlaceHouse(DoCommandFlags flags, TileIndex tile, HouseID house, bool is_protected)
Place an individual house.
static bool _generating_town
Set if a town is being generated.
static bool CanFollowRoad(TileIndex tile, DiagDirection dir)
Checks whether a road can be followed or is a dead end, that can not be extended to the next tile.
static void MakeTownHouse(TileIndex tile, Town *t, uint8_t counter, uint8_t stage, HouseID type, uint8_t random_bits, bool is_protected)
Write house information into the map.
static bool TownLayoutAllowsHouseHere(Town *t, TileIndex tile)
Checks if the current town layout allows building here.
static void TileLoop_Town(TileIndex tile)
Tile callback function.
static bool CanBuildHouseHere(TileIndex tile, bool noslope)
Check if a house can be built here, based on slope, whether there's a bridge above,...
bool GenerateTowns(TownLayout layout, std::optional< uint > number)
Generate a number of towns with a given layout.
static bool GrowTownWithRoad(const Town *t, TileIndex tile, RoadBits rcmd)
Grows the town with a road piece.
CommandCost CmdDoTownAction(DoCommandFlags flags, TownID town_id, TownAction action)
Do a town action.
static void TownGenerateCargoBinomial(Town *t, TownProductionEffect tpe, uint8_t rate, StationFinder &stations)
Generate cargo for a house using the binomial algorithm.
static void UpdateTownRating(Town *t)
Monthly callback to update town and station ratings.
static void AdvanceHouseConstruction(TileIndex tile)
Increase the construction stage of a house.
static bool TownCanGrowRoad(TileIndex tile)
Test if town can grow road onto a specific tile.
uint32_t GetWorldPopulation()
Get the total population, the sum of all towns in the world.
static bool GrowTownWithTunnel(const Town *t, const TileIndex tile, const DiagDirection tunnel_dir)
Grows the town with a tunnel.
static std::map< const Town *, int > _town_test_ratings
Map of towns to modified ratings, while in town rating test-mode.
static CommandCost ClearTile_Town(TileIndex tile, DoCommandFlags flags)
Callback function to clear a house tile.
static bool CheckClearTile(TileIndex tile)
Check whether the land can be cleared.
static CommandCost TownActionAdvertiseMedium(Town *t, DoCommandFlags flags)
Perform the "medium advertising campaign" town action.
static void TownGenerateCargoOriginal(Town *t, TownProductionEffect tpe, uint8_t rate, StationFinder &stations)
Generate cargo for a house using the original algorithm.
static void ClearMakeHouseTile(TileIndex tile, Town *t, uint8_t counter, uint8_t stage, HouseID type, uint8_t random_bits, bool is_protected)
Clears tile and builds a house or house part.
void UpdateTownMaxPass(Town *t)
Update the maximum amount of monthly passengers and mail for a town, based on its population.
static void ChangePopulation(Town *t, int mod)
Change the town's population as recorded in the town cache, town label, and town directory.
static bool CheckTownBuild2x2House(TileIndex *tile, Town *t, int maxz, bool noslope)
Checks if a 1x2 or 2x1 building is allowed here, accounting for road layout and tile heights.
CargoArray GetAcceptedCargoOfHouse(const HouseSpec *hs)
Get accepted cargo of a house prototype.
static bool TownAllowedToBuildRoads()
Check if the town is allowed to build roads.
static bool GrowTown(Town *t)
Grow the town.
static void AddAcceptedCargoSetMask(CargoType cargo, uint amount, CargoArray &acceptance, CargoTypes &always_accepted)
Fill cargo acceptance array and always_accepted mask, if cargo type is valid.
static DiagDirection RandomDiagDir()
Return a random direction.
static TileIndex AlignTileToGrid(TileIndex tile, TownLayout layout)
Towns must all be placed on the same grid or when they eventually interpenetrate their road networks ...
static Town * CreateRandomTown(uint attempts, uint32_t townnameparts, TownSize size, bool city, TownLayout layout)
Create a random town somewhere in the world.
static void RemoveNearbyStations(Town *t, TileIndex tile, BuildingFlags flags)
Remove stations from nearby station list if a town is no longer in the catchment area of each.
CommandCost CmdExpandTown(DoCommandFlags flags, TownID town_id, uint32_t grow_amount)
Expand a town (scenario editor only).
static bool GrowTownAtRoad(Town *t, TileIndex tile)
Try to grow a town at a given road tile.
uint8_t GetTownActionCost(TownAction action)
Get cost factors for a TownAction.
CommandCost CmdTownSetText(DoCommandFlags flags, TownID town_id, const EncodedString &text)
Set a custom text in the Town window.
Town * CalcClosestTownFromTile(TileIndex tile, uint threshold)
Return the town closest to the given tile within threshold.
CommandCost CmdTownGrowthRate(DoCommandFlags flags, TownID town_id, uint16_t growth_rate)
Change the growth rate of the town.
static CommandCost TownActionRoadRebuild(Town *t, DoCommandFlags flags)
Perform the "local road reconstruction" town action.
void ClearAllTownCachedNames()
Clear the cached_name of all towns.
CommandCost CmdDeleteTown(DoCommandFlags flags, TownID town_id)
Delete a town (scenario editor or worldgen only).
static Foundation GetFoundation_Town(TileIndex tile, Slope tileh)
Get the foundation for a house.
static TimerGameCalendar::Date GetTownRoadTypeFirstIntroductionDate()
Get the calendar date of the earliest town-buildable road type.
static void AnimateTile_Town(TileIndex tile)
Animate a tile for a town.
const TileTypeProcs _tile_type_town_procs
Tile callback functions for a town.
RoadType GetTownRoadType()
Get the road type that towns should build at this current moment.
static RoadBits GetTownRoadBits(TileIndex tile)
Return the RoadBits of a tile, ignoring depot and bay road stops.
CommandCost CmdRenameTown(DoCommandFlags flags, TownID town_id, const std::string &text)
Rename a town (server-only).
CommandCost CmdTownCargoGoal(DoCommandFlags flags, TownID town_id, TownAcceptanceEffect tae, uint32_t goal)
Change the cargo goal of a town.
static void DoCreateTown(Town *t, TileIndex tile, uint32_t townnameparts, TownSize size, bool city, TownLayout layout, bool manual)
Actually create a town.
CommandCost CheckforTownRating(DoCommandFlags flags, Town *t, TownRatingCheckType type)
Does the town authority allow the (destructive) action of the current company?
HouseZone GetTownRadiusGroup(const Town *t, TileIndex tile)
Returns the bit corresponding to the town zone of the specified tile.
static bool TryBuildTownHouse(Town *t, TileIndex tile)
Tries to build a house at this tile.
static bool TestTownOwnsBridge(TileIndex tile, const Town *t)
Check if a town 'owns' a bridge.
void OnTick_Town()
Iterate through all towns and call their tick handler.
static CommandCost TownActionAdvertiseLarge(Town *t, DoCommandFlags flags)
Perform the "large advertising campaign" town action.
bool CheckTownRoadTypes()
Check if towns are able to build road.
static bool CheckTownBuild2House(TileIndex *tile, Town *t, int maxz, bool noslope, DiagDirection second)
Checks if a 1x2 or 2x1 building is allowed here, accounting for road layout and tile heights.
static void UpdateTownGrowthRate(Town *t)
Updates town growth rate.
static RoadBits GetTownRoadGridElement(Town *t, TileIndex tile, DiagDirection dir)
Generate the RoadBits of a grid tile.
static void AdvanceSingleHouseConstruction(TileIndex tile)
Helper function for house construction stage progression.
static void TownTickHandler(Town *t)
Handle the town tick for a single town, by growing the town if desired.
void SetTownRatingTestMode(bool mode)
Switch the town rating to test-mode, to allow commands to be tested without affecting current ratings...
static bool _town_rating_test
If true, town rating is in test-mode.
CommandCost CmdTownRating(DoCommandFlags flags, TownID town_id, CompanyID company_id, int16_t rating)
Change the rating of a company in a town.
void UpdateTownRadius(Town *t)
Update the cached town zone radii of a town, based on the number of houses.
void AddAcceptedCargoOfHouse(TileIndex tile, HouseID house, const HouseSpec *hs, Town *t, CargoArray &acceptance, CargoTypes &always_accepted)
Determine accepted cargo for a house.
static bool IsCloseToTown(TileIndex tile, uint dist)
Determines if a town is close to a tile.
static void UpdateTownGrowth(Town *t)
Updates town growth state (whether it is growing or not).
static void DoClearTownHouseHelper(TileIndex tile, Town *t, HouseID house)
Update data structures when a house is removed.
static RoadBits GenRandomRoadBits()
Generate a random road block.
static bool CheckBuildHouseSameZ(TileIndex tile, int z, bool noslope)
Check if a tile where we want to build a multi-tile house has an appropriate max Z.
static TownGrowthResult GrowTownInTile(TileIndex *tile_ptr, RoadBits cur_rb, DiagDirection target_dir, Town *t1)
Grows the given town.
CommandCost CheckIfAuthorityAllowsNewStation(TileIndex tile, DoCommandFlags flags)
Checks whether the local authority allows construction of a new station (rail, road,...
static void BuildTownHouse(Town *t, TileIndex tile, const HouseSpec *hs, HouseID house, uint8_t random_bits, bool house_completed, bool is_protected)
Build a house at this tile.
static void TownGenerateCargo(Town *t, CargoType cargo, uint amount, StationFinder &stations, bool affected_by_recession)
Generate cargo for a house, scaled by the current economy scale.
static bool IsUniqueTownName(const std::string &name)
Verifies this custom name is unique.
static void DrawTile_Town(TileInfo *ti)
Draw a house and its tile.
void UpdateAllTownVirtCoords()
Update the virtual coords needed to draw the town sign for all towns.
Command definitions related to towns.
Declarations for accessing the k-d tree of towns.
Sprites to use and how to display them for town tiles.
static const DrawBuildingsTileStruct _town_draw_tile_data[]
structure of houses graphics
void IncrementHouseAge(Tile t)
Increments the age of the house.
void HaltLift(Tile t)
Stop the lift of this animated house from moving.
HouseID GetHouseType(Tile t)
Get the type of this house, which is an index into the house spec array.
void ResetHouseAge(Tile t)
Sets the age of the house to zero.
void MakeHouseTile(Tile t, TownID tid, uint8_t counter, uint8_t stage, HouseID type, uint8_t random_bits, bool house_protected)
Make the tile a house.
void IncHouseConstructionTick(Tile t)
Sets the increment stage of a house It is working with the whole counter + stage 5 bits,...
uint8_t GetLiftPosition(Tile t)
Get the position of the lift on this animated house.
void SetLiftDestination(Tile t, uint8_t dest)
Set the new destination of the lift for this animated house, and activate the LiftHasDestination bit.
TimerGameCalendar::Year GetHouseAge(Tile t)
Get the age of the house.
void SetLiftPosition(Tile t, uint8_t pos)
Set the position of the lift on this animated house.
uint8_t GetLiftDestination(Tile t)
Get the current destination for this lift.
uint8_t GetHouseBuildingStage(Tile t)
House Construction Scheme.
TownID GetTownIndex(Tile t)
Get the index of which town this house/street is attached to.
void SetTownIndex(Tile t, TownID index)
Set the town index for a road or house tile.
bool LiftHasDestination(Tile t)
Check if the lift of this animated house has a destination.
bool IsHouseCompleted(Tile t)
Get the completion of this house.
bool IsHouseProtected(Tile t)
Check if the house is protected from removal by towns.
uint8_t GetHouseConstructionTick(Tile t)
Gets the construction stage of a house.
static constexpr int RATING_GROWTH_UP_STEP
when a town grows, all companies have rating increased a bit ...
static constexpr int RATING_INITIAL
initial rating
static constexpr int RATING_ROAD_NEEDED_HOSTILE
"Hostile"
@ TCGM_BITCOUNT
Bit-counted algorithm (normal distribution from individual house population)
@ TCGM_ORIGINAL
Original algorithm (quadratic cargo by population)
static constexpr int RATING_ROAD_NEEDED_NEUTRAL
"Neutral"
@ TL_3X3_GRID
Geometric 3x3 grid algorithm.
@ TL_ORIGINAL
Original algorithm (min. 1 distance between roads)
@ TL_2X2_GRID
Geometric 2x2 grid algorithm.
@ TL_RANDOM
Random town layout.
@ TL_BETTER_ROADS
Extended original algorithm (min. 2 distance between roads)
@ NUM_TLS
Number of town layouts.
static constexpr int RATING_TUNNEL_BRIDGE_NEEDED_LENIENT
rating needed, "Lenient" difficulty settings
@ TF_CUSTOM_LAYOUT
Allowed, with custom town layout.
static constexpr int RATING_TUNNEL_BRIDGE_NEEDED_HOSTILE
"Hostile"
static constexpr int RATING_TUNNEL_BRIDGE_NEEDED_PERMISSIVE
"Permissive" (local authority disabled)
static constexpr int RATING_TUNNEL_BRIDGE_NEEDED_NEUTRAL
"Neutral"
static constexpr int RATING_ROAD_NEEDED_LENIENT
rating needed, "Lenient" difficulty settings
TownSize
Supported initial town sizes.
@ TSZ_RANDOM
Random size, bigger than small, smaller than large.
@ TSZ_END
Number of available town sizes.
static const uint MAX_LENGTH_TOWN_NAME_CHARS
The maximum length of a town name in characters including '\0'.
static constexpr int RATING_ROAD_NEEDED_PERMISSIVE
"Permissive" (local authority disabled)
static constexpr int RATING_GROWTH_MAXIMUM
... up to RATING_MEDIOCRE
bool VerifyTownName(uint32_t r, const TownNameParams *par, TownNames *town_names)
Verifies the town name is valid and unique.
bool GenerateTownName(Randomizer &randomizer, uint32_t *townnameparts, TownNames *town_names)
Generates valid town name.
Town name generator stuff.
bool IsTransparencySet(TransparencyOption to)
Check if the transparency option bit is set and if we aren't in the game menu (there's never transpar...
bool IsInvisibilitySet(TransparencyOption to)
Check if the invisibility option bit is set and if we aren't in the game menu (there's never transpar...
@ TO_HOUSES
town buildings
TransportType
Available types of transport.
@ TRANSPORT_ROAD
Transport by road vehicle.
Command definitions related to tunnels and bridges.
Functions that have tunnels and bridges in common.
DiagDirection GetTunnelBridgeDirection(Tile t)
Get the direction pointing to the other end.
TransportType GetTunnelBridgeTransportType(Tile t)
Tunnel: Get the transport type of the tunnel (road or rail) Bridge: Get the transport type of the bri...
TileIndex GetOtherTunnelBridgeEnd(Tile t)
Determines type of the wormhole and returns its other end.
void AddSortableSpriteToDraw(SpriteID image, PaletteID pal, int x, int y, int w, int h, int dz, int z, bool transparent, int bb_offset_x, int bb_offset_y, int bb_offset_z, const SubSprite *sub)
Draw a (transparent) sprite at given coordinates with a given bounding box.
void AddChildSpriteScreen(SpriteID image, PaletteID pal, int x, int y, bool transparent, const SubSprite *sub, bool scale, bool relative)
Add a child sprite to a parent sprite.
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.
Functions related to (drawing on) viewports.
bool HasTileWaterGround(Tile t)
Checks whether the tile has water at the ground.
bool IsWaterTile(Tile t)
Is it a water tile with plain water?
bool IsSea(Tile t)
Is it a sea water tile?
void CloseWindowById(WindowClass cls, WindowNumber number, bool force, int data)
Close a window by its class and window number (if it is open).
void SetWindowClassesDirty(WindowClass cls)
Mark all windows of a particular class as dirty (in need of repainting)
void InvalidateWindowData(WindowClass cls, WindowNumber number, int data, bool gui_scope)
Mark window data of the window of a given class and specific window number as invalid (in need of re-...
void SetWindowDirty(WindowClass cls, WindowNumber number)
Mark window as dirty (in need of repainting)
Window functions not directly related to making/drawing windows.
@ WC_TOWN_AUTHORITY
Town authority; Window numbers:
@ WC_STATION_VIEW
Station view; Window numbers:
@ WC_TOWN_VIEW
Town view; Window numbers:
@ WC_TOWN_DIRECTORY
Town directory; Window numbers: