Data Structures | Typedefs | Enumerations | Functions | Variables

town_cmd.cpp File Reference

Handling of town tiles. More...

#include "stdafx.h"
#include "road_internal.h"
#include "road_cmd.h"
#include "landscape.h"
#include "viewport_func.h"
#include "cmd_helper.h"
#include "command_func.h"
#include "industry.h"
#include "station_base.h"
#include "company_base.h"
#include "news_func.h"
#include "error.h"
#include "object.h"
#include "genworld.h"
#include "newgrf_debug.h"
#include "newgrf_house.h"
#include "newgrf_text.h"
#include "autoslope.h"
#include "tunnelbridge_map.h"
#include "strings_func.h"
#include "window_func.h"
#include "string_func.h"
#include "newgrf_cargo.h"
#include "cheat_type.h"
#include "animated_tile_func.h"
#include "date_func.h"
#include "subsidy_func.h"
#include "core/pool_func.hpp"
#include "town.h"
#include "townname_func.h"
#include "core/random_func.hpp"
#include "core/backup_type.hpp"
#include "depot_base.h"
#include "object_map.h"
#include "object_base.h"
#include "ai/ai.hpp"
#include "game/game.hpp"
#include "table/strings.h"
#include "table/town_land.h"

Go to the source code of this file.

Data Structures

struct  SpotData
 Used as the user_data for FindFurthestFromWater. More...
struct  StatueBuildSearchData
 Structure for storing data while searching the best place to build a statue. More...

Typedefs

typedef void TownDrawTileProc (const TileInfo *ti)
typedef CommandCost TownActionProc (Town *t, DoCommandFlag flags)

Enumerations

enum  TownGrowthResult { GROWTH_SUCCEED = -1, GROWTH_SEARCH_STOPPED = 0 }

Functions

static bool BuildTownHouse (Town *t, TileIndex tile)
 Tries to build a house at this tile.
static TownCreateRandomTown (uint attempts, uint32 townnameparts, TownSize size, bool city, TownLayout layout)
static void TownDrawHouseLift (const TileInfo *ti)
static DiagDirection RandomDiagDir ()
 Return a random direction.
static void DrawTile_Town (TileInfo *ti)
 House Tile drawing handler.
static int GetSlopePixelZ_Town (TileIndex tile, uint x, uint y)
static Foundation GetFoundation_Town (TileIndex tile, Slope tileh)
 Tile callback routine.
static void AnimateTile_Town (TileIndex tile)
 Animate a tile for a town Only certain houses can be animated The newhouses animation superseeds regular ones.
static bool IsCloseToTown (TileIndex tile, uint dist)
 Determines if a town is close to a tile.
void UpdateAllTownVirtCoords ()
 Update the virtual coords needed to draw the town sign for all towns.
static void ChangePopulation (Town *t, int mod)
 Change the towns population.
uint32 GetWorldPopulation ()
 Determines the world population Basically, count population of all towns, one by one.
static void MakeSingleHouseBigger (TileIndex tile)
 Helper function for house completion stages progression.
static void MakeTownHouseBigger (TileIndex tile)
 Make the house advance in its construction stages until completion.
static void TileLoop_Town (TileIndex tile)
 Tile callback function.
static CommandCost ClearTile_Town (TileIndex tile, DoCommandFlag flags)
static void AddProducedCargo_Town (TileIndex tile, CargoArray &produced)
static void AddAcceptedCargoSetMask (CargoID cargo, uint amount, CargoArray &acceptance, uint32 *always_accepted)
static void AddAcceptedCargo_Town (TileIndex tile, CargoArray &acceptance, uint32 *always_accepted)
static void GetTileDesc_Town (TileIndex tile, TileDesc *td)
static TrackStatus GetTileTrackStatus_Town (TileIndex tile, TransportType mode, uint sub_mode, DiagDirection side)
static void ChangeTileOwner_Town (TileIndex tile, Owner old_owner, Owner new_owner)
void UpdateTownCargoTotal (Town *t)
 Update the total cargo acceptance of the whole town.
static void UpdateTownCargoes (Town *t, TileIndex start, bool update_total=true)
 Update accepted town cargoes around a specific tile.
void UpdateTownCargoes (Town *t)
 Update cargo acceptance for the complete town.
void UpdateTownCargoBitmap ()
 Updates the bitmap of all cargoes accepted by houses.
static bool GrowTown (Town *t)
 Grow the town.
static void TownTickHandler (Town *t)
void OnTick_Town ()
static RoadBits GetTownRoadBits (TileIndex tile)
 Return the RoadBits of a tile.
static bool IsNeighborRoadTile (TileIndex tile, const DiagDirection dir, uint dist_multi)
 Check for parallel road inside a given distance.
static bool IsRoadAllowedHere (Town *t, TileIndex tile, DiagDirection dir)
 Check if a Road is allowed on a given tile.
static bool TerraformTownTile (TileIndex tile, int edges, int dir)
static void LevelTownLand (TileIndex tile)
static RoadBits GetTownRoadGridElement (Town *t, TileIndex tile, DiagDirection dir)
 Generate the RoadBits of a grid tile.
static bool GrowTownWithExtraHouse (Town *t, TileIndex tile)
 Grows the town with an extra house.
static bool GrowTownWithRoad (const Town *t, TileIndex tile, RoadBits rcmd)
 Grows the town with a road piece.
static bool GrowTownWithBridge (const Town *t, const TileIndex tile, const DiagDirection bridge_dir)
 Grows the town with a bridge.
static void GrowTownInTile (TileIndex *tile_ptr, RoadBits cur_rb, DiagDirection target_dir, Town *t1)
 Grows the given town.
static int GrowTownAtRoad (Town *t, TileIndex tile)
 Returns "growth" if a house was built, or no if the build failed.
static RoadBits GenRandomRoadBits ()
 Generate a random road block.
void UpdateTownRadius (Town *t)
void UpdateTownMaxPass (Town *t)
static void DoCreateTown (Town *t, TileIndex tile, uint32 townnameparts, TownSize size, bool city, TownLayout layout, bool manual)
 Does the actual town creation.
static CommandCost TownCanBePlacedHere (TileIndex tile)
 Checks if it's possible to place a town at given tile.
static bool IsUniqueTownName (const char *name)
 Verifies this custom name is unique.
CommandCost CmdFoundTown (TileIndex tile, DoCommandFlag flags, uint32 p1, uint32 p2, const char *text)
 Create a new town.
static TileIndex AlignTileToGrid (TileIndex tile, TownLayout layout)
 Towns must all be placed on the same grid or when they eventually interpenetrate their road networks will not mesh nicely; this function adjusts a tile so that it aligns properly.
static bool IsTileAlignedToGrid (TileIndex tile, TownLayout layout)
 Towns must all be placed on the same grid or when they eventually interpenetrate their road networks will not mesh nicely; this function tells you if a tile is properly aligned.
static bool FindFurthestFromWater (TileIndex tile, void *user_data)
 CircularTileSearch callback; finds the tile furthest from any water.
static bool FindNearestEmptyLand (TileIndex tile, void *user_data)
 CircularTileSearch callback; finds the nearest land tile.
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.
bool GenerateTowns (TownLayout layout)
 This function will generate a certain amount of towns, with a certain layout It can be called from the scenario editor (i.e.
HouseZonesBits GetTownRadiusGroup (const Town *t, TileIndex tile)
 Returns the bit corresponding to the town zone of the specified tile.
static void ClearMakeHouseTile (TileIndex tile, Town *t, byte counter, byte stage, HouseID type, byte random_bits)
 Clears tile and builds a house or house part.
static void MakeTownHouse (TileIndex t, Town *town, byte counter, byte stage, HouseID type, byte random_bits)
 Write house information into the map.
static bool CanBuildHouseHere (TileIndex tile, TownID town, bool noslope)
 Checks if a house can be built here.
static bool CheckBuildHouseSameZ (TileIndex tile, TownID town, int z, bool noslope)
 Checks if a house can be built at this tile, must have the same max z as parameter.
static bool CheckFree2x2Area (TileIndex tile, TownID town, int z, bool noslope)
 Checks if a house of size 2x2 can be built at this tile.
static bool TownLayoutAllowsHouseHere (Town *t, TileIndex tile)
 Checks if current town layout allows building here.
static bool TownLayoutAllows2x2HouseHere (Town *t, TileIndex tile)
 Checks if current town layout allows 2x2 building here.
static bool CheckTownBuild2House (TileIndex *tile, Town *t, int maxz, bool noslope, DiagDirection second)
 Checks if 1x2 or 2x1 building is allowed here, also takes into account current town layout Also, tests both building positions that occupy this tile.
static bool CheckTownBuild2x2House (TileIndex *tile, Town *t, int maxz, bool noslope)
 Checks if 2x2 building is allowed here, also takes into account current town layout Also, tests all four building positions that occupy this tile.
static void DoClearTownHouseHelper (TileIndex tile, Town *t, HouseID house)
 Update data structures when a house is removed.
TileIndexDiff GetHouseNorthPart (HouseID &house)
 Determines if a given HouseID is part of a multitile house.
void ClearTownHouse (Town *t, TileIndex tile)
CommandCost CmdRenameTown (TileIndex tile, DoCommandFlag flags, uint32 p1, uint32 p2, const char *text)
 Rename a town (server-only).
const CargoSpecFindFirstCargoWithTownEffect (TownEffect effect)
 Determines the first cargo with a certain town effect.
static void UpdateTownGrowRate (Town *t)
CommandCost CmdTownCargoGoal (TileIndex tile, DoCommandFlag flags, uint32 p1, uint32 p2, const char *text)
 Change the cargo goal of a town.
CommandCost CmdTownSetText (TileIndex tile, DoCommandFlag flags, uint32 p1, uint32 p2, const char *text)
 Set a custom text in the Town window.
CommandCost CmdTownGrowthRate (TileIndex tile, DoCommandFlag flags, uint32 p1, uint32 p2, const char *text)
 Change the growth rate of the town.
CommandCost CmdExpandTown (TileIndex tile, DoCommandFlag flags, uint32 p1, uint32 p2, const char *text)
 Expand a town (scenario editor only).
CommandCost CmdDeleteTown (TileIndex tile, DoCommandFlag flags, uint32 p1, uint32 p2, const char *text)
 Delete a town (scenario editor or worldgen only).
static CommandCost TownActionAdvertiseSmall (Town *t, DoCommandFlag flags)
static CommandCost TownActionAdvertiseMedium (Town *t, DoCommandFlag flags)
static CommandCost TownActionAdvertiseLarge (Town *t, DoCommandFlag flags)
static CommandCost TownActionRoadRebuild (Town *t, DoCommandFlag flags)
static bool TryClearTile (TileIndex tile)
 Check whether the land can be cleared.
static bool SearchTileForStatue (TileIndex tile, void *user_data)
 Search callback function for TownActionBuildStatue.
static CommandCost TownActionBuildStatue (Town *t, DoCommandFlag flags)
 Perform a 9x9 tiles circular search from the center of the town in order to find a free tile to place a statue.
static CommandCost TownActionFundBuildings (Town *t, DoCommandFlag flags)
static CommandCost TownActionBuyRights (Town *t, DoCommandFlag flags)
static CommandCost TownActionBribe (Town *t, DoCommandFlag flags)
uint GetMaskOfTownActions (int *nump, CompanyID cid, const Town *t)
 Get a list of available actions to do at a town.
CommandCost CmdDoTownAction (TileIndex tile, DoCommandFlag flags, uint32 p1, uint32 p2, const char *text)
 Do a town action.
static void UpdateTownRating (Town *t)
static void UpdateTownAmounts (Town *t)
static void UpdateTownUnwanted (Town *t)
CommandCost CheckIfAuthorityAllowsNewStation (TileIndex tile, DoCommandFlag flags)
 Checks whether the local authority allows construction of a new station (rail, road, airport, dock) on the given tile.
TownCalcClosestTownFromTile (TileIndex tile, uint threshold)
 Return the town closest to the given tile within threshold.
TownClosestTownFromTile (TileIndex tile, uint threshold)
 Return the town closest (in distance or ownership) to a given tile, within a given threshold.
void SetTownRatingTestMode (bool mode)
 Switch the town rating to test-mode, to allow commands to be tested without affecting current ratings.
static int GetRating (const Town *t)
 Get the rating of a town for the _current_company.
void ChangeTownRating (Town *t, int add, int max, DoCommandFlag flags)
 Changes town rating of the current company.
CommandCost CheckforTownRating (DoCommandFlag flags, Town *t, TownRatingCheckType type)
 Does the town authority allow the (destructive) action of the current company?
void TownsMonthlyLoop ()
void TownsYearlyLoop ()
static CommandCost TerraformTile_Town (TileIndex tile, DoCommandFlag flags, int z_new, Slope tileh_new)
void ResetHouses ()

Variables

TownID _new_town_id
uint32 _town_cargoes_accepted
 Bitmap of all cargoes accepted by houses.
TownPool _town_pool ("Town")
static int _grow_town_result
static TownDrawTileProc *const _town_draw_tile_procs [1]
static const byte _num_initial_towns [4] = {5, 11, 23, 46}
const byte _town_action_costs [TACT_COUNT]
 Factor in the cost of each town action.
static TownActionProc *const _town_action_proc []
static bool _town_rating_test = false
 If true, town rating is in test-mode.
static SmallMap< const Town
*, int, 4 > 
_town_test_ratings
 Map of towns to modified ratings, while in town rating test-mode.
const TileTypeProcs _tile_type_town_procs
 Tile callback functions for a town.
HouseSpec _house_specs [HOUSE_MAX]

Detailed Description

Handling of town tiles.

Definition in file town_cmd.cpp.


Function Documentation

static TileIndex AlignTileToGrid ( TileIndex  tile,
TownLayout  layout 
) [static]

Towns must all be placed on the same grid or when they eventually interpenetrate their road networks will not mesh nicely; this function adjusts a tile so that it aligns properly.

Parameters:
tile the tile to start at
layout which town layout algo is in effect
Returns:
the adjusted tile

Definition at line 1717 of file town_cmd.cpp.

References TileX(), TileXY(), TileY(), TL_2X2_GRID, and TL_3X3_GRID.

static void AnimateTile_Town ( TileIndex  tile  )  [static]

Animate a tile for a town Only certain houses can be animated The newhouses animation superseeds regular ones.

Parameters:
tile TileIndex of the house to animate

Definition at line 289 of file town_cmd.cpp.

References _tick_counter, DeleteAnimatedTile(), GetHouseType(), GetLiftDestination(), GetLiftPosition(), HaltLift(), LiftHasDestination(), MarkTileDirtyByTile(), SetLiftDestination(), and SetLiftPosition().

static bool BuildTownHouse ( Town t,
TileIndex  tile 
) [static]
Town* CalcClosestTownFromTile ( TileIndex  tile,
uint  threshold 
)

Return the town closest to the given tile within threshold.

Parameters:
tile Starting point of the search.
threshold Biggest allowed distance to the town.
Returns:
Closest town to tile within threshold, or NULL if there is no such town.
Note:
This function only uses distance, the ClosestTownFromTile function also takes town ownership into account.

Definition at line 3127 of file town_cmd.cpp.

References DistanceManhattan(), and Town::xy.

Referenced by AfterLoadGame(), BuildObject(), ClosestTownFromTile(), CmdBuildBridge(), CmdBuildRoad(), CmdBuildTunnel(), Town::PostDestructor(), RemoveRoad(), and UpdateNearestTownForRoadTiles().

static bool CanBuildHouseHere ( TileIndex  tile,
TownID  town,
bool  noslope 
) [inline, static]

Checks if a house can be built here.

Important is slope, bridge above and ability to clear the land.

Parameters:
tile tile to check
town town that is checking
noslope are slopes (foundations) allowed?
Returns:
true iff house can be built here

Definition at line 1984 of file town_cmd.cpp.

References CMD_LANDSCAPE_CLEAR, DC_NO_WATER, DoCommand(), GetTileSlope(), GetTownIndex(), IsBridgeAbove(), IsSteepSlope(), IsTileType(), MayHaveBridgeAbove(), MP_HOUSE, SLOPE_FLAT, and CommandCost::Succeeded().

Referenced by BuildTownHouse(), and CheckBuildHouseSameZ().

static void ChangePopulation ( Town t,
int  mod 
) [static]

Change the towns population.

Parameters:
t Town which polulation has changed
mod polulation change (can be positive or negative)

Definition at line 380 of file town_cmd.cpp.

References Town::cache, Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem< Tpool >::index, InvalidateWindowData(), TownCache::population, Town::UpdateVirtCoord(), WC_TOWN_DIRECTORY, and WC_TOWN_VIEW.

Referenced by BuildTownHouse(), and MakeSingleHouseBigger().

void ChangeTownRating ( Town t,
int  add,
int  max,
DoCommandFlag  flags 
)

Changes town rating of the current company.

Parameters:
t Town to affect
add Value to add
max Minimum (add < 0) resp. maximum (add > 0) rating that should be achievable with this change.
flags Command flags, especially DC_NO_MODIFY_TOWN_RATING is tested

Definition at line 3231 of file town_cmd.cpp.

References _cheats, _current_company, DC_NO_MODIFY_TOWN_RATING, GetRating(), Town::have_ratings, Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem< Tpool >::index, Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_company_pool >::IsValidID(), Cheats::magic_bulldozer, Town::ratings, SetBit(), SetWindowDirty(), Cheat::value, and WC_TOWN_AUTHORITY.

Referenced by CheckAllowRemoveRoad(), CmdPlantTree(), DoClearBridge(), and DoClearTunnel().

static bool CheckBuildHouseSameZ ( TileIndex  tile,
TownID  town,
int  z,
bool  noslope 
) [inline, static]

Checks if a house can be built at this tile, must have the same max z as parameter.

Parameters:
tile tile to check
town town that is checking
z max z of this tile so more parts of a house are at the same height (with foundation)
noslope are slopes (foundations) allowed?
Returns:
true iff house can be built here
See also:
CanBuildHouseHere()

Definition at line 2010 of file town_cmd.cpp.

References CanBuildHouseHere(), and GetTileMaxZ().

Referenced by CheckFree2x2Area(), and CheckTownBuild2House().

CommandCost CheckforTownRating ( DoCommandFlag  flags,
Town t,
TownRatingCheckType  type 
)

Does the town authority allow the (destructive) action of the current company?

Parameters:
flags Checking flags of the command.
t Town that must allow the company action.
type Type of action that is wanted.
Returns:
A succeeded command if the action is allowed, a failed command if it is not allowed.

Definition at line 3268 of file town_cmd.cpp.

References _cheats, _current_company, _settings_game, DC_NO_TEST_TOWN_RATING, GameSettings::difficulty, GetRating(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem< Tpool >::index, Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_company_pool >::IsValidID(), Cheats::magic_bulldozer, RATING_TUNNEL_BRIDGE_NEEDED_HOSTILE, RATING_TUNNEL_BRIDGE_NEEDED_NEUTRAL, RATING_TUNNEL_BRIDGE_NEEDED_PERMISSIVE, return_cmd_error, SetDParam(), DifficultySettings::town_council_tolerance, and Cheat::value.

Referenced by CheckAllowRemoveRoad(), DoClearBridge(), and DoClearTunnel().

static bool CheckFree2x2Area ( TileIndex  tile,
TownID  town,
int  z,
bool  noslope 
) [static]

Checks if a house of size 2x2 can be built at this tile.

Parameters:
tile tile, N corner
town town that is checking
z maximum tile z so all tile have the same max z
noslope are slopes (foundations) allowed?
Returns:
true iff house can be built
See also:
CheckBuildHouseSameZ()

Definition at line 2030 of file town_cmd.cpp.

References CheckBuildHouseSameZ(), DIAGDIR_SE, and TileOffsByDiagDir().

Referenced by CheckTownBuild2x2House().

CommandCost CheckIfAuthorityAllowsNewStation ( TileIndex  tile,
DoCommandFlag  flags 
)

Checks whether the local authority allows construction of a new station (rail, road, airport, dock) on the given tile.

Parameters:
tile The tile where the station shall be constructed.
flags Command flags. DC_NO_TEST_TOWN_RATING is tested.
Returns:
Succeeded or failed command.

Definition at line 3106 of file town_cmd.cpp.

References _current_company, _settings_game, ClosestTownFromTile(), DC_NO_TEST_TOWN_RATING, EconomySettings::dist_local_authority, GameSettings::economy, Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem< Tpool >::index, Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_company_pool >::IsValidID(), Town::ratings, return_cmd_error, and SetDParam().

Referenced by CmdBuildAirport(), CmdBuildDock(), CmdBuildRailStation(), and CmdBuildRoadStop().

static bool CheckTownBuild2House ( TileIndex tile,
Town t,
int  maxz,
bool  noslope,
DiagDirection  second 
) [static]

Checks if 1x2 or 2x1 building is allowed here, also takes into account current town layout Also, tests both building positions that occupy this tile.

Parameters:
tile tile where the building should be built
t town
maxz all tiles should have the same height
noslope are slopes forbidden?
second diagdir from first tile to second tile

Definition at line 2119 of file town_cmd.cpp.

References CheckBuildHouseSameZ(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem< Tpool >::index, ReverseDiagDir(), TileOffsByDiagDir(), and TownLayoutAllowsHouseHere().

Referenced by BuildTownHouse().

static bool CheckTownBuild2x2House ( TileIndex tile,
Town t,
int  maxz,
bool  noslope 
) [static]

Checks if 2x2 building is allowed here, also takes into account current town layout Also, tests all four building positions that occupy this tile.

Parameters:
tile tile where the building should be built
t town
maxz all tiles should have the same height
noslope are slopes forbidden?

Definition at line 2144 of file town_cmd.cpp.

References CheckFree2x2Area(), DIAGDIR_END, DIAGDIR_SE, Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem< Tpool >::index, ReverseDiagDir(), TileOffsByDiagDir(), and TownLayoutAllows2x2HouseHere().

Referenced by BuildTownHouse().

static void ClearMakeHouseTile ( TileIndex  tile,
Town t,
byte  counter,
byte  stage,
HouseID  type,
byte  random_bits 
) [inline, static]

Clears tile and builds a house or house part.

Parameters:
tile tile index
t The town to clear the house for
counter of construction step
stage of construction (used for drawing)
type of house. Index into house specs array
random_bits required for newgrf houses
Precondition:
house can be built here

Definition at line 1941 of file town_cmd.cpp.

References AddAnimatedTile(), CMD_LANDSCAPE_CLEAR, DC_EXEC, DC_NO_WATER, DoCommand(), IncreaseBuildingCount(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem< Tpool >::index, MakeHouseTile(), MarkTileDirtyByTile(), and CommandCost::Succeeded().

Referenced by MakeTownHouse().

Town* ClosestTownFromTile ( TileIndex  tile,
uint  threshold 
)

Return the town closest (in distance or ownership) to a given tile, within a given threshold.

Parameters:
tile Starting point of the search.
threshold Biggest allowed distance to the town.
Returns:
Closest town to tile within threshold, or NULL if there is no such town.
Note:
If you only care about distance, you can use the CalcClosestTownFromTile function.

Definition at line 3152 of file town_cmd.cpp.

References _generating_world, CalcClosestTownFromTile(), DistanceManhattan(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_town_pool >::Get(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_town_pool >::GetNumItems(), GetTileType(), GetTownIndex(), HasTownOwnedRoad(), IsRoadDepot(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_town_pool >::IsValidID(), MP_HOUSE, MP_ROAD, and Town::xy.

Referenced by AfterLoadGame(), BuildStationPart(), CheckAllowRemoveRoad(), CheckIfAuthorityAllowsNewStation(), CheckIfCallBackAllowsCreation(), CmdBuildAirport(), CmdBuildBridge(), CmdDeleteTown(), CmdPlantTree(), CmdRemoveRoadStop(), DisasterTick_Big_Ufo(), DoClearBridge(), DoClearTunnel(), FindTownForIndustry(), GenerateCompanyName(), GetNameOfOwner(), StationResolverObject::GetTown(), ObjectResolverObject::GetTown(), IndustriesResolverObject::GetTown(), RailTypeScopeResolver::GetVariable(), ObjectScopeResolver::GetVariable(), IndustryTileScopeResolver::GetVariable(), AirportTileScopeResolver::GetVariable(), MakeDefaultName(), LandInfoWindow::OnInit(), and Town::~Town().

CommandCost CmdDeleteTown ( TileIndex  tile,
DoCommandFlag  flags,
uint32  p1,
uint32  p2,
const char *  text 
)
CommandCost CmdDoTownAction ( TileIndex  tile,
DoCommandFlag  flags,
uint32  p1,
uint32  p2,
const char *  text 
)

Do a town action.

This performs an action such as advertising, building a statue, funding buildings, but also bribing the town-council

Parameters:
tile unused
flags type of operation
p1 town to do the action at
p2 action to perform,
See also:
_town_action_proc for the list of available actions
Parameters:
text unused
Returns:
the cost of this operation or an error

Definition at line 2953 of file town_cmd.cpp.

References _current_company, CMD_ERROR, EXPENSES_OTHER, CommandCost::Failed(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_town_pool >::GetIfValid(), GetMaskOfTownActions(), HasBit(), lengthof, SetWindowDirty(), and WC_TOWN_AUTHORITY.

CommandCost CmdExpandTown ( TileIndex  tile,
DoCommandFlag  flags,
uint32  p1,
uint32  p2,
const char *  text 
)

Expand a town (scenario editor only).

Parameters:
tile Unused.
flags Type of operation.
p1 Town ID to expand.
p2 Amount to grow, or 0 to grow a random size up to the current amount of houses.
text Unused.
Returns:
Empty cost or an error.

Definition at line 2541 of file town_cmd.cpp.

References _current_company, Town::cache, ClampToU16(), CMD_ERROR, DC_EXEC, Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_town_pool >::GetIfValid(), GrowTown(), TownCache::num_houses, and OWNER_DEITY.

CommandCost CmdFoundTown ( TileIndex  tile,
DoCommandFlag  flags,
uint32  p1,
uint32  p2,
const char *  text 
)
CommandCost CmdRenameTown ( TileIndex  tile,
DoCommandFlag  flags,
uint32  p1,
uint32  p2,
const char *  text 
)

Rename a town (server-only).

Parameters:
tile unused
flags type of operation
p1 town ID to rename
p2 unused
text the new name or an empty string when resetting to the default
Returns:
the cost of this operation or an error

Definition at line 2407 of file town_cmd.cpp.

References CMD_ERROR, DC_EXEC, free(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_town_pool >::GetIfValid(), InvalidateWindowData(), IsUniqueTownName(), MAX_LENGTH_TOWN_NAME_CHARS, return_cmd_error, StrEmpty(), UpdateAllStationVirtCoords(), Town::UpdateVirtCoord(), Utf8StringLength(), and WC_TOWN_DIRECTORY.

CommandCost CmdTownCargoGoal ( TileIndex  tile,
DoCommandFlag  flags,
uint32  p1,
uint32  p2,
const char *  text 
)

Change the cargo goal of a town.

Parameters:
tile Unused.
flags Type of operation.
p1 various bitstuffed elements

  • p1 = (bit 0 - 15) - Town ID to cargo game of.
  • p1 = (bit 16 - 23) - TownEffect to change the game of.
p2 The new goal value.
text Unused.
Returns:
Empty cost or an error.

Definition at line 2457 of file town_cmd.cpp.

References _current_company, CMD_ERROR, DC_EXEC, FindFirstCargoWithTownEffect(), GB(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_town_pool >::GetIfValid(), Town::goal, InvalidateWindowData(), OWNER_DEITY, TE_END, UpdateTownGrowRate(), and WC_TOWN_VIEW.

CommandCost CmdTownGrowthRate ( TileIndex  tile,
DoCommandFlag  flags,
uint32  p1,
uint32  p2,
const char *  text 
)

Change the growth rate of the town.

Parameters:
tile Unused.
flags Type of operation.
p1 Town ID to cargo game of.
p2 Amount of days between growth.
text Unused.
Returns:
Empty cost or an error.

Definition at line 2514 of file town_cmd.cpp.

References _current_company, CMD_ERROR, DC_EXEC, GB(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_town_pool >::GetIfValid(), Town::growth_rate, InvalidateWindowData(), OWNER_DEITY, TOWN_GROW_RATE_CUSTOM, UpdateTownGrowRate(), and WC_TOWN_VIEW.

CommandCost CmdTownSetText ( TileIndex  tile,
DoCommandFlag  flags,
uint32  p1,
uint32  p2,
const char *  text 
)

Set a custom text in the Town window.

Parameters:
tile Unused.
flags Type of operation.
p1 Town ID to change the text of.
p2 Unused.
text The new text (empty to remove the text).
Returns:
Empty cost or an error.

Definition at line 2490 of file town_cmd.cpp.

References _current_company, CMD_ERROR, DC_EXEC, free(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_town_pool >::GetIfValid(), InvalidateWindowData(), OWNER_DEITY, StrEmpty(), Town::text, and WC_TOWN_VIEW.

static void DoClearTownHouseHelper ( TileIndex  tile,
Town t,
HouseID  house 
) [static]

Update data structures when a house is removed.

Parameters:
tile Tile of the house
t Town owning the house
house House type

Definition at line 2323 of file town_cmd.cpp.

References DecreaseBuildingCount(), DeleteAnimatedTile(), DeleteNewGRFInspectWindow(), IsTileType(), and MP_HOUSE.

static void DoCreateTown ( Town t,
TileIndex  tile,
uint32  townnameparts,
TownSize  size,
bool  city,
TownLayout  layout,
bool  manual 
) [static]
static void DrawTile_Town ( TileInfo ti  )  [static]
const CargoSpec* FindFirstCargoWithTownEffect ( TownEffect  effect  ) 

Determines the first cargo with a certain town effect.

Parameters:
effect Town effect of interest
Returns:
first active cargo slot with that effect

Definition at line 2435 of file town_cmd.cpp.

References CargoSpec::town_effect.

Referenced by AfterLoadGame(), CmdTownCargoGoal(), DoCreateTown(), and TownViewWindow::DrawWidget().

static bool FindFurthestFromWater ( TileIndex  tile,
void *  user_data 
) [static]

CircularTileSearch callback; finds the tile furthest from any water.

slightly bit tricky, since it has to do a search of its own in order to find the distance to the water from each square in the radius.

Also, this never returns true, because it needs to take into account all locations being searched before it knows which is the furthest.

Parameters:
tile Start looking from this tile
user_data Storage area for data that must last across calls; must be a pointer to struct SpotData
Returns:
always false

Definition at line 1769 of file town_cmd.cpp.

References GetClosestWaterDistance(), GetTileSlope(), IsTileAlignedToGrid(), IsTileType(), SpotData::layout, SpotData::max_dist, MP_CLEAR, SLOPE_FLAT, and SpotData::tile.

Referenced by FindNearestGoodCoastalTownSpot().

static bool FindNearestEmptyLand ( TileIndex  tile,
void *  user_data 
) [static]

CircularTileSearch callback; finds the nearest land tile.

Parameters:
tile Start looking from this tile
user_data not used

Definition at line 1791 of file town_cmd.cpp.

References IsTileType(), and MP_CLEAR.

Referenced by FindNearestGoodCoastalTownSpot().

static TileIndex FindNearestGoodCoastalTownSpot ( TileIndex  tile,
TownLayout  layout 
) [static]

Given a spot on the map (presumed to be a water tile), find a good coastal spot to build a city.

We don't want to build too close to the edge if we can help it (since that retards city growth) hence the search within a search within a search. O(n*m^2), where n is how far to search for land, and m is how far inland to look for a flat spot.

Parameters:
tile Start looking from this spot.
layout the road layout to search for
Returns:
tile that was found

Definition at line 1808 of file town_cmd.cpp.

References CircularTileSearch(), FindFurthestFromWater(), FindNearestEmptyLand(), INVALID_TILE, and SpotData::tile.

bool GenerateTowns ( TownLayout  layout  ) 

This function will generate a certain amount of towns, with a certain layout It can be called from the scenario editor (i.e.

: generate Random Towns) as well as from world creation.

Parameters:
layout which towns will be set to, when created
Returns:
true if towns have been successfully created

Definition at line 1872 of file town_cmd.cpp.

References _settings_game, Chance16(), GameCreationSettings::custom_town_number, CUSTOM_TOWN_NUMBER_DIFFICULTY, GameSettings::difficulty, GameSettings::economy, GameSettings::game_creation, GenerateTownName(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_town_pool >::GetNumItems(), GWP_TOWN, IncreaseGeneratingWorldProgress(), INVALID_STRING_ID, EconomySettings::larger_towns, DifficultySettings::number_towns, ScaleByMapSize(), SetGeneratingWorldProgress(), ShowErrorMessage(), TSZ_RANDOM, and WL_CRITICAL.

Referenced by _GenerateWorld().

static RoadBits GenRandomRoadBits (  )  [static]

Generate a random road block.

The probability of a straight road is somewhat higher than a curved.

Returns:
A RoadBits value with 2 bits set

Definition at line 1360 of file town_cmd.cpp.

References GB(), and ROAD_NW.

Referenced by GrowTown().

TileIndexDiff GetHouseNorthPart ( HouseID house  ) 

Determines if a given HouseID is part of a multitile house.

The given ID is set to the ID of the north tile and the TileDiff to the north tile is returned.

Parameters:
house Is changed to the HouseID of the north tile of the same house
Returns:
TileDiff from the tile of the given HouseID to the north tile

Definition at line 2340 of file town_cmd.cpp.

References TileDiffXY().

Referenced by GetDistanceFromNearbyHouse(), RebuildTownCaches(), SearchNearbyHouseClass(), SearchNearbyHouseGRFID(), SearchNearbyHouseID(), UpdateHousesAndTowns(), and WatchedCargoCallback().

uint GetMaskOfTownActions ( int *  nump,
CompanyID  cid,
const Town t 
)
static int GetRating ( const Town t  )  [static]

Get the rating of a town for the _current_company.

Parameters:
t Town to get the rating from.
Returns:
Rating of the current company in the given town.

Definition at line 3213 of file town_cmd.cpp.

References _current_company, SmallVector< SmallPair< T, U >, S >::End(), SmallMap< T, U, S >::Find(), and Town::ratings.

Referenced by ChangeTownRating(), and CheckforTownRating().

HouseZonesBits GetTownRadiusGroup ( const Town t,
TileIndex  tile 
)

Returns the bit corresponding to the town zone of the specified tile.

Parameters:
t Town on which town zone is to be found
tile TileIndex where town zone needs to be found
Returns:
the bit position of the given zone, as defined in HouseZones

Definition at line 1917 of file town_cmd.cpp.

References DistanceSquare(), Town::fund_buildings_months, and Town::xy.

Referenced by BuildTownHouse(), RailTypeScopeResolver::GetVariable(), ObjectScopeResolver::GetVariable(), IndustryTileScopeResolver::GetVariable(), IndustriesScopeResolver::GetVariable(), HouseScopeResolver::GetVariable(), and AirportTileScopeResolver::GetVariable().

static RoadBits GetTownRoadBits ( TileIndex  tile  )  [static]

Return the RoadBits of a tile.

Note:
There are many other functions doing things like that.
Needs to be checked for needlessness.
Parameters:
tile The tile we want to analyse
Returns:
The roadbits of the given tile

Definition at line 795 of file town_cmd.cpp.

References GetAnyRoadBits(), IsRoadDepotTile(), IsStandardRoadStopTile(), and ROADTYPE_ROAD.

Referenced by GrowTown(), GrowTownAtRoad(), GrowTownWithBridge(), IsNeighborRoadTile(), and IsRoadAllowedHere().

static RoadBits GetTownRoadGridElement ( Town t,
TileIndex  tile,
DiagDirection  dir 
) [static]

Generate the RoadBits of a grid tile.

Parameters:
t current town
tile tile in reference to the town
dir The direction to which we are growing ATM
Returns:
the RoadBit of the current tile regarding the selected town layout

Definition at line 923 of file town_cmd.cpp.

References DiagDirToRoadBits(), GetTileSlope(), Town::layout, ReverseDiagDir(), ROAD_ALL, ROAD_NE, ROAD_NW, ROAD_SE, ROAD_SW, ROAD_X, ROAD_Y, SLOPE_E, SLOPE_N, SLOPE_NE, SLOPE_NW, SLOPE_S, SLOPE_SE, SLOPE_STEEP_E, SLOPE_STEEP_N, SLOPE_STEEP_S, SLOPE_STEEP_W, SLOPE_SW, SLOPE_W, TileIndexToTileIndexDiffC(), TL_2X2_GRID, TL_3X3_GRID, TileIndexDiffC::x, Town::xy, and TileIndexDiffC::y.

Referenced by GrowTownInTile().

uint32 GetWorldPopulation (  ) 

Determines the world population Basically, count population of all towns, one by one.

Returns:
uint32 the calculated population of the world

Definition at line 394 of file town_cmd.cpp.

References Town::cache, and TownCache::population.

Referenced by TownDirectoryWindow::SetStringParameters().

static bool GrowTown ( Town t  )  [static]
static int GrowTownAtRoad ( Town t,
TileIndex  tile 
) [static]
static void GrowTownInTile ( TileIndex tile_ptr,
RoadBits  cur_rb,
DiagDirection  target_dir,
Town t1 
) [static]

Grows the given town.

There are at the moment 3 possible way's for the town expansion:

  • Generate a random tile and check if there is a road allowed
  • TL_ORIGINAL
  • TL_BETTER_ROADS
  • Check if the town geometry allows a road and which one
  • TL_2X2_GRID
  • TL_3X3_GRID
  • Forbid roads, only build houses
Parameters:
tile_ptr The current tile
cur_rb The current tiles RoadBits
target_dir The target road dir
t1 The current town

Definition at line 1116 of file town_cmd.cpp.

References _generating_world, _settings_game, EconomySettings::allow_town_level_crossings, EconomySettings::allow_town_roads, ConstructionSettings::build_on_slopes, BuildTownHouse(), Chance16(), ChangeDiagDir(), CleanUpRoadBits(), GameSettings::construction, DIAGDIR_END, DIAGDIRDIFF_90LEFT, DIAGDIRDIFF_90RIGHT, DiagDirToRoadBits(), GameSettings::economy, GetOtherTunnelBridgeEnd(), GetTownRoadGridElement(), GetTunnelBridgeTransportType(), GrowTownWithBridge(), GrowTownWithExtraHouse(), GrowTownWithRoad(), HasTileWaterGround(), IsRoadAllowedHere(), IsTileType(), IsValidTile(), Town::layout, MapSize(), MP_HOUSE, MP_RAILWAY, MP_TUNNELBRIDGE, RandomDiagDir(), ReverseDiagDir(), ROAD_NONE, TileAddByDiagDir(), TL_2X2_GRID, TL_3X3_GRID, TL_BETTER_ROADS, TL_ORIGINAL, and TRANSPORT_ROAD.

Referenced by GrowTownAtRoad().

static bool GrowTownWithBridge ( const Town t,
const TileIndex  tile,
const DiagDirection  bridge_dir 
) [static]

Grows the town with a bridge.

At first we check if a bridge is reasonable. If so we check if we are able to build it.

Parameters:
t The current town
tile The current tile
bridge_dir The valid direction in which to grow a bridge
Returns:
true if a bridge has been build else false

Definition at line 1043 of file town_cmd.cpp.

References CMD_BUILD_BRIDGE, CommandFlagsToDCFlags(), DC_EXEC, DIAGDIR_END, DiagDirToRoadBits(), DoCommand(), GetCommandFlags(), GetTileSlope(), GetTownRoadBits(), InclinedSlope(), IsSea(), IsValidTile(), IsWaterTile(), MAX_BRIDGES, ReverseDiagDir(), ROADTYPES_ROAD, SLOPE_FLAT, TileAddByDiagDir(), TileOffsByDiagDir(), and TRANSPORT_ROAD.

Referenced by GrowTownInTile().

static bool GrowTownWithExtraHouse ( Town t,
TileIndex  tile 
) [static]

Grows the town with an extra house.

Check if there are enough neighbor house tiles next to the current tile. If there are enough add another house.

Parameters:
t The current town
tile The target tile for the extra house
Returns:
true if an extra house has been added

Definition at line 982 of file town_cmd.cpp.

References BuildTownHouse(), DIAGDIR_BEGIN, DistanceFromEdge(), GetTileType(), MP_HOUSE, MP_VOID, and TileAddByDiagDir().

Referenced by GrowTownInTile().

static bool GrowTownWithRoad ( const Town t,
TileIndex  tile,
RoadBits  rcmd 
) [static]

Grows the town with a road piece.

Parameters:
t The current town
tile The current tile
rcmd The RoadBits we want to build on the tile
Returns:
true if the RoadBits have been added else false

Definition at line 1024 of file town_cmd.cpp.

References CMD_BUILD_ROAD, DC_EXEC, DC_NO_WATER, DoCommand(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem< Tpool >::index, and CommandCost::Succeeded().

Referenced by GrowTownInTile().

static bool IsCloseToTown ( TileIndex  tile,
uint  dist 
) [static]

Determines if a town is close to a tile.

Parameters:
tile TileIndex of the tile to query
dist maximum distance to be accepted
Returns:
true if the tile correspond to the distance criteria

Definition at line 340 of file town_cmd.cpp.

References DistanceManhattan(), and Town::xy.

Referenced by TownCanBePlacedHere().

static bool IsNeighborRoadTile ( TileIndex  tile,
const DiagDirection  dir,
uint  dist_multi 
) [static]

Check for parallel road inside a given distance.

Assuming a road from (tile - TileOffsByDiagDir(dir)) to tile, is there a parallel road left or right of it within distance dist_multi?

Parameters:
tile curent tile
dir target direction
dist_multi distance multiplyer
Returns:
true if there is a parallel road

Definition at line 812 of file town_cmd.cpp.

References ChangeDiagDir(), DIAGDIRDIFF_90LEFT, DIAGDIRDIFF_90RIGHT, DiagDirToRoadBits(), GetTownRoadBits(), IsValidTile(), ReverseDiagDir(), TILE_ADD, and TileOffsByDiagDir().

Referenced by IsRoadAllowedHere().

static bool IsRoadAllowedHere ( Town t,
TileIndex  tile,
DiagDirection  dir 
) [static]
static bool IsTileAlignedToGrid ( TileIndex  tile,
TownLayout  layout 
) [static]

Towns must all be placed on the same grid or when they eventually interpenetrate their road networks will not mesh nicely; this function tells you if a tile is properly aligned.

Parameters:
tile the tile to start at
layout which town layout algo is in effect
Returns:
true if the tile is in the correct location

Definition at line 1735 of file town_cmd.cpp.

References TileX(), TileY(), TL_2X2_GRID, and TL_3X3_GRID.

Referenced by FindFurthestFromWater().

static bool IsUniqueTownName ( const char *  name  )  [static]

Verifies this custom name is unique.

Only custom names are checked.

Parameters:
name name to check
Returns:
is this name unique?

Definition at line 1589 of file town_cmd.cpp.

Referenced by CmdFoundTown(), and CmdRenameTown().

static void MakeSingleHouseBigger ( TileIndex  tile  )  [static]

Helper function for house completion stages progression.

Parameters:
tile TileIndex of the house (or parts of it) to "grow"

Definition at line 407 of file town_cmd.cpp.

References ChangePopulation(), GetHouseConstructionTick(), GetHouseType(), IncHouseConstructionTick(), IsHouseCompleted(), IsTileType(), MarkTileDirtyByTile(), MP_HOUSE, and ResetHouseAge().

Referenced by MakeTownHouseBigger().

static void MakeTownHouse ( TileIndex  t,
Town town,
byte  counter,
byte  stage,
HouseID  type,
byte  random_bits 
) [static]

Write house information into the map.

For houses > 1 tile, all tiles are marked.

Parameters:
t tile index
town The town related to this house
counter of construction step
stage of construction (used for drawing)
type of house. Index into house specs array
random_bits required for newgrf houses
Precondition:
house can be built here

Definition at line 1965 of file town_cmd.cpp.

References HouseSpec::building_flags, ClearMakeHouseTile(), and TileDiffXY().

Referenced by BuildTownHouse().

static void MakeTownHouseBigger ( TileIndex  tile  )  [static]

Make the house advance in its construction stages until completion.

Parameters:
tile TileIndex of house

Definition at line 430 of file town_cmd.cpp.

References HouseSpec::building_flags, GetHouseType(), MakeSingleHouseBigger(), and TILE_ADDXY.

Referenced by TileLoop_Town().

static DiagDirection RandomDiagDir (  )  [inline, static]

Return a random direction.

Returns:
a random direction

Definition at line 200 of file town_cmd.cpp.

Referenced by GrowTownAtRoad(), and GrowTownInTile().

static bool SearchTileForStatue ( TileIndex  tile,
void *  user_data 
) [static]

Search callback function for TownActionBuildStatue.

Parameters:
tile Tile on which to perform the search.
user_data Reference to the statue search data.
Returns:
Result of the test.

Definition at line 2740 of file town_cmd.cpp.

References StatueBuildSearchData::best_position, GetTileSlope(), INVALID_TILE, IsBridgeAbove(), IsSteepSlope(), IsTileType(), MayHaveBridgeAbove(), MP_CLEAR, MP_HOUSE, MP_TREES, StatueBuildSearchData::tile_count, and TryClearTile().

Referenced by TownActionBuildStatue().

void SetTownRatingTestMode ( bool  mode  ) 

Switch the town rating to test-mode, to allow commands to be tested without affecting current ratings.

The function is safe to use in nested calls.

Parameters:
mode Test mode switch (true means go to test-mode, false means leave test-mode).

Definition at line 3193 of file town_cmd.cpp.

References SmallVector< SmallPair< T, U >, S >::Clear().

Referenced by DoCommand(), and DoCommandPInternal().

static void TileLoop_Town ( TileIndex  tile  )  [static]
static CommandCost TownActionBuildStatue ( Town t,
DoCommandFlag  flags 
) [static]

Perform a 9x9 tiles circular search from the center of the town in order to find a free tile to place a statue.

Parameters:
t town to search in
flags Used to check if the statue must be built or not.
Returns:
Empty cost or an error.

Definition at line 2783 of file town_cmd.cpp.

References _current_company, StatueBuildSearchData::best_position, BuildObject(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_object_pool >::CanAllocateItem(), CircularTileSearch(), CMD_LANDSCAPE_CLEAR, DoCommand(), INVALID_TILE, MarkTileDirtyByTile(), OBJECT_STATUE, OWNER_NONE, Backup< T >::Restore(), return_cmd_error, SearchTileForStatue(), SetBit(), Town::statues, and Town::xy.

static CommandCost TownCanBePlacedHere ( TileIndex  tile  )  [static]

Checks if it's possible to place a town at given tile.

Parameters:
tile tile to check
Returns:
error value or zero cost

Definition at line 1564 of file town_cmd.cpp.

References DistanceFromEdge(), EXPENSES_OTHER, GetTileSlope(), IsCloseToTown(), IsTileType(), MP_CLEAR, MP_TREES, return_cmd_error, and SLOPE_FLAT.

Referenced by CmdFoundTown().

static bool TownLayoutAllows2x2HouseHere ( Town t,
TileIndex  tile 
) [inline, static]

Checks if current town layout allows 2x2 building here.

Parameters:
t town
tile tile to check
Returns:
true iff town layout allows 2x2 building here
Note:
see layouts

Definition at line 2082 of file town_cmd.cpp.

References _generating_world, _settings_game, EconomySettings::allow_town_roads, GameSettings::economy, Town::layout, TileIndexToTileIndexDiffC(), TL_2X2_GRID, TL_3X3_GRID, TileIndexDiffC::x, Town::xy, and TileIndexDiffC::y.

Referenced by CheckTownBuild2x2House().

static bool TownLayoutAllowsHouseHere ( Town t,
TileIndex  tile 
) [inline, static]

Checks if current town layout allows building here.

Parameters:
t town
tile tile to check
Returns:
true iff town layout allows building here
Note:
see layouts

Definition at line 2051 of file town_cmd.cpp.

References _generating_world, _settings_game, EconomySettings::allow_town_roads, GameSettings::economy, Town::layout, TileIndexToTileIndexDiffC(), TL_2X2_GRID, TL_3X3_GRID, TileIndexDiffC::x, Town::xy, and TileIndexDiffC::y.

Referenced by BuildTownHouse(), and CheckTownBuild2House().

static bool TryClearTile ( TileIndex  tile  )  [static]

Check whether the land can be cleared.

Parameters:
tile Tile to check.
Returns:
The tile can be cleared.

Definition at line 2718 of file town_cmd.cpp.

References _current_company, CMD_LANDSCAPE_CLEAR, DC_NONE, DoCommand(), OWNER_NONE, Backup< T >::Restore(), and CommandCost::Succeeded().

Referenced by SearchTileForStatue().

void UpdateAllTownVirtCoords (  ) 

Update the virtual coords needed to draw the town sign for all towns.

Definition at line 366 of file town_cmd.cpp.

References Town::UpdateVirtCoord().

Referenced by UpdateAllVirtCoords().

void UpdateTownCargoBitmap (  ) 

Updates the bitmap of all cargoes accepted by houses.

Definition at line 747 of file town_cmd.cpp.

References _town_cargoes_accepted, and Town::cargo_accepted_total.

Referenced by RebuildTownCaches().

void UpdateTownCargoes ( Town t  ) 

Update cargo acceptance for the complete town.

Parameters:
t The town to update.

Definition at line 728 of file town_cmd.cpp.

References Town::cargo_accepted, Town::cargo_produced, TileMatrix< T, N >::GetArea(), INVALID_TILE, TileArea::tile, TILE_AREA_LOOP, TileX(), TileY(), UpdateTownCargoes(), and UpdateTownCargoTotal().

Referenced by AfterLoadGame(), BuildTownHouse(), RebuildTownCaches(), and UpdateTownCargoes().

static void UpdateTownCargoes ( Town t,
TileIndex  start,
bool  update_total = true 
) [static]

Update accepted town cargoes around a specific tile.

Parameters:
t The town to update.
start Update the values around this tile.
update_total Set to true if the total cargo acceptance should be updated.

Definition at line 698 of file town_cmd.cpp.

References Town::cargo_accepted, Town::cargo_produced, TileMatrix< uint32, 4 >::GetAreaForTile(), GetTownIndex(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem< Tpool >::index, IsTileType(), MP_HOUSE, SetBit(), TILE_AREA_LOOP, and UpdateTownCargoTotal().

void UpdateTownCargoTotal ( Town t  ) 

Update the total cargo acceptance of the whole town.

Parameters:
t The town to update.

Definition at line 680 of file town_cmd.cpp.

References Town::cargo_accepted, Town::cargo_accepted_total, TileMatrix< T, N >::GetArea(), TILE_AREA_LOOP, TileX(), and TileY().

Referenced by UpdateTownCargoes().

static void UpdateTownGrowRate ( Town t  )  [static]

Variable Documentation

Initial value:
 {
  DrawTile_Town,           
  GetSlopePixelZ_Town,     
  ClearTile_Town,          
  AddAcceptedCargo_Town,   
  GetTileDesc_Town,        
  GetTileTrackStatus_Town, 
  NULL,                    
  AnimateTile_Town,        
  TileLoop_Town,           
  ChangeTileOwner_Town,    
  AddProducedCargo_Town,   
  NULL,                    
  GetFoundation_Town,      
  TerraformTile_Town,      
}

Tile callback functions for a town.

const byte _town_action_costs[TACT_COUNT]
Initial value:
 {
  2, 4, 9, 35, 48, 53, 117, 175
}

Factor in the cost of each town action.

See also:
TownActions

Definition at line 2662 of file town_cmd.cpp.

Referenced by TownAuthorityWindow::DrawWidget(), and TownAuthorityWindow::UpdateWidgetSize().

TownActionProc* const _town_action_proc[] [static]
Initial value:
 {
  TownActionAdvertiseSmall,
  TownActionAdvertiseMedium,
  TownActionAdvertiseLarge,
  TownActionRoadRebuild,
  TownActionBuildStatue,
  TownActionFundBuildings,
  TownActionBuyRights,
  TownActionBribe
}

Definition at line 2882 of file town_cmd.cpp.

TownDrawTileProc* const _town_draw_tile_procs[1] [static]
Initial value:
 {
  TownDrawHouseLift
}

Definition at line 191 of file town_cmd.cpp.