OpenTTD Source 20250505-master-ga46b885640
Public Member Functions | Data Fields | Protected Attributes
ResolverObject Struct Reference

Interface for SpriteGroup-s to access the gamestate. More...

#include <newgrf_spritegroup.h>

Inheritance diagram for ResolverObject:
SpecializedResolverObject< HouseRandomTriggers > SpecializedResolverObject< IndustryRandomTriggers > SpecializedResolverObject< StationRandomTriggers > SpecializedResolverObject< VehicleRandomTriggers > AirportResolverObject AirportTileResolverObject BadgeResolverObject CanalResolverObject CargoResolverObject GenericResolverObject IndustriesResolverObject ObjectResolverObject RailTypeResolverObject RoadTypeResolverObject SpecializedResolverObject< RandomTriggers > TownResolverObject

Public Member Functions

 ResolverObject (const GRFFile *grffile, CallbackID callback=CBID_NO_CALLBACK, uint32_t callback_param1=0, uint32_t callback_param2=0)
 Resolver constructor.
 
ResolverResult DoResolve ()
 
template<class TSpriteGroup >
const TSpriteGroup * Resolve ()
 Resolve SpriteGroup.
 
void ResolveRerandomisation ()
 Resolve bits to be rerandomised.
 
CallbackResult ResolveCallback ()
 Resolve callback.
 
virtual ResolverResult ResolveReal (const RealSpriteGroup &group) const
 Get the real sprites of the grf.
 
virtual ScopeResolver * GetScope (VarSpriteGroupScope scope=VSG_SCOPE_SELF, uint8_t relative=0)
 Get a resolver for the scope.
 
uint32_t GetWaitingRandomTriggers () const
 Used by RandomizedSpriteGroup: Triggers for rerandomisation.
 
void AddUsedRandomTriggers (uint32_t triggers)
 Used by RandomizedSpriteGroup: Consume triggers.
 
uint32_t GetReseedSum () const
 Returns the OR-sum of all bits that need reseeding independent of the scope they were accessed with.
 
void ResetState ()
 Resets the dynamic state of the resolver object.
 
virtual GrfSpecFeature GetFeature () const
 Get the feature number being resolved for.
 
virtual uint32_t GetDebugID () const
 Get an identifier for the item being resolved.
 

Data Fields

ScopeResolver default_scope
 Default implementation of the grf scope.
 
CallbackID callback {}
 Callback being resolved.
 
uint32_t callback_param1 = 0
 First parameter (var 10) of the callback.
 
uint32_t callback_param2 = 0
 Second parameter (var 18) of the callback.
 
uint32_t last_value = 0
 Result of most recent DeterministicSpriteGroup (including procedure calls)
 
std::array< uint32_t, VSG_END > reseed
 Collects bits to rerandomise while triggering triggers.
 
const GRFFile * grffile = nullptr
 GRFFile the resolved SpriteGroup belongs to.
 
const SpriteGroup * root_spritegroup = nullptr
 Root SpriteGroup to use for resolving.
 

Protected Attributes

uint32_t waiting_random_triggers = 0
 Waiting triggers to be used by any rerandomisation. (scope independent)
 
uint32_t used_random_triggers = 0
 Subset of cur_triggers, which actually triggered some rerandomisation. (scope independent)
 

Detailed Description

Interface for SpriteGroup-s to access the gamestate.

Using this interface SpriteGroup-chains (action 1-2-3 chains) can be resolved, to get the results of callbacks, rerandomisations or normal sprite lookups.

Definition at line 307 of file newgrf_spritegroup.h.

Constructor & Destructor Documentation

◆ ResolverObject()

ResolverObject::ResolverObject ( const GRFFile *  grffile,
CallbackID  callback = CBID_NO_CALLBACK,
uint32_t  callback_param1 = 0,
uint32_t  callback_param2 = 0 
)
inline

Resolver constructor.

Parameters
grffileNewGRF file associated with the object (or nullptr if none).
callbackCallback code being resolved (default value is CBID_NO_CALLBACK).
callback_param1First parameter (var 10) of the callback (only used when callback is also set).
callback_param2Second parameter (var 18) of the callback (only used when callback is also set).

Definition at line 315 of file newgrf_spritegroup.h.

References ResetState().

Member Function Documentation

◆ AddUsedRandomTriggers()

void ResolverObject::AddUsedRandomTriggers ( uint32_t  triggers)
inline

Used by RandomizedSpriteGroup: Consume triggers.

Definition at line 399 of file newgrf_spritegroup.h.

◆ DoResolve()

ResolverResult ResolverObject::DoResolve ( )
inline

Definition at line 323 of file newgrf_spritegroup.h.

◆ GetDebugID()

virtual uint32_t ResolverObject::GetDebugID ( ) const
inlinevirtual

Get an identifier for the item being resolved.

This function is mainly intended for the callback profiling feature, and should return an identifier recognisable by the NewGRF developer.

Reimplemented in AirportResolverObject, AirportTileResolverObject, BadgeResolverObject, CanalResolverObject, CargoResolverObject, VehicleResolverObject, GenericResolverObject, HouseResolverObject, IndustriesResolverObject, IndustryTileResolverObject, ObjectResolverObject, RailTypeResolverObject, RoadTypeResolverObject, and StationResolverObject.

Definition at line 440 of file newgrf_spritegroup.h.

Referenced by NewGRFProfiler::BeginResolve().

◆ GetFeature()

virtual GrfSpecFeature ResolverObject::GetFeature ( ) const
inlinevirtual

Get the feature number being resolved for.

This function is mainly intended for the callback profiling feature.

Reimplemented in AirportResolverObject, AirportTileResolverObject, BadgeResolverObject, CanalResolverObject, CargoResolverObject, VehicleResolverObject, GenericResolverObject, HouseResolverObject, IndustriesResolverObject, IndustryTileResolverObject, ObjectResolverObject, RailTypeResolverObject, RoadTypeResolverObject, and StationResolverObject.

Definition at line 434 of file newgrf_spritegroup.h.

References GSF_INVALID.

Referenced by NewGRFProfiler::BeginResolve().

◆ GetReseedSum()

uint32_t ResolverObject::GetReseedSum ( ) const
inline

Returns the OR-sum of all bits that need reseeding independent of the scope they were accessed with.

Returns
OR-sum of the bits.

Definition at line 409 of file newgrf_spritegroup.h.

◆ GetScope()

ScopeResolver * ResolverObject::GetScope ( VarSpriteGroupScope  scope = VSG_SCOPE_SELF,
uint8_t  relative = 0 
)
virtual

Get a resolver for the scope.

Returns
The resolver for the requested scope.

Reimplemented in AirportResolverObject, AirportTileResolverObject, BadgeResolverObject, CanalResolverObject, VehicleResolverObject, GenericResolverObject, HouseResolverObject, IndustriesResolverObject, IndustryTileResolverObject, ObjectResolverObject, RailTypeResolverObject, RoadStopResolverObject, RoadTypeResolverObject, StationResolverObject, and TownResolverObject.

Definition at line 135 of file newgrf_spritegroup.cpp.

References default_scope.

Referenced by AirportResolverObject::GetScope(), AirportTileResolverObject::GetScope(), BadgeResolverObject::GetScope(), CanalResolverObject::GetScope(), VehicleResolverObject::GetScope(), GenericResolverObject::GetScope(), HouseResolverObject::GetScope(), IndustriesResolverObject::GetScope(), IndustryTileResolverObject::GetScope(), ObjectResolverObject::GetScope(), RailTypeResolverObject::GetScope(), RoadStopResolverObject::GetScope(), RoadTypeResolverObject::GetScope(), StationResolverObject::GetScope(), and TownResolverObject::GetScope().

◆ GetWaitingRandomTriggers()

uint32_t ResolverObject::GetWaitingRandomTriggers ( ) const
inline

Used by RandomizedSpriteGroup: Triggers for rerandomisation.

Definition at line 391 of file newgrf_spritegroup.h.

References waiting_random_triggers.

◆ ResetState()

void ResolverObject::ResetState ( )
inline

Resets the dynamic state of the resolver object.

To be called before resolving an Action-1-2-3 chain.

Definition at line 422 of file newgrf_spritegroup.h.

Referenced by ResolverObject().

◆ Resolve()

template<class TSpriteGroup >
const TSpriteGroup * ResolverObject::Resolve ( )
inline

Resolve SpriteGroup.

Returns
Result spritegroup.
Template Parameters
TSpriteGroupSprite group type

Definition at line 351 of file newgrf_spritegroup.h.

◆ ResolveCallback()

CallbackResult ResolverObject::ResolveCallback ( )
inline

Resolve callback.

Returns
Callback result.

Definition at line 377 of file newgrf_spritegroup.h.

References CALLBACK_FAILED.

◆ ResolveReal()

ResolverResult ResolverObject::ResolveReal ( const RealSpriteGroup &  group) const
virtual

Get the real sprites of the grf.

Parameters
groupGroup to get.
Returns
The available sprite group.

Reimplemented in VehicleResolverObject, and StationResolverObject.

Definition at line 123 of file newgrf_spritegroup.cpp.

References RealSpriteGroup::loaded, and RealSpriteGroup::loading.

◆ ResolveRerandomisation()

void ResolverObject::ResolveRerandomisation ( )
inline

Resolve bits to be rerandomised.

Access results via:

  • reseed: Bits to rerandomise per scope, for features with proper PARENT rerandomisation. (only industry tiles)
  • GetReseedSum: Bits to rerandomise for SELF scope, for features with broken-by-design PARENT randomisation. (all but industry tiles)
  • GetUsedRandomTriggers: Consumed random triggers to be reset.

Definition at line 366 of file newgrf_spritegroup.h.

Field Documentation

◆ callback

CallbackID ResolverObject::callback {}

Callback being resolved.

Definition at line 330 of file newgrf_spritegroup.h.

Referenced by NewGRFProfiler::BeginResolve(), and IndustriesScopeResolver::GetVariable().

◆ callback_param1

uint32_t ResolverObject::callback_param1 = 0

First parameter (var 10) of the callback.

Definition at line 331 of file newgrf_spritegroup.h.

◆ callback_param2

uint32_t ResolverObject::callback_param2 = 0

Second parameter (var 18) of the callback.

Definition at line 332 of file newgrf_spritegroup.h.

◆ default_scope

ScopeResolver ResolverObject::default_scope

Default implementation of the grf scope.

Definition at line 328 of file newgrf_spritegroup.h.

Referenced by GetScope().

◆ grffile

const GRFFile* ResolverObject::grffile = nullptr

GRFFile the resolved SpriteGroup belongs to.

Definition at line 342 of file newgrf_spritegroup.h.

Referenced by AirportScopeResolver::GetVariable(), AirportTileScopeResolver::GetVariable(), VehicleScopeResolver::GetVariable(), GenericScopeResolver::GetVariable(), HouseScopeResolver::GetVariable(), IndustriesScopeResolver::GetVariable(), IndustryTileScopeResolver::GetVariable(), ObjectScopeResolver::GetVariable(), RailTypeScopeResolver::GetVariable(), RoadStopScopeResolver::GetVariable(), RoadTypeScopeResolver::GetVariable(), StationScopeResolver::GetVariable(), TownScopeResolver::GetVariable(), AirportScopeResolver::StorePSA(), and TownScopeResolver::StorePSA().

◆ last_value

uint32_t ResolverObject::last_value = 0

Result of most recent DeterministicSpriteGroup (including procedure calls)

Definition at line 334 of file newgrf_spritegroup.h.

◆ reseed

std::array<uint32_t, VSG_END> ResolverObject::reseed

Collects bits to rerandomise while triggering triggers.

Definition at line 340 of file newgrf_spritegroup.h.

◆ root_spritegroup

const SpriteGroup* ResolverObject::root_spritegroup = nullptr

Root SpriteGroup to use for resolving.

Definition at line 343 of file newgrf_spritegroup.h.

Referenced by AirportResolverObject::AirportResolverObject(), AirportTileResolverObject::AirportTileResolverObject(), BadgeResolverObject::BadgeResolverObject(), NewGRFProfiler::BeginResolve(), CanalResolverObject::CanalResolverObject(), CargoResolverObject::CargoResolverObject(), HouseResolverObject::HouseResolverObject(), IndustriesResolverObject::IndustriesResolverObject(), IndustryTileResolverObject::IndustryTileResolverObject(), ObjectResolverObject::ObjectResolverObject(), RailTypeResolverObject::RailTypeResolverObject(), RoadTypeResolverObject::RoadTypeResolverObject(), StationResolverObject::StationResolverObject(), and VehicleResolverObject::VehicleResolverObject().

◆ used_random_triggers

uint32_t ResolverObject::used_random_triggers = 0
protected

Subset of cur_triggers, which actually triggered some rerandomisation. (scope independent)

Definition at line 338 of file newgrf_spritegroup.h.

Referenced by SpecializedResolverObject< RandomTriggers >::GetUsedRandomTriggers().

◆ waiting_random_triggers

uint32_t ResolverObject::waiting_random_triggers = 0
protected

Waiting triggers to be used by any rerandomisation. (scope independent)

Definition at line 337 of file newgrf_spritegroup.h.

Referenced by GetWaitingRandomTriggers(), and SpecializedResolverObject< RandomTriggers >::SetWaitingRandomTriggers().

The documentation for this struct was generated from the following files: