Handling of object NewGRFs. More...

#include "stdafx.h"
#include "company_base.h"
#include "company_func.h"
#include "debug.h"
#include "genworld.h"
#include "newgrf_badge.h"
#include "newgrf_object.h"
#include "newgrf_sound.h"
#include "object_base.h"
#include "object_map.h"
#include "timer/timer_game_calendar.h"
#include "tile_cmd.h"
#include "town.h"
#include "water.h"
#include "newgrf_animation_base.h"
#include "table/strings.h"
#include "newgrf_class_func.h"
#include "safeguards.h"

Data Structures
struct	ObjectAnimationBase
	Helper class for animation control. More...

Functions
void	ResetObjects ()
	This function initialize the spec arrays of objects.
static uint32_t	GetObjectIDAtOffset (TileIndex tile, uint32_t cur_grfid)
	Make an analysis of a tile and get the object type.
static uint32_t	GetNearbyObjectTileInformation (uint8_t parameter, TileIndex tile, ObjectID index, bool grf_version8)
	Based on newhouses equivalent, but adapted for newobjects.
static uint32_t	GetClosestObject (TileIndex tile, ObjectType type, const Object *current)
	Get the closest object of a given type.
static uint32_t	GetCountAndDistanceOfClosestInstance (const ResolverObject &object, uint8_t local_id, uint32_t grfid, TileIndex tile, const Object *current)
	Implementation of var 65.
uint16_t	GetObjectCallback (CallbackID callback, uint32_t param1, uint32_t param2, const ObjectSpec spec, Object o, TileIndex tile, std::span< int32_t > regs100, uint8_t view)
	Perform a callback for an object.
static void	DrawTileLayout (const TileInfo ti, const DrawTileSpriteSpan &dts, const ObjectSpec spec)
	Draw an group of sprites on the map.
void	DrawNewObjectTile (TileInfo ti, const ObjectSpec spec)
	Draw an object on the map.
void	DrawNewObjectTileInGUI (int x, int y, const ObjectSpec *spec, uint8_t view)
	Draw representation of an object (tile) for GUI purposes.
uint16_t	StubGetObjectCallback (CallbackID callback, uint32_t param1, uint32_t param2, const ObjectSpec spec, Object o, TileIndex tile, int)
	Perform a callback for an object.
void	AnimateNewObjectTile (TileIndex tile)
	Handle the animation of the object tile.
static bool	DoTriggerObjectTileAnimation (Object o, TileIndex tile, ObjectAnimationTrigger trigger, const ObjectSpec spec, uint32_t random, uint32_t var18_extra=0)
bool	TriggerObjectTileAnimation (Object o, TileIndex tile, ObjectAnimationTrigger trigger, const ObjectSpec spec)
	Trigger the update of animation on a single tile.
bool	TriggerObjectAnimation (Object o, ObjectAnimationTrigger trigger, const ObjectSpec spec)
	Trigger the update of animation on a whole object.

Variables
ObjectOverrideManager	_object_mngr (NEW_OBJECT_OFFSET, NUM_OBJECTS, INVALID_OBJECT_TYPE)
	The override manager for our objects.
const ObjectSpec	_original_objects [NEW_OBJECT_OFFSET]
std::vector< ObjectSpec >	_object_specs
	All the object specifications.

Detailed Description

Handling of object NewGRFs.

Definition in file newgrf_object.cpp.

Function Documentation

◆ AnimateNewObjectTile()

void AnimateNewObjectTile ( TileIndex tile )

Handle the animation of the object tile.

Parameters

tile	The tile to animate.

Definition at line 554 of file newgrf_object.cpp.

References AnimationBase< ObjectAnimationBase, ObjectSpec, Object, int, StubGetObjectCallback, TileAnimationFrameAnimationHelper< Object > >::AnimateTile(), Animation, AnimRandomBits, ObjectSpec::flags, Object::GetByTile(), ObjectSpec::GetByTile(), and BaseBitSet< Timpl, Tvalue_type, Tstorage, Tmask >::Test().

◆ DoTriggerObjectTileAnimation()

bool DoTriggerObjectTileAnimation	(	Object *	o,
		TileIndex	tile,
		ObjectAnimationTrigger	trigger,
		const ObjectSpec *	spec,
		uint32_t	random,
		uint32_t	var18_extra = 0 )

static

Definition at line 562 of file newgrf_object.cpp.

◆ DrawNewObjectTile()

void DrawNewObjectTile	(	TileInfo *	ti,
		const ObjectSpec *	spec )

Draw an object on the map.

Parameters

ti	Information about the tile to draw on.
spec	Object spec to draw.

Definition at line 473 of file newgrf_object.cpp.

References DrawTileLayout(), Object::GetByTile(), SpriteLayoutProcessor::GetLayout(), TileLayoutSpriteGroup::ProcessRegisters(), and TileInfo::tile.

◆ DrawNewObjectTileInGUI()

void DrawNewObjectTileInGUI	(	int	x,
		int	y,
		const ObjectSpec *	spec,
		uint8_t	view )

Draw representation of an object (tile) for GUI purposes.

Parameters

x	Position x of image.
y	Position y of image.
spec	Object spec to draw.
view	The object's view.

Definition at line 493 of file newgrf_object.cpp.

References _local_company, Livery::colour1, Livery::colour2, DrawNewGRFTileSeqInGUI(), DrawSprite(), ObjectSpec::flags, GB(), GetCompanyPalette(), SpriteLayoutProcessor::GetLayout(), GroundSpritePaletteTransform(), INVALID_TILE, PALETTE_RECOLOUR_START, TileLayoutSpriteGroup::ProcessRegisters(), SPRITE_WIDTH, BaseBitSet< Timpl, Tvalue_type, Tstorage, Tmask >::Test(), and Uses2CC.

Referenced by ObjectPickerCallbacks::DrawType(), and BuildObjectWindow::DrawWidget().

◆ DrawTileLayout()

void DrawTileLayout	(	const TileInfo *	ti,
		const DrawTileSpriteSpan &	dts,
		const ObjectSpec *	spec )

static

Draw an group of sprites on the map.

Parameters

ti	Information about the tile to draw on.
dts	The sprite layout to draw.
spec	Object spec to draw.

Definition at line 448 of file newgrf_object.cpp.

References Object::colour, DrawGroundSprite(), DrawNewGRFTileSeq(), DrawWater, ObjectSpec::flags, GB(), Object::GetByTile(), DrawTileSprites::ground, GroundSpritePaletteTransform(), IsTileOnWater(), PalSpriteID::pal, PALETTE_RECOLOUR_START, PalSpriteID::sprite, SPRITE_WIDTH, BaseBitSet< Timpl, Tvalue_type, Tstorage, Tmask >::Test(), TileInfo::tile, TO_STRUCTURES, and Uses2CC.

Referenced by DrawNewObjectTile().

◆ GetClosestObject()

uint32_t GetClosestObject	(	TileIndex	tile,
		ObjectType	type,
		const Object *	current )

static

Get the closest object of a given type.

Parameters

tile	The tile to start searching from.
type	The type of the object to search for.
current	The current object (to ignore).

Returns: The distance to the closest object.

Definition at line 214 of file newgrf_object.cpp.

References DistanceManhattan().

Referenced by GetCountAndDistanceOfClosestInstance().

◆ GetCountAndDistanceOfClosestInstance()

uint32_t GetCountAndDistanceOfClosestInstance	(	const ResolverObject &	object,
		uint8_t	local_id,
		uint32_t	grfid,
		TileIndex	tile,
		const Object *	current )

static

Implementation of var 65.

Parameters

object	ResolverObject owning the temporary storage.
local_id	Parameter given to the callback, which is the set id, or the local id, in our terminology.
grfid	The object's GRFID.
tile	The tile to look from.
current	Object for which the inquiry is made

Returns: The formatted answer to the callback : rr(reserved) cc(count) dddd(manhattan distance of closest sister)

Definition at line 235 of file newgrf_object.cpp.

References ClampTo(), GetClosestObject(), Object::GetTypeCount(), and NUM_OBJECTS.

◆ GetNearbyObjectTileInformation()

uint32_t GetNearbyObjectTileInformation	(	uint8_t	parameter,
		TileIndex	tile,
		ObjectID	index,
		bool	grf_version8 )

static

Based on newhouses equivalent, but adapted for newobjects.

Parameters

parameter	from callback. It's in fact a pair of coordinates
tile	TileIndex from which the callback was initiated
index	of the object been queried for
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 199 of file newgrf_object.cpp.

References GetNearbyTile(), GetNearbyTileInformation(), GetObjectIndex(), IsTileType(), and Object.

Referenced by ObjectScopeResolver::GetVariable().

◆ GetObjectCallback()

uint16_t GetObjectCallback	(	CallbackID	callback,
		uint32_t	param1,
		uint32_t	param2,
		const ObjectSpec *	spec,
		Object *	o,
		TileIndex	tile,
		std::span< int32_t >	regs100,
		uint8_t	view )

Perform a callback for an object.

Parameters

	callback	The callback to perform.
	param1	The first parameter to pass to the NewGRF.
	param2	The second parameter to pass to the NewGRF.
	spec	The specification of the object / the entry point.
	o	The object to call the callback for.
	tile	The tile the callback is called for.
	view	The view of the object (only used when o == nullptr).
[out]	regs100	Additional result values from registers 100+

Returns: The result of the callback.

Definition at line 436 of file newgrf_object.cpp.

Referenced by BuildObject(), CmdBuildObject(), BuildObjectWindow::DrawWidget(), and StubGetObjectCallback().

◆ GetObjectIDAtOffset()

uint32_t GetObjectIDAtOffset	(	TileIndex	tile,
		uint32_t	cur_grfid )

static

Make an analysis of a tile and get the object type.

Parameters

tile	TileIndex of the tile to query
cur_grfid	GRFID of the current callback chain

Returns: value encoded as per NFO specs

Definition at line 170 of file newgrf_object.cpp.

References ObjectSpec::Get(), Object::GetByTile(), ObjectSpec::grf_prop, GRFFilePropsBase::grfid, GRFFilePropsBase::HasGrfFile(), IsTileType(), GRFFilePropsBase::local_id, Object, Object::type, and Object::view.

Referenced by ObjectScopeResolver::GetVariable().

◆ ResetObjects()

void ResetObjects ( )

This function initialize the spec arrays of objects.

Definition at line 125 of file newgrf_object.cpp.

References _object_specs, NewGRFClass< ObjectSpec, ObjectClassID, OBJECT_CLASS_MAX >::Allocate(), ObjectSpec::grf_prop, lengthof, GRFFilePropsBase::local_id, OBJECT_LIGHTHOUSE, and OBJECT_TRANSMITTER.

Referenced by ResetNewGRFData().

◆ StubGetObjectCallback()

uint16_t StubGetObjectCallback	(	CallbackID	callback,
		uint32_t	param1,
		uint32_t	param2,
		const ObjectSpec *	spec,
		Object *	o,
		TileIndex	tile,
		int	)

Perform a callback for an object.

Parameters

callback	The callback to perform.
param1	The first parameter to pass to the NewGRF.
param2	The second parameter to pass to the NewGRF.
spec	The specification of the object / the entry point.
o	The object to call the callback for.
tile	The tile the callback is called for.

Returns: The result of the callback.

Definition at line 536 of file newgrf_object.cpp.

References GetObjectCallback().

◆ TriggerObjectAnimation()

bool TriggerObjectAnimation	(	Object *	o,
		ObjectAnimationTrigger	trigger,
		const ObjectSpec *	spec )

Trigger the update of animation on a whole object.

Parameters

o	The object that got triggered.
trigger	The trigger that is triggered.
spec	The spec associated with the object.

Definition at line 588 of file newgrf_object.cpp.

References ObjectSpec::animation, Object::location, and SB().

Referenced by BuildObject().

◆ TriggerObjectTileAnimation()

bool TriggerObjectTileAnimation	(	Object *	o,
		TileIndex	tile,
		ObjectAnimationTrigger	trigger,
		const ObjectSpec *	spec )

Trigger the update of animation on a single tile.

Parameters

o	The object that got triggered.
tile	The location of the triggered tile.
trigger	The trigger that is triggered.
spec	The spec associated with the object.

Definition at line 577 of file newgrf_object.cpp.

Variable Documentation

◆ _object_specs

std::vector<ObjectSpec> _object_specs

All the object specifications.

Definition at line 37 of file newgrf_object.cpp.

Referenced by ObjectSpec::BindToClasses(), ObjectSpec::Get(), ObjectSpec::Index(), ResetObjects(), and ObjectOverrideManager::SetEntitySpec().

Data Structures

Functions

Variables

Detailed Description

Function Documentation

◆ AnimateNewObjectTile()

◆ DoTriggerObjectTileAnimation()

◆ DrawNewObjectTile()

◆ DrawNewObjectTileInGUI()

◆ DrawTileLayout()

◆ GetClosestObject()

◆ GetCountAndDistanceOfClosestInstance()

◆ GetNearbyObjectTileInformation()

◆ GetObjectCallback()

◆ GetObjectIDAtOffset()

◆ ResetObjects()

◆ StubGetObjectCallback()

◆ TriggerObjectAnimation()

◆ TriggerObjectTileAnimation()

Variable Documentation

◆ _object_specs