OpenTTD Source  20241108-master-g80f628063a
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 
20 enum CallbackID {
23 
26 
27  /* There are no callbacks 0x02 - 0x0F. */
28 
30  CBID_VEHICLE_VISUAL_EFFECT = 0x10, // 8 bit callback
31 
34 
36  CBID_VEHICLE_LOAD_AMOUNT = 0x12, // 8 bit callback
37 
39  CBID_STATION_AVAILABILITY = 0x13, // 8 bit callback
40 
43 
48  CBID_VEHICLE_REFIT_CAPACITY = 0x15, // 15 bit callback
49 
51  CBID_VEHICLE_ARTIC_ENGINE = 0x16, // 8 bit callback for grf version < 8
52 
54  CBID_HOUSE_ALLOW_CONSTRUCTION = 0x17, // 8 bit callback
55 
57  CBID_GENERIC_AI_PURCHASE_SELECTION = 0x18, // 8 bit callback, implemented for stations only
58 
61 
63  CBID_HOUSE_ANIMATION_NEXT_FRAME = 0x1A, // 15 bit callback
64 
66  CBID_HOUSE_ANIMATION_START_STOP = 0x1B, // 15 bit callback
67 
69  CBID_HOUSE_CONSTRUCTION_STATE_CHANGE = 0x1C, // 15 bit callback
70 
73 
75  CBID_HOUSE_COLOUR = 0x1E, // 15 bit callback
76 
78  CBID_HOUSE_CARGO_ACCEPTANCE = 0x1F, // 15 bit callback
79 
81  CBID_HOUSE_ANIMATION_SPEED = 0x20, // 8 bit callback
82 
84  CBID_HOUSE_DESTRUCTION = 0x21, // 8 bit callback
85 
87  CBID_INDUSTRY_PROBABILITY = 0x22, // 15 bit callback
88 
94 
96  CBID_STATION_BUILD_TILE_LAYOUT = 0x24, // 15 bit callback
97 
99  CBID_INDTILE_ANIM_START_STOP = 0x25, // 15 bit callback
100 
102  CBID_INDTILE_ANIM_NEXT_FRAME = 0x26, // 15 bit callback
103 
105  CBID_INDTILE_ANIMATION_SPEED = 0x27, // 8 bit callback
106 
108  CBID_INDUSTRY_LOCATION = 0x28, // 15 bit callback
109 
111  CBID_INDUSTRY_PRODUCTION_CHANGE = 0x29, // 15 bit callback
112 
114  CBID_HOUSE_ACCEPT_CARGO = 0x2A, // 15 bit callback
115 
117  CBID_INDTILE_CARGO_ACCEPTANCE = 0x2B, // 15 bit callback
118 
120  CBID_INDTILE_ACCEPT_CARGO = 0x2C, // 15 bit callback
121 
126  CBID_VEHICLE_COLOUR_MAPPING = 0x2D, // 15 bit callback
127 
129  CBID_HOUSE_PRODUCE_CARGO = 0x2E, // 15 bit callback
130 
132  CBID_INDTILE_SHAPE_CHECK = 0x2F, // 15 bit callback
133 
135  CBID_INDTILE_DRAW_FOUNDATIONS = 0x30, // 15 bit callback
136 
141  CBID_VEHICLE_START_STOP_CHECK = 0x31, // 15 bit callback, but 0xFF test is done with 8 bit
142 
144  CBID_VEHICLE_32DAY_CALLBACK = 0x32, // 2 bit callback
145 
147  CBID_VEHICLE_SOUND_EFFECT = 0x33, // 15 bit callback
148 
150  CBID_VEHICLE_AUTOREPLACE_SELECTION = 0x34, // 15 bit callback, not implemented
151 
153  CBID_INDUSTRY_MONTHLYPROD_CHANGE = 0x35, // 15 bit callback
154 
159  CBID_VEHICLE_MODIFY_PROPERTY = 0x36, // 8/15 bit depends on queried property
160 
162  CBID_INDUSTRY_CARGO_SUFFIX = 0x37, // 15 bit callback, but 0xFF test is done with 8 bit
163 
165  CBID_INDUSTRY_FUND_MORE_TEXT = 0x38, // 15 bit callback
166 
168  CBID_CARGO_PROFIT_CALC = 0x39, // 15 bit callback
169 
171  CBID_INDUSTRY_WINDOW_MORE_TEXT = 0x3A, // 15 bit callback
172 
174  CBID_INDUSTRY_SPECIAL_EFFECT = 0x3B, // 15 bit callback
175 
177  CBID_INDTILE_AUTOSLOPE = 0x3C, // 15 bit callback
178 
180  CBID_INDUSTRY_REFUSE_CARGO = 0x3D, // 15 bit callback
181 
182  /* There are no callbacks 0x3E - 0x13F */
183 
185  CBID_STATION_ANIM_START_STOP = 0x140, // 15 bit callback
186 
188  CBID_STATION_ANIM_NEXT_FRAME = 0x141, // 15 bit callback
189 
191  CBID_STATION_ANIMATION_SPEED = 0x142, // 8 bit callback
192 
194  CBID_HOUSE_DENY_DESTRUCTION = 0x143, // 15 bit callback
195 
197  CBID_SOUNDS_AMBIENT_EFFECT = 0x144, // 15 bit callback
198 
200  CBID_CARGO_STATION_RATING_CALC = 0x145, // 15 bit callback
201 
203  CBID_NEW_SIGNALS_SPRITE_DRAW = 0x146, // 15 bit callback, not implemented
204 
206  CBID_CANALS_SPRITE_OFFSET = 0x147, // 15 bit callback
207 
209  CBID_HOUSE_WATCHED_CARGO_ACCEPTED = 0x148, // 15 bit callback
210 
212  CBID_STATION_LAND_SLOPE_CHECK = 0x149, // 15 bit callback
213 
215  CBID_INDUSTRY_DECIDE_COLOUR = 0x14A, // 4 bit callback
216 
218  CBID_INDUSTRY_INPUT_CARGO_TYPES = 0x14B, // 8 bit callback
219 
221  CBID_INDUSTRY_OUTPUT_CARGO_TYPES = 0x14C, // 8 bit callback
222 
224  CBID_HOUSE_CUSTOM_NAME = 0x14D, // 15 bit callback
225 
227  CBID_HOUSE_DRAW_FOUNDATIONS = 0x14E, // 15 bit callback
228 
230  CBID_HOUSE_AUTOSLOPE = 0x14F, // 15 bit callback
231 
233  CBID_AIRPTILE_DRAW_FOUNDATIONS = 0x150, // 15 bit callback
234 
236  CBID_AIRPTILE_ANIM_START_STOP = 0x152, // 15 bit callback
237 
239  CBID_AIRPTILE_ANIM_NEXT_FRAME = 0x153, // 15 bit callback
240 
242  CBID_AIRPTILE_ANIMATION_SPEED = 0x154, // 8 bit callback
243 
248  CBID_AIRPORT_ADDITIONAL_TEXT = 0x155, // 15 bit callback
249 
251  CBID_AIRPORT_LAYOUT_NAME = 0x156, // 15 bit callback
252 
254  CBID_OBJECT_LAND_SLOPE_CHECK = 0x157, // 15 bit callback
255 
257  CBID_OBJECT_ANIMATION_NEXT_FRAME = 0x158, // 15 bit callback
258 
260  CBID_OBJECT_ANIMATION_START_STOP = 0x159, // 15 bit callback
261 
263  CBID_OBJECT_ANIMATION_SPEED = 0x15A, // 8 bit callback
264 
266  CBID_OBJECT_COLOUR = 0x15B, // 15 bit callback
267 
269  CBID_OBJECT_FUND_MORE_TEXT = 0x15C, // 15 bit callback
270 
272  CBID_OBJECT_AUTOSLOPE = 0x15D, // 15 bit callback
273 
275  CBID_VEHICLE_REFIT_COST = 0x15E, // 15 bit callback
276 
278  CBID_INDUSTRY_PROD_CHANGE_BUILD = 0x15F, // 15 bit callback
279 
281  CBID_VEHICLE_SPAWN_VISUAL_EFFECT = 0x160, // 15 bit callback
282 
284  CBID_VEHICLE_NAME = 0x161, // 15 bit callback
285 
287  CBID_VEHICLE_BUILD_PROBABILITY = 0x162, // 15 bit callback
288 };
289 
304 };
305 
315 };
316 
324 };
325 
343 };
344 
350 };
351 
358 };
359 
379 };
380 
392 };
393 
404 };
405 
415 };
416 
420 static const uint CALLBACK_FAILED = 0xFFFF;
421 static const uint CALLBACK_HOUSEPRODCARGO_END = 0x20FF;
422 
423 #endif /* NEWGRF_CALLBACKS_H */
StationCallbackMask
Callback masks for stations.
@ CBM_STATION_DRAW_TILE_LAYOUT
Use callback to select a tile layout to use when drawing.
@ CBM_STATION_ANIMATION_SPEED
Customize the animation speed of the station.
@ CBM_STATION_SLOPE_CHECK
Check slope of new station tiles.
@ CBM_STATION_AVAIL
Availability of station in construction window.
@ CBM_STATION_ANIMATION_NEXT_FRAME
Use a custom next frame callback.
IndustryTileCallbackMask
Callback masks for industry tiles.
@ CBM_INDT_ANIM_SPEED
decides animation speed
@ CBM_INDT_ACCEPT_CARGO
decides accepted types
@ CBM_INDT_AUTOSLOPE
decides allowance of autosloping
@ CBM_INDT_CARGO_ACCEPTANCE
decides amount of cargo acceptance
@ CBM_INDT_ANIM_NEXT_FRAME
decides next animation frame
@ CBM_INDT_SHAPE_CHECK
decides slope suitability
@ CBM_INDT_DRAW_FOUNDATIONS
decides if default foundations need to be drawn
AirportTileCallbackMask
Callback masks for airport tiles.
@ CBM_AIRT_AUTOSLOPE
decides allowance of autosloping
@ CBM_AIRT_SHAPE_CHECK
decides slope suitability
@ CBM_AIRT_ANIM_SPEED
decides animation speed
@ CBM_AIRT_DRAW_FOUNDATIONS
decides if default foundations need to be drawn
@ CBM_AIRT_ANIM_NEXT_FRAME
decides next animation frame
IndustryCallbackMask
Callback masks for Industries.
@ CBM_IND_PROD_CHANGE_BUILD
initialise production level on construction
@ CBM_IND_PRODUCTION_CHANGE
controls random production change
@ CBM_IND_LOCATION
check industry construction on given area
@ CBM_IND_DECIDE_COLOUR
give a custom colour to newly build industries
@ CBM_IND_FUND_MORE_TEXT
additional text in fund window
@ CBM_IND_PROBABILITY
industry availability/probability callback
@ CBM_IND_SPECIAL_EFFECT
control special effects
@ CBM_IND_INPUT_CARGO_TYPES
customize the cargoes the industry requires
@ CBM_IND_REFUSE_CARGO
option out of accepting cargo
@ CBM_IND_WINDOW_MORE_TEXT
additional text in industry window
@ CBM_IND_MONTHLYPROD_CHANGE
controls monthly random production change
@ CBM_IND_PRODUCTION_CARGO_ARRIVAL
call production callback when cargo arrives at the industry
@ CBM_IND_CARGO_SUFFIX
cargo sub-type display
@ CBM_IND_OUTPUT_CARGO_TYPES
customize the cargoes the industry produces
@ CBM_IND_PRODUCTION_256_TICKS
call production callback every 256 ticks
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_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.
VehicleCallbackMask
Callback masks for vehicles, indicates which callbacks are used by a vehicle.
@ CBM_VEHICLE_CARGO_SUFFIX
Show suffix after cargo name.
@ CBM_VEHICLE_NAME
Engine name.
@ CBM_VEHICLE_COLOUR_REMAP
Change colour mapping of vehicle.
@ CBM_VEHICLE_SOUND_EFFECT
Vehicle uses custom sound effects.
@ CBM_VEHICLE_LENGTH
Vehicle length (trains and road vehicles)
@ CBM_VEHICLE_VISUAL_EFFECT
Visual effects and wagon power (trains, road vehicles and ships)
@ CBM_VEHICLE_LOAD_AMOUNT
Load amount.
@ CBM_VEHICLE_REFIT_CAPACITY
Cargo capacity after refit.
@ CBM_VEHICLE_ARTIC_ENGINE
Add articulated engines (trains and road vehicles)
RoadStopCallbackMask
Callback masks for road stops.
@ CBM_ROAD_STOP_AVAIL
Availability of road stop in construction window.
@ CBM_ROAD_STOP_ANIMATION_SPEED
Customize the animation speed of the road stop.
@ CBM_ROAD_STOP_ANIMATION_NEXT_FRAME
Use a custom next frame callback.
static const uint CALLBACK_FAILED
Different values for Callback result evaluations.
CargoCallbackMask
Callback masks for cargoes.
@ CBM_CARGO_PROFIT_CALC
custom profit calculation
@ CBM_CARGO_STATION_RATING_CALC
custom station rating for this cargo type
CanalCallbackMask
Callback masks for canals.
@ CBM_CANAL_SPRITE_OFFSET
Enable add sprite offset callback.
ObjectCallbackMask
Callback masks for objects.
@ CBM_OBJ_COLOUR
decide the colour of the building
@ CBM_OBJ_ANIMATION_NEXT_FRAME
decides next animation frame
@ CBM_OBJ_ANIMATION_SPEED
decides animation speed
@ CBM_OBJ_FUND_MORE_TEXT
additional text in fund window
@ CBM_OBJ_SLOPE_CHECK
decides slope suitability
@ CBM_OBJ_AUTOSLOPE
decides allowance of autosloping
static const uint CALLBACK_HOUSEPRODCARGO_END
Sentinel indicating that the loop for CBID_HOUSE_PRODUCE_CARGO has ended.
HouseCallbackMask
Callback masks for houses.
@ CBM_HOUSE_COLOUR
decide the colour of the building
@ CBM_HOUSE_ANIMATION_SPEED
decides animation speed
@ CBM_HOUSE_PRODUCE_CARGO
custom cargo production
@ CBM_HOUSE_ALLOW_CONSTRUCTION
decide whether the house can be built on a given tile
@ CBM_HOUSE_ANIMATION_NEXT_FRAME
decides next animation frame
@ CBM_HOUSE_ANIMATION_START_STOP
periodically start/stop the animation
@ CBM_HOUSE_CONSTRUCTION_STATE_CHANGE
change animation when construction state changes
@ CBM_HOUSE_CARGO_ACCEPTANCE
decides amount of cargo acceptance
@ CBM_HOUSE_AUTOSLOPE
decides allowance of autosloping
@ CBM_HOUSE_DESTRUCTION
trigger destruction of building
@ CBM_HOUSE_ACCEPT_CARGO
decides accepted types
@ CBM_HOUSE_DRAW_FOUNDATIONS
decides if default foundations need to be drawn
@ CBM_HOUSE_DENY_DESTRUCTION
conditional protection