OpenTTD Source 20250312-master-gcdcc6b491d
newgrf_callbacks.h
Go to the documentation of this file.
1/*
2 * This file is part of OpenTTD.
3 * OpenTTD is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2.
4 * OpenTTD is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
5 * See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see <http://www.gnu.org/licenses/>.
6 */
7
10#ifndef NEWGRF_CALLBACKS_H
11#define NEWGRF_CALLBACKS_H
12
13#include "core/enum_type.hpp"
14
22enum CallbackID : uint16_t {
25
28
29 /* There are no callbacks 0x02 - 0x0F. */
30
32 CBID_VEHICLE_VISUAL_EFFECT = 0x10, // 8 bit callback
33
36
38 CBID_VEHICLE_LOAD_AMOUNT = 0x12, // 8 bit callback
39
41 CBID_STATION_AVAILABILITY = 0x13, // 8 bit callback
42
45
50 CBID_VEHICLE_REFIT_CAPACITY = 0x15, // 15 bit callback
51
53 CBID_VEHICLE_ARTIC_ENGINE = 0x16, // 8 bit callback for grf version < 8
54
56 CBID_HOUSE_ALLOW_CONSTRUCTION = 0x17, // 8 bit callback
57
59 CBID_GENERIC_AI_PURCHASE_SELECTION = 0x18, // 8 bit callback, implemented for stations only
60
63
65 CBID_HOUSE_ANIMATION_NEXT_FRAME = 0x1A, // 15 bit callback
66
68 CBID_HOUSE_ANIMATION_START_STOP = 0x1B, // 15 bit callback
69
71 CBID_HOUSE_CONSTRUCTION_STATE_CHANGE = 0x1C, // 15 bit callback
72
75
77 CBID_HOUSE_COLOUR = 0x1E, // 15 bit callback
78
80 CBID_HOUSE_CARGO_ACCEPTANCE = 0x1F, // 15 bit callback
81
83 CBID_HOUSE_ANIMATION_SPEED = 0x20, // 8 bit callback
84
86 CBID_HOUSE_DESTRUCTION = 0x21, // 8 bit callback
87
89 CBID_INDUSTRY_PROBABILITY = 0x22, // 15 bit callback
90
96
98 CBID_STATION_BUILD_TILE_LAYOUT = 0x24, // 15 bit callback
99
101 CBID_INDTILE_ANIM_START_STOP = 0x25, // 15 bit callback
102
104 CBID_INDTILE_ANIM_NEXT_FRAME = 0x26, // 15 bit callback
105
107 CBID_INDTILE_ANIMATION_SPEED = 0x27, // 8 bit callback
108
110 CBID_INDUSTRY_LOCATION = 0x28, // 15 bit callback
111
113 CBID_INDUSTRY_PRODUCTION_CHANGE = 0x29, // 15 bit callback
114
116 CBID_HOUSE_ACCEPT_CARGO = 0x2A, // 15 bit callback
117
119 CBID_INDTILE_CARGO_ACCEPTANCE = 0x2B, // 15 bit callback
120
122 CBID_INDTILE_ACCEPT_CARGO = 0x2C, // 15 bit callback
123
128 CBID_VEHICLE_COLOUR_MAPPING = 0x2D, // 15 bit callback
129
131 CBID_HOUSE_PRODUCE_CARGO = 0x2E, // 15 bit callback
132
134 CBID_INDTILE_SHAPE_CHECK = 0x2F, // 15 bit callback
135
137 CBID_INDTILE_DRAW_FOUNDATIONS = 0x30, // 15 bit callback
138
143 CBID_VEHICLE_START_STOP_CHECK = 0x31, // 15 bit callback, but 0xFF test is done with 8 bit
144
146 CBID_VEHICLE_32DAY_CALLBACK = 0x32, // 2 bit callback
147
149 CBID_VEHICLE_SOUND_EFFECT = 0x33, // 15 bit callback
150
152 CBID_VEHICLE_AUTOREPLACE_SELECTION = 0x34, // 15 bit callback, not implemented
153
155 CBID_INDUSTRY_MONTHLYPROD_CHANGE = 0x35, // 15 bit callback
156
161 CBID_VEHICLE_MODIFY_PROPERTY = 0x36, // 8/15 bit depends on queried property
162
164 CBID_INDUSTRY_CARGO_SUFFIX = 0x37, // 15 bit callback, but 0xFF test is done with 8 bit
165
167 CBID_INDUSTRY_FUND_MORE_TEXT = 0x38, // 15 bit callback
168
170 CBID_CARGO_PROFIT_CALC = 0x39, // 15 bit callback
171
173 CBID_INDUSTRY_WINDOW_MORE_TEXT = 0x3A, // 15 bit callback
174
176 CBID_INDUSTRY_SPECIAL_EFFECT = 0x3B, // 15 bit callback
177
179 CBID_INDTILE_AUTOSLOPE = 0x3C, // 15 bit callback
180
182 CBID_INDUSTRY_REFUSE_CARGO = 0x3D, // 15 bit callback
183
184 /* There are no callbacks 0x3E - 0x13F */
185
187 CBID_STATION_ANIM_START_STOP = 0x140, // 15 bit callback
188
190 CBID_STATION_ANIM_NEXT_FRAME = 0x141, // 15 bit callback
191
193 CBID_STATION_ANIMATION_SPEED = 0x142, // 8 bit callback
194
196 CBID_HOUSE_DENY_DESTRUCTION = 0x143, // 15 bit callback
197
199 CBID_SOUNDS_AMBIENT_EFFECT = 0x144, // 15 bit callback
200
202 CBID_CARGO_STATION_RATING_CALC = 0x145, // 15 bit callback
203
205 CBID_NEW_SIGNALS_SPRITE_DRAW = 0x146, // 15 bit callback, not implemented
206
208 CBID_CANALS_SPRITE_OFFSET = 0x147, // 15 bit callback
209
211 CBID_HOUSE_WATCHED_CARGO_ACCEPTED = 0x148, // 15 bit callback
212
214 CBID_STATION_LAND_SLOPE_CHECK = 0x149, // 15 bit callback
215
217 CBID_INDUSTRY_DECIDE_COLOUR = 0x14A, // 4 bit callback
218
220 CBID_INDUSTRY_INPUT_CARGO_TYPES = 0x14B, // 8 bit callback
221
223 CBID_INDUSTRY_OUTPUT_CARGO_TYPES = 0x14C, // 8 bit callback
224
226 CBID_HOUSE_CUSTOM_NAME = 0x14D, // 15 bit callback
227
229 CBID_HOUSE_DRAW_FOUNDATIONS = 0x14E, // 15 bit callback
230
232 CBID_HOUSE_AUTOSLOPE = 0x14F, // 15 bit callback
233
235 CBID_AIRPTILE_DRAW_FOUNDATIONS = 0x150, // 15 bit callback
236
238 CBID_AIRPTILE_ANIM_START_STOP = 0x152, // 15 bit callback
239
241 CBID_AIRPTILE_ANIM_NEXT_FRAME = 0x153, // 15 bit callback
242
244 CBID_AIRPTILE_ANIMATION_SPEED = 0x154, // 8 bit callback
245
250 CBID_AIRPORT_ADDITIONAL_TEXT = 0x155, // 15 bit callback
251
253 CBID_AIRPORT_LAYOUT_NAME = 0x156, // 15 bit callback
254
256 CBID_OBJECT_LAND_SLOPE_CHECK = 0x157, // 15 bit callback
257
259 CBID_OBJECT_ANIMATION_NEXT_FRAME = 0x158, // 15 bit callback
260
262 CBID_OBJECT_ANIMATION_START_STOP = 0x159, // 15 bit callback
263
265 CBID_OBJECT_ANIMATION_SPEED = 0x15A, // 8 bit callback
266
268 CBID_OBJECT_COLOUR = 0x15B, // 15 bit callback
269
271 CBID_OBJECT_FUND_MORE_TEXT = 0x15C, // 15 bit callback
272
274 CBID_OBJECT_AUTOSLOPE = 0x15D, // 15 bit callback
275
277 CBID_VEHICLE_REFIT_COST = 0x15E, // 15 bit callback
278
280 CBID_INDUSTRY_PROD_CHANGE_BUILD = 0x15F, // 15 bit callback
281
283 CBID_VEHICLE_SPAWN_VISUAL_EFFECT = 0x160, // 15 bit callback
284
286 CBID_VEHICLE_NAME = 0x161, // 15 bit callback
287
289 CBID_VEHICLE_BUILD_PROBABILITY = 0x162, // 15 bit callback
290
295 CBID_VEHICLE_CUSTOM_REFIT = 0x0163, // 15 bit callback
296};
297
302enum class VehicleCallbackMask : uint8_t {
303 VisualEffect = 0,
304 Length = 1,
305 LoadAmount = 2,
306 RefitCapacity = 3,
307 ArticEngine = 4,
308 CargoSuffix = 5,
309 ColourRemap = 6,
310 SoundEffect = 7,
311 Name = 8,
312 CustomRefit = 9,
313};
315
319enum class StationCallbackMask : uint8_t {
320 Avail = 0,
321 DrawTileLayout = 1,
323 AnimationSpeed = 3,
324 SlopeCheck = 4,
325};
327
331enum class RoadStopCallbackMask : uint8_t {
332 Avail = 0,
334 AnimationSpeed = 2,
335};
337
341enum class HouseCallbackMask : uint8_t {
346 Colour = 4,
347 CargoAcceptance = 5,
348 AnimationSpeed = 6,
349 Destruction = 7,
350 AcceptCargo = 8,
351 ProduceCargo = 9,
352 DenyDestruction = 10,
353 DrawFoundations = 11,
354 Autoslope = 12,
355};
357
361enum class CanalCallbackMask : uint8_t {
362 SpriteOffset = 0,
363};
365
369enum class CargoCallbackMask : uint8_t {
370 ProfitCalc = 0,
372};
374
378enum class IndustryCallbackMask : uint8_t {
379 Probability = 0,
382 Location = 3,
383 ProductionChange = 4,
385 CargoSuffix = 6,
386 FundMoreText = 7,
387 WindowMoreText = 8,
388 SpecialEffect = 9,
389 RefuseCargo = 10,
390 DecideColour = 11,
391 InputCargoTypes = 12,
392 OutputCargoTypes = 13,
393 ProdChangeBuild = 14,
394};
396
400enum class IndustryTileCallbackMask : uint8_t {
402 AnimationSpeed = 1,
403 CargoAcceptance = 2,
404 AcceptCargo = 3,
405 ShapeCheck = 4,
406 DrawFoundations = 5,
407 Autoslope = 6,
408};
410
414enum class ObjectCallbackMask : uint8_t {
415 SlopeCheck = 0,
417 AnimationSpeed = 2,
418 Colour = 3,
419 FundMoreText = 4,
420 Autoslope = 5,
421};
423
427enum class AirportTileCallbackMask : uint8_t {
429 AnimationSpeed = 1,
430 ShapeCheck = 4,
431 DrawFoundations = 5,
432 Autoslope = 6,
433};
435
439static const uint CALLBACK_FAILED = 0xFFFF;
440static const uint CALLBACK_HOUSEPRODCARGO_END = 0x20FF;
441
442#endif /* NEWGRF_CALLBACKS_H */
Type (helpers) for enums.
AirportTileCallbackMask
Callback masks for airport tiles.
StationCallbackMask
Callback masks for stations.
@ DrawTileLayout
Use callback to select a tile layout to use when drawing.
@ Avail
Availability of station in construction window.
@ AnimationNextFrame
Use a custom next frame callback.
@ AnimationSpeed
Customize the animation speed of the station.
@ SlopeCheck
Check slope of new station tiles.
VehicleCallbackMask
Callback masks for vehicles, indicates which callbacks are used by a vehicle.
@ SoundEffect
Vehicle uses custom sound effects.
@ Name
Engine name.
@ RefitCapacity
Cargo capacity after refit.
@ ArticEngine
Add articulated engines (trains and road vehicles)
@ Length
Vehicle length (trains and road vehicles)
@ ColourRemap
Change colour mapping of vehicle.
@ LoadAmount
Load amount.
@ CustomRefit
Custom refit mask.
CargoCallbackMask
Callback masks for cargoes.
@ StationRatingCalc
custom station rating for this cargo type
@ ProfitCalc
custom profit calculation
IndustryCallbackMask
Callback masks for Industries.
@ Probability
industry availability/probability callback
@ WindowMoreText
additional text in industry window
@ FundMoreText
additional text in fund window
@ InputCargoTypes
customize the cargoes the industry requires
@ ProductionChange
controls random production change
@ DecideColour
give a custom colour to newly build industries
@ SpecialEffect
control special effects
@ ProdChangeBuild
initialise production level on construction
@ Production256Ticks
call production callback every 256 ticks
@ Location
check industry construction on given area
@ MonthlyProdChange
controls monthly random production change
@ ProductionCargoArrival
call production callback when cargo arrives at the industry
@ RefuseCargo
option out of accepting cargo
@ OutputCargoTypes
customize the cargoes the industry produces
CallbackID
List of implemented NewGRF callbacks.
@ CBID_HOUSE_ANIMATION_START_STOP
Called for periodically starting or stopping the animation.
@ CBID_INDUSTRY_OUTPUT_CARGO_TYPES
Customize the output cargo types of a newly build industry.
@ CBID_VEHICLE_SOUND_EFFECT
Called to play a special sound effect.
@ CBID_VEHICLE_BUILD_PROBABILITY
Called to determine probability during build.
@ CBID_INDTILE_ANIMATION_SPEED
Called to indicate how long the current animation frame should last.
@ CBID_INDTILE_ANIM_START_STOP
Called for periodically starting or stopping the animation.
@ CBID_OBJECT_FUND_MORE_TEXT
Called to determine more text in the fund object window.
@ CBID_INDUSTRY_SPECIAL_EFFECT
Called to determine industry special effects.
@ CBID_INDTILE_ANIM_NEXT_FRAME
Called to determine industry tile next animation frame.
@ CBID_VEHICLE_SPAWN_VISUAL_EFFECT
Called to spawn visual effects for vehicles.
@ CBID_VEHICLE_REFIT_COST
Called to determine the cost factor for refitting a vehicle.
@ CBID_INDUSTRY_PROBABILITY
Called to determine if the given industry type is available.
@ CBID_AIRPORT_ADDITIONAL_TEXT
This callback is called from airport list.
@ CBID_INDTILE_SHAPE_CHECK
Called to determine if the given industry tile can be built on specific tile.
@ CBID_AIRPTILE_DRAW_FOUNDATIONS
Called to determine the type (if any) of foundation to draw for an airport tile.
@ CBID_INDTILE_AUTOSLOPE
Called to determine if industry can alter the ground below industry tile.
@ CBID_VEHICLE_AUTOREPLACE_SELECTION
Return the vehicles this given vehicle can be "upgraded" to.
@ CBID_VEHICLE_CUSTOM_REFIT
Called to get custom engine refit mask.
@ CBID_STATION_BUILD_TILE_LAYOUT
Called when building a station to customize the tile layout.
@ CBID_SOUNDS_AMBIENT_EFFECT
Select an ambient sound to play for a given type of tile.
@ CBID_HOUSE_CONSTRUCTION_STATE_CHANGE
Called whenever the construction state of a house changes.
@ CBID_VEHICLE_COLOUR_MAPPING
Called to determine if a specific colour map should be used for a vehicle instead of the default live...
@ CBID_INDUSTRY_DECIDE_COLOUR
Called to determine the colour of an industry.
@ CBID_INDUSTRY_WINDOW_MORE_TEXT
Called to determine more text in the industry window.
@ CBID_VEHICLE_32DAY_CALLBACK
Called for every vehicle every 32 days (not all on same date though).
@ CBID_OBJECT_LAND_SLOPE_CHECK
Callback done for each tile of an object to check the slope.
@ CBID_VEHICLE_NAME
Called to determine the engine name to show.
@ CBID_STATION_DRAW_TILE_LAYOUT
Choose a tile layout to draw, instead of the standard range.
@ CBID_VEHICLE_CARGO_SUFFIX
Determine the cargo "suffixes" for each refit possibility of a cargo.
@ CBID_HOUSE_COLOUR
Called to determine the colour of a town building.
@ CBID_HOUSE_DRAW_FOUNDATIONS
Called to determine the type (if any) of foundation to draw for house tile.
@ CBID_AIRPTILE_ANIM_START_STOP
Called for periodically starting or stopping the animation.
@ CBID_INDTILE_DRAW_FOUNDATIONS
Called to determine the type (if any) of foundation to draw for industry tile.
@ CBID_INDUSTRY_PRODUCTION_CHANGE
Called on production changes, so it can be adjusted.
@ CBID_INDUSTRY_CARGO_SUFFIX
Called to determine text to display after cargo name.
@ CBID_OBJECT_AUTOSLOPE
Called to determine if one can alter the ground below an object tile.
@ CBID_CARGO_STATION_RATING_CALC
Called to calculate part of a station rating.
@ CBID_NO_CALLBACK
Set when using the callback resolve system, but not to resolve a callback.
@ CBID_HOUSE_CARGO_ACCEPTANCE
Called to decide how much cargo a town building can accept.
@ CBID_VEHICLE_LENGTH
Vehicle length, returns the amount of 1/8's the vehicle is shorter for trains and RVs.
@ CBID_HOUSE_ANIMATION_SPEED
Called to indicate how long the current animation frame should last.
@ CBID_HOUSE_AUTOSLOPE
Called to determine if one can alter the ground below a house tile.
@ CBID_GENERIC_AI_PURCHASE_SELECTION
AI construction/purchase selection.
@ CBID_AIRPTILE_ANIMATION_SPEED
Called to indicate how long the current animation frame should last.
@ CBID_OBJECT_ANIMATION_START_STOP
Called for periodically starting or stopping the animation.
@ CBID_INDUSTRY_REFUSE_CARGO
Called to determine if the industry can still accept or refuse more cargo arrival.
@ CBID_CARGO_PROFIT_CALC
Called to calculate the income of delivered cargo.
@ CBID_STATION_AVAILABILITY
Determine whether a newstation should be made available to build.
@ CBID_HOUSE_ANIMATION_NEXT_FRAME
Determine the next animation frame for a house.
@ CBID_HOUSE_CUSTOM_NAME
Called on the Get Tile Description for an house tile.
@ CBID_INDUSTRY_MONTHLYPROD_CHANGE
Called monthly on production changes, so it can be adjusted more frequently.
@ CBID_HOUSE_DENY_DESTRUCTION
Called to determine whether a town building can be destroyed.
@ CBID_VEHICLE_START_STOP_CHECK
Called when the company (or AI) tries to start or stop a vehicle.
@ CBID_STATION_ANIMATION_SPEED
Called to indicate how long the current animation frame should last.
@ CBID_HOUSE_ALLOW_CONSTRUCTION
Determine whether the house can be built on the specified tile.
@ CBID_INDUSTRY_FUND_MORE_TEXT
Called to determine more text in the fund industry window.
@ CBID_HOUSE_WATCHED_CARGO_ACCEPTED
Called when a cargo type specified in property 20 is accepted.
@ CBID_RANDOM_TRIGGER
Set when calling a randomizing trigger (almost undocumented).
@ CBID_HOUSE_ACCEPT_CARGO
Called to determine which cargoes a town building should accept.
@ CBID_OBJECT_ANIMATION_NEXT_FRAME
Determine the next animation frame for a house.
@ CBID_TRAIN_ALLOW_WAGON_ATTACH
Determine whether a wagon can be attached to an already existing train.
@ CBID_HOUSE_PRODUCE_CARGO
Called to determine how much cargo a town building produces.
@ CBID_VEHICLE_MODIFY_PROPERTY
Called to modify various vehicle properties.
@ CBID_OBJECT_COLOUR
Called to determine the colour of a town building.
@ CBID_STATION_ANIM_START_STOP
Called for periodically starting or stopping the animation.
@ CBID_VEHICLE_ADDITIONAL_TEXT
This callback is called from vehicle purchase lists.
@ CBID_VEHICLE_REFIT_CAPACITY
Refit capacity, the passed vehicle needs to have its ->cargo_type set to the cargo we are refitting t...
@ CBID_OBJECT_ANIMATION_SPEED
Called to indicate how long the current animation frame should last.
@ CBID_STATION_LAND_SLOPE_CHECK
Callback done for each tile of a station to check the slope.
@ CBID_VEHICLE_LOAD_AMOUNT
Determine the amount of cargo to load per unit of time when using gradual loading.
@ CBID_HOUSE_DESTRUCTION
Called periodically to determine if a house should be destroyed.
@ CBID_VEHICLE_VISUAL_EFFECT
Visual effects and wagon power.
@ CBID_INDUSTRY_PROD_CHANGE_BUILD
Called when industry is built to set initial production level.
@ CBID_INDTILE_CARGO_ACCEPTANCE
Called to query the cargo acceptance of the industry tile.
@ CBID_INDUSTRY_LOCATION
Called to determine if the given industry can be built on specific area.
@ CBID_NEW_SIGNALS_SPRITE_DRAW
Allow signal sprites to be replaced dynamically.
@ CBID_INDTILE_ACCEPT_CARGO
Called to determine which cargoes an industry should accept.
@ CBID_STATION_ANIM_NEXT_FRAME
Called to determine station tile next animation frame.
@ CBID_AIRPORT_LAYOUT_NAME
Called to determine text to show as airport layout name.
@ CBID_VEHICLE_ARTIC_ENGINE
Builds articulated engines for trains and RVs.
@ CBID_AIRPTILE_ANIM_NEXT_FRAME
Called to determine airport tile next animation frame.
@ CBID_CANALS_SPRITE_OFFSET
Add an offset to the default sprite numbers to show another sprite.
@ CBID_INDUSTRY_INPUT_CARGO_TYPES
Customize the input cargo types of a newly build industry.
CanalCallbackMask
Callback masks for canals.
@ SpriteOffset
Enable add sprite offset callback.
ObjectCallbackMask
Callback masks for objects.
static const uint CALLBACK_FAILED
Different values for Callback result evaluations.
RoadStopCallbackMask
Callback masks for road stops.
IndustryTileCallbackMask
Callback masks for industry tiles.
@ ShapeCheck
decides slope suitability
HouseCallbackMask
Callback masks for houses.
@ AllowConstruction
decide whether the house can be built on a given tile
@ AcceptCargo
decides accepted types
@ Destruction
trigger destruction of building
@ AnimationStartStop
periodically start/stop the animation
@ CargoAcceptance
decides amount of cargo acceptance
@ DrawFoundations
decides if default foundations need to be drawn
@ ProduceCargo
custom cargo production
@ Autoslope
decides allowance of autosloping
@ DenyDestruction
conditional protection
@ ConstructionStateChange
change animation when construction state changes
static const uint CALLBACK_HOUSEPRODCARGO_END
Sentinel indicating that the loop for CBID_HOUSE_PRODUCE_CARGO has ended.
Transfer storage of cargo suffix information.
VisualEffect
Meaning of the various bits of the visual effect.