Data Structures | Functions | Variables

newgrf_house.cpp File Reference

Implementation of NewGRF houses. More...

#include "stdafx.h"
#include "debug.h"
#include "landscape.h"
#include "newgrf_house.h"
#include "newgrf_spritegroup.h"
#include "newgrf_town.h"
#include "newgrf_sound.h"
#include "company_func.h"
#include "company_base.h"
#include "town.h"
#include "genworld.h"
#include "newgrf_animation_base.h"
#include "newgrf_cargo.h"
#include "station_base.h"

Go to the source code of this file.

Data Structures

struct  SearchNearbyHouseData
 Structure with user-data for SearchNearbyHouseXXX - functions. More...
struct  HouseAnimationBase
 Helper class for animation control. More...

Functions

static const GRFFileGetHouseSpecGrf (HouseID house_id)
 Retrieve the grf file associated with a house.
HouseClassID AllocateHouseClassID (byte grf_class_id, uint32 grfid)
void InitializeBuildingCounts ()
void IncreaseBuildingCount (Town *t, HouseID house_id)
 IncreaseBuildingCount() Increase the count of a building when it has been added by a town.
void DecreaseBuildingCount (Town *t, HouseID house_id)
 DecreaseBuildingCount() Decrease the number of a building when it is deleted.
static uint32 GetNumHouses (HouseID house_id, const Town *town)
static uint32 GetNearbyTileInformation (byte parameter, TileIndex tile, bool grf_version8)
 Get information about a nearby tile.
static bool SearchNearbyHouseID (TileIndex tile, void *user_data)
 Callback function to search a house by its HouseID.
static bool SearchNearbyHouseClass (TileIndex tile, void *user_data)
 Callback function to search a house by its classID.
static bool SearchNearbyHouseGRFID (TileIndex tile, void *user_data)
 Callback function to search a house by its grfID.
static uint32 GetDistanceFromNearbyHouse (uint8 parameter, TileIndex tile, HouseID house)
 This function will activate a search around a central tile, looking for some houses that fit the requested characteristics.
uint16 GetHouseCallback (CallbackID callback, uint32 param1, uint32 param2, HouseID house_id, Town *town, TileIndex tile, bool not_yet_constructed, uint8 initial_random_bits, uint32 watched_cargo_triggers)
static void DrawTileLayout (const TileInfo *ti, const TileLayoutSpriteGroup *group, byte stage, HouseID house_id)
void DrawNewHouseTile (TileInfo *ti, HouseID house_id)
uint16 GetSimpleHouseCallback (CallbackID callback, uint32 param1, uint32 param2, const HouseSpec *spec, Town *town, TileIndex tile, uint32 extra_data)
void AnimateNewHouseTile (TileIndex tile)
void AnimateNewHouseConstruction (TileIndex tile)
bool CanDeleteHouse (TileIndex tile)
static void AnimationControl (TileIndex tile, uint16 random_bits)
bool NewHouseTileLoop (TileIndex tile)
static void DoTriggerHouse (TileIndex tile, HouseTrigger trigger, byte base_random, bool first)
void TriggerHouse (TileIndex t, HouseTrigger trigger)
void DoWatchedCargoCallback (TileIndex tile, TileIndex origin, uint32 trigger_cargoes, uint16 random)
 Run the watched cargo accepted callback for a single house tile.
void WatchedCargoCallback (TileIndex tile, uint32 trigger_cargoes)
 Run watched cargo accepted callback for a house.

Variables

static BuildingCounts< uint32 > _building_counts
static HouseClassMapping _class_mapping [HOUSE_CLASS_MAX]
HouseOverrideManager _house_mngr (NEW_HOUSE_OFFSET, NUM_HOUSES, INVALID_HOUSE_ID)

Detailed Description

Implementation of NewGRF houses.

Definition in file newgrf_house.cpp.


Function Documentation

void DecreaseBuildingCount ( Town t,
HouseID  house_id 
)

DecreaseBuildingCount() Decrease the number of a building when it is deleted.

Parameters:
t The town that the building was built in
house_id The id of the house being removed

Definition at line 141 of file newgrf_house.cpp.

References _loaded_newgrf_features, TownCache::building_counts, Town::cache, HouseSpec::class_id, and GRFLoadedFeatures::has_newhouses.

Referenced by DoClearTownHouseHelper().

void DoWatchedCargoCallback ( TileIndex  tile,
TileIndex  origin,
uint32  trigger_cargoes,
uint16  random 
)

Run the watched cargo accepted callback for a single house tile.

Parameters:
tile The house tile.
origin The triggering tile.
trigger_cargoes Cargo types that triggered the callback.
random Random bits.

Definition at line 656 of file newgrf_house.cpp.

References CBID_HOUSE_WATCHED_CARGO_ACCEPTED, AnimationBase< HouseAnimationBase, HouseSpec, Town, uint32, GetSimpleHouseCallback >::ChangeAnimationFrame(), GetHouseType(), TileIndexToTileIndexDiffC(), TileIndexDiffC::x, and TileIndexDiffC::y.

Referenced by WatchedCargoCallback().

static uint32 GetDistanceFromNearbyHouse ( uint8  parameter,
TileIndex  tile,
HouseID  house 
) [static]

This function will activate a search around a central tile, looking for some houses that fit the requested characteristics.

Parameters:
parameter that is given by the callback. bits 0..6 radius of the search bits 7..8 search type i.e.: 0 = houseID/ 1 = classID/ 2 = grfID
tile TileIndex from which to start the search
house the HouseID that is associated to the house, the callback is called for
Returns:
the Manhattan distance from the center tile, if any, and 0 if failure

Definition at line 289 of file newgrf_house.cpp.

References CircularTileSearch(), DistanceManhattan(), GB(), GetHouseNorthPart(), SearchNearbyHouseData::hs, lengthof, and SearchNearbyHouseData::north_tile.

Referenced by HouseScopeResolver::GetVariable().

static const GRFFile* GetHouseSpecGrf ( HouseID  house_id  )  [static]

Retrieve the grf file associated with a house.

Parameters:
house_id House to query.
Returns:
The associated GRF file (may be NULL).

Definition at line 59 of file newgrf_house.cpp.

References HouseSpec::grf_prop, and GRFFilePropsBase< Tcnt >::grffile.

static uint32 GetNearbyTileInformation ( byte  parameter,
TileIndex  tile,
bool  grf_version8 
) [static]

Get information about a nearby tile.

Parameters:
parameter from callback. It's in fact a pair of coordinates
tile TileIndex from which the callback was initiated
grf_version8 True, if we are dealing with a new NewGRF which uses GRF version >= 8.
Returns:
a construction of bits obeying the newgrf format

Definition at line 196 of file newgrf_house.cpp.

References GetNearbyTile(), and GetNearbyTileInformation().

void IncreaseBuildingCount ( Town t,
HouseID  house_id 
)

IncreaseBuildingCount() Increase the count of a building when it has been added by a town.

Parameters:
t The town that the building is being built in
house_id The id of the house being added

Definition at line 120 of file newgrf_house.cpp.

References _loaded_newgrf_features, TownCache::building_counts, Town::cache, HouseSpec::class_id, and GRFLoadedFeatures::has_newhouses.

Referenced by ClearMakeHouseTile(), and RebuildTownCaches().

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

Callback function to search a house by its classID.

Parameters:
tile TileIndex to be examined
user_data SearchNearbyHouseData
Returns:
true or false, if found or not

Definition at line 238 of file newgrf_house.cpp.

References HouseSpec::class_id, GetHouseNorthPart(), GetHouseType(), HouseSpec::grf_prop, GRFFilePropsBase< Tcnt >::grffile, SearchNearbyHouseData::hs, IsTileType(), MP_HOUSE, and SearchNearbyHouseData::north_tile.

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

Callback function to search a house by its grfID.

Parameters:
tile TileIndex to be examined
user_data SearchNearbyHouseData
Returns:
true or false, if found or not

Definition at line 262 of file newgrf_house.cpp.

References GetHouseNorthPart(), GetHouseType(), HouseSpec::grf_prop, GRFFilePropsBase< Tcnt >::grffile, SearchNearbyHouseData::hs, IsTileType(), MP_HOUSE, and SearchNearbyHouseData::north_tile.

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

Callback function to search a house by its HouseID.

Parameters:
tile TileIndex to be examined
user_data SearchNearbyHouseData
Returns:
true or false, if found or not

Definition at line 214 of file newgrf_house.cpp.

References GetHouseNorthPart(), GetHouseType(), HouseSpec::grf_prop, GRFFilePropsBase< Tcnt >::grffile, SearchNearbyHouseData::hs, IsTileType(), GRFFilePropsBase< Tcnt >::local_id, MP_HOUSE, and SearchNearbyHouseData::north_tile.

void WatchedCargoCallback ( TileIndex  tile,
uint32  trigger_cargoes 
)

Run watched cargo accepted callback for a house.

Parameters:
tile House tile.
trigger_cargoes Triggering cargo types.
Precondition:
IsTileType(t, MP_HOUSE)

Definition at line 669 of file newgrf_house.cpp.

References HouseSpec::building_flags, DoWatchedCargoCallback(), GetHouseNorthPart(), GetHouseType(), IsTileType(), MP_HOUSE, TILE_ADDXY, and HouseSpec::watched_cargoes.

Referenced by TriggerWatchedCargoCallbacks().