tron@2186: /* $Id$ */
tron@2186: 
belugas@6909: /** @file newgrf_callbacks.h
belugas@6909:  */
belugas@6909: 
peter1138@2982: #ifndef NEWGRF_CALLBACKS_H
peter1138@2982: #define NEWGRF_CALLBACKS_H
truelight@0: 
truelight@0: 
peter1138@3007: /**
peter1138@3007:  * List of implemented NewGRF callbacks.
rubidium@7711:  * Most of these callbacks are only triggered when the corresponding
rubidium@7711:  * bit is set in the callback flags/trigger for a vehicle, house,
rubidium@7711:  * industry, etc.
peter1138@3007:  * Names are formatted as CBID_<CLASS>_<CALLBACK>
rubidium@8096:  *
rubidium@8096:  * @note Do not forget to add 15 bits callbacks to the switch in
rubidium@8096:  *       newgrf_spritegroup.cpp (search for "15 bits callback").
peter1138@3007:  */
hackykid@1883: enum CallbackID {
rubidium@7823: 	/** Set when using the callback resolve system, but not to resolve a callback. */
rubidium@7823: 	CBID_NO_CALLBACK                     = 0x00,
rubidium@7823: 
rubidium@7711: 	/** Set when calling a randomizing trigger (almost undocumented). */
rubidium@7711: 	CBID_RANDOM_TRIGGER                  = 0x01,
peter1138@4244: 
rubidium@8138: 	/* There are no callbacks 0x02 - 0x0F. */
rubidium@8138: 
rubidium@7711: 	/** Powered wagons, if the result is lower as 0x40 then the wagon is powered
rubidium@7711: 	 * @todo : interpret the rest of the result, aka "visual effects". */
rubidium@7711: 	CBID_TRAIN_WAGON_POWER               = 0x10,
belugas@6909: 
rubidium@7711: 	/** Vehicle length, returns the amount of 1/8's the vehicle is shorter for trains and RVs. */
rubidium@7711: 	CBID_VEHICLE_LENGTH                  = 0x11,
belugas@6909: 
rubidium@7711: 	/** Determine the amount of cargo to load per unit of time when using gradual loading. */
rubidium@7711: 	CBID_VEHICLE_LOAD_AMOUNT             = 0x12,
belugas@6909: 
rubidium@7711: 	/** Determine whether a newstation should be made available to build. */
rubidium@7711: 	CBID_STATION_AVAILABILITY            = 0x13,
belugas@6909: 
rubidium@7711: 	/** Choose a sprite layout to draw, instead of the standard 0-7 range. */
rubidium@7711: 	CBID_STATION_SPRITE_LAYOUT           = 0x14,
peter1138@6685: 
rubidium@7711: 	/** Refit capacity, the passed vehicle needs to have its ->cargo_type set to
rubidium@7711: 	 * the cargo we are refitting to, returns the new cargo capacity. */
rubidium@7711: 	CBID_VEHICLE_REFIT_CAPACITY          = 0x15,
rubidium@7711: 
rubidium@7711: 	/** Builds articulated engines for trains and RVs. */
rubidium@7711: 	CBID_VEHICLE_ARTIC_ENGINE            = 0x16,
rubidium@7711: 
rubidium@7711: 	/** Determine whether the house can be built on the specified tile. */
rubidium@7711: 	CBID_HOUSE_ALLOW_CONSTRUCTION        = 0x17,
rubidium@7711: 
rubidium@7711: 	/** AI construction/purchase selection */
rubidium@7711: 	CBID_GENERIC_AI_PURCHASE_SELECTION   = 0x18, // not implemented
rubidium@7711: 
rubidium@7711: 	/** Determine the cargo "suffixes" for each refit possibility of a cargo. */
rubidium@7711: 	CBID_VEHICLE_CARGO_SUFFIX            = 0x19,
rubidium@7711: 
rubidium@7711: 	/** Determine the next animation frame for a house. */
rubidium@7711: 	CBID_HOUSE_ANIMATION_NEXT_FRAME      = 0x1A,
rubidium@7711: 
rubidium@7711: 	/** Called for periodically starting or stopping the animation. */
rubidium@7711: 	CBID_HOUSE_ANIMATION_START_STOP      = 0x1B,
rubidium@7711: 
rubidium@7711: 	/** Called whenever the construction state of a house changes. */
rubidium@7711: 	CBID_HOUSE_CONSTRUCTION_STATE_CHANGE = 0x1C,
rubidium@7711: 
rubidium@7711: 	/** Determine whether a wagon can be attached to an already existing train. */
rubidium@7711: 	CBID_TRAIN_ALLOW_WAGON_ATTACH        = 0x1D,
rubidium@7711: 
rubidium@7711: 	/** Called to determine the colour of a town building. */
rubidium@8138: 	CBID_HOUSE_COLOUR                    = 0x1E,
rubidium@7711: 
rubidium@7711: 	/** Called to decide how much cargo a town building can accept. */
rubidium@7711: 	CBID_HOUSE_CARGO_ACCEPTANCE          = 0x1F,
rubidium@7711: 
rubidium@7711: 	/** Called to indicate how long the current animation frame should last. */
rubidium@7711: 	CBID_HOUSE_ANIMATION_SPEED           = 0x20,
rubidium@7711: 
rubidium@7711: 	/** Called periodically to determine if a house should be destroyed. */
rubidium@7711: 	CBID_HOUSE_DESTRUCTION               = 0x21,
rubidium@7711: 
rubidium@7711: 	/** Called to determine if the given industry type is available */
belugas@7779: 	CBID_INDUSTRY_AVAILABLE              = 0x22,
rubidium@7711: 
rubidium@7711: 	/** This callback is called from vehicle purchase lists. It returns a value to be
rubidium@7711: 	 * used as a custom string ID in the 0xD000 range. */
rubidium@7711: 	CBID_VEHICLE_ADDITIONAL_TEXT         = 0x23,
rubidium@7711: 
rubidium@7711: 	/** Called when building a station to customize the tile layout */
rubidium@7711: 	CBID_STATION_TILE_LAYOUT             = 0x24,
rubidium@7711: 
rubidium@7711: 	/** Called for periodically starting or stopping the animation. */
rubidium@7725: 	CBID_INDTILE_ANIM_START_STOP         = 0x25,
rubidium@7711: 
rubidium@7711: 	/** Called to determine industry tile next animation frame. */
rubidium@7725: 	CBID_INDTILE_ANIM_NEXT_FRAME         = 0x26,
rubidium@7711: 
rubidium@7711: 	/** Called to indicate how long the current animation frame should last. */
rubidium@7725: 	CBID_INDTILE_ANIMATION_SPEED         = 0x27,
rubidium@7711: 
rubidium@7711: 	/** Called to determine if the given industry can be built on specific area. */
rubidium@7711: 	CBID_INDUSTRY_LOCATION               = 0x28,
rubidium@7711: 
rubidium@7711: 	/** Called on production changes, so it can be adjusted. */
glx@8111: 	CBID_INDUSTRY_PRODUCTION_CHANGE      = 0x29,
rubidium@7711: 
rubidium@7711: 	/** Called to determine which cargoes a town building should accept. */
rubidium@7711: 	CBID_HOUSE_ACCEPT_CARGO              = 0x2A,
rubidium@7711: 
rubidium@7711: 	/** Called to query the cargo acceptance of the industry tile */
rubidium@7711: 	CBID_INDTILE_CARGO_ACCEPTANCE        = 0x2B,
rubidium@7711: 
rubidium@7711: 	/** Called to determine which cargoes an industry should accept. */
rubidium@7711: 	CBID_INDTILE_ACCEPT_CARGO            = 0x2C,
rubidium@7711: 
rubidium@7711: 	/** Called to determine if a specific colour map should be used for a vehicle
rubidium@7711: 	 * instead of the default livery. */
rubidium@7711: 	CBID_VEHICLE_COLOUR_MAPPING          = 0x2D,
rubidium@7711: 
rubidium@7711: 	/** Called to determine how much cargo a town building produces. */
rubidium@7711: 	CBID_HOUSE_PRODUCE_CARGO             = 0x2E,
rubidium@7711: 
rubidium@7711: 	/** Called to determine if the given industry tile can be built on specific tile. */
rubidium@7711: 	CBID_INDTILE_SHAPE_CHECK             = 0x2F,
rubidium@7711: 
rubidium@7711: 	/** Called to determine the type (if any) of foundation to draw for industry tile. */
rubidium@7711: 	CBID_INDUSTRY_DRAW_FOUNDATIONS       = 0x30,
rubidium@7711: 
rubidium@7711: 	/** Called when the player (or AI) tries to start or stop a vehicle. Mainly
rubidium@7711: 	 * used for preventing a vehicle from leaving the depot. */
rubidium@7711: 	CBID_VEHICLE_START_STOP_CHECK        = 0x31,
rubidium@7711: 
rubidium@7711: 	/** Called for every vehicle every 32 days (not all on same date though). */
glx@8299: 	CBID_VEHICLE_32DAY_CALLBACK          = 0x32,
rubidium@7711: 
rubidium@7711: 	/** Called to play a special sound effect */
rubidium@7711: 	CBID_VEHICLE_SOUND_EFFECT            = 0x33,
rubidium@7711: 
rubidium@7711: 	/** Return the vehicles this given vehicle can be "upgraded" to. */
rubidium@7711: 	CBID_VEHICLE_AUTOREPLACE_SELECTION   = 0x34,
rubidium@7711: 
rubidium@7711: 	/** Called monthly on production changes, so it can be adjusted more frequently */
glx@8111: 	CBID_INDUSTRY_MONTHLYPROD_CHANGE     = 0x35,
rubidium@7711: 
rubidium@7711: 	/** Called to modify various vehicle properties. Callback parameter 1
rubidium@7711: 	 * specifies the property index, as used in Action 0, to change. */
rubidium@7711: 	CBID_VEHICLE_MODIFY_PROPERTY         = 0x36,
rubidium@7711: 
rubidium@7711: 	/** Called to determine text to display after cargo name */
glx@9255: 	CBID_INDUSTRY_CARGO_SUFFIX           = 0x37,
rubidium@7711: 
rubidium@7711: 	/** Called to determine more text in the fund industry window */
belugas@7720: 	CBID_INDUSTRY_FUND_MORE_TEXT         = 0x38,
rubidium@7711: 
rubidium@7711: 	/** Called to calculate the income of delivered cargo */
rubidium@7711: 	CBID_CARGO_PROFIT_CALC               = 0x39,
rubidium@7711: 
rubidium@7711: 	/** Called to determine more text in the industry window */
rubidium@7711: 	CBID_INDUSTRY_WINDOW_MORE_TEXT       = 0x3A,
rubidium@7711: 
rubidium@7711: 	/** Called to determine industry special effects */
rubidium@7711: 	CBID_INDUSTRY_SPECIAL_EFFECT         = 0x3B,
rubidium@7711: 
rubidium@7711: 	/** Called to determine if industry can alter the ground below industry tile */
rubidium@8078: 	CBID_INDUSTRY_AUTOSLOPE              = 0x3C,
rubidium@7711: 
rubidium@7711: 	/** Called to determine if the industry can still accept or refuse more cargo arrival */
rubidium@7711: 	CBID_INDUSTRY_REFUSE_CARGO           = 0x3D,
rubidium@7711: 
glx@8287: 	/* There are no callbacks 0x3E - 0x13F */
glx@8287: 
glx@8287: 	/** Called for periodically starting or stopping the animation. */
glx@8287: 	CBID_STATION_ANIM_START_STOP         = 0x140, // not implemented
glx@8287: 
glx@8287: 	/** Called to determine station tile next animation frame. */
glx@8287: 	CBID_STATION_ANIM_NEXT_FRAME         = 0x141, // not implemented
glx@8287: 
glx@8287: 	/** Called to indicate how long the current animation frame should last. */
glx@8287: 	CBID_STATION_ANIMATION_SPEED         = 0x142, // not implemented
rubidium@8138: 
rubidium@7711: 	/** Called to determine whether a town building can be destroyed. */
rubidium@7711: 	CBID_HOUSE_DENY_DESTRUCTION          = 0x143,
rubidium@7711: 
rubidium@7711: 	/** Select an ambient sound to play for a given type of tile. */
rubidium@7711: 	CBID_SOUNDS_AMBIENT_EFFECT           = 0x144, // not implemented
rubidium@7711: 
rubidium@7711: 	/** Called to calculate part of a station rating. */
rubidium@7711: 	CBID_CARGO_STATION_RATING_CALC       = 0x145,
rubidium@7711: 
rubidium@7711: 	/** Allow signal sprites to be replaced dynamically. */
rubidium@7711: 	CBID_NEW_SIGNALS_SPRITE_DRAW         = 0x146, // not implemented
rubidium@7711: 
rubidium@7711: 	/** Add an offset to the default sprite numbers to show another sprite. */
rubidium@7711: 	CBID_CANALS_SPRITE_OFFSET            = 0x147, // not implemented
rubidium@8138: 
glx@8287: 	/** Called when a cargo type specified in property 20 is accepted. */
glx@8287: 	CBID_HOUSE_WATCHED_CARGO_ACCEPTED    = 0x148, // not implemented
rubidium@8138: 
rubidium@8138: 	/** Callback done for each tile of a station to check the slope. */
rubidium@8138: 	CBID_STATION_LAND_SLOPE_CHECK        = 0x149, // not implemented
rubidium@8138: 
rubidium@8138: 	/** Called to determine the color of an industry. */
glx@8146: 	CBID_INDUSTRY_DECIDE_COLOUR          = 0x14A,
rubidium@8138: 
rubidium@8138: 	/** Customize the input cargo types of a newly build industry. */
glx@8142: 	CBID_INDUSTRY_INPUT_CARGO_TYPES      = 0x14B,
rubidium@8138: 
rubidium@8138: 	/** Customize the output cargo types of a newly build industry. */
glx@8142: 	CBID_INDUSTRY_OUTPUT_CARGO_TYPES     = 0x14C,
frosch@9181: 
frosch@9181: 	/* ATTENTION:
frosch@9181: 	 * When adding new callbacks and their result is 15bit, add them to newgrf_spritegroup.cpp:Is8BitCallback().
frosch@9181: 	 * It does not harm to add them there though they are not implemented. But it does harm if they get forgotton.
frosch@9181: 	 */
hackykid@1895: };
hackykid@1895: 
peter1138@3007: /**
peter1138@3007:  * Callback masks for vehicles, indicates which callbacks are used by a vehicle.
peter1138@3007:  * Some callbacks are always used and don't have a mask.
peter1138@3007:  */
peter1138@3007: enum VehicleCallbackMask {
rubidium@8138: 	CBM_TRAIN_WAGON_POWER      = 0, ///< Powered wagons (trains only)
rubidium@8138: 	CBM_VEHICLE_LENGTH         = 1, ///< Vehicle length (trains and road vehicles)
rubidium@8138: 	CBM_VEHICLE_LOAD_AMOUNT    = 2, ///< Load amount
rubidium@8138: 	CBM_VEHICLE_REFIT_CAPACITY = 3, ///< Cargo capacity after refit
rubidium@8138: 	CBM_VEHICLE_ARTIC_ENGINE   = 4, ///< Add articulated engines (trains only)
rubidium@8138: 	CBM_VEHICLE_CARGO_SUFFIX   = 5, ///< Show suffix after cargo name
rubidium@8138: 	CBM_VEHICLE_COLOUR_REMAP   = 6, ///< Change colour mapping of vehicle
rubidium@8138: 	CBM_VEHICLE_SOUND_EFFECT   = 7, ///< Vehicle uses custom sound effects
hackykid@1883: };
hackykid@1883: 
peter1138@3007: /**
peter1138@3505:  * Callback masks for stations.
peter1138@3505:  */
peter1138@3505: enum StationCallbackMask {
rubidium@8138: 	CBM_STATION_AVAIL                = 0, ///< Availability of station in construction window
rubidium@8138: 	CBM_STATION_SPRITE_LAYOUT        = 1, ///< Use callback to select a sprite layout to use
rubidium@8138: 	CBM_STATION_ANIMATION_NEXT_FRAME = 2, ///< Use a custom next frame callback
rubidium@8138: 	CBM_STATION_ANIMATION_SPEED      = 3, ///< Customize the animation speed of the station
rubidium@8138: 	CBM_STATION_SLOPE_CHECK          = 4, ///< Check slope of new station tiles
peter1138@3505: };
peter1138@3505: 
peter1138@3505: /**
maedhros@6658:  * Callback masks for houses.
maedhros@6658:  */
maedhros@6658: enum HouseCallbackMask {
rubidium@8138: 	CBM_HOUSE_ALLOW_CONSTRUCTION        =  0,
rubidium@8138: 	CBM_HOUSE_ANIMATION_NEXT_FRAME      =  1,
rubidium@8138: 	CBM_HOUSE_ANIMATION_START_STOP      =  2,
rubidium@8138: 	CBM_HOUSE_CONSTRUCTION_STATE_CHANGE =  3,
rubidium@8138: 	CBM_HOUSE_COLOUR                    =  4,
rubidium@8138: 	CBM_HOUSE_CARGO_ACCEPTANCE          =  5,
rubidium@8138: 	CBM_HOUSE_ANIMATION_SPEED           =  6,
rubidium@8138: 	CBM_HOUSE_DESTRUCTION               =  7,
rubidium@8138: 	CBM_HOUSE_ACCEPT_CARGO              =  8,
rubidium@8138: 	CBM_HOUSE_PRODUCE_CARGO             =  9,
rubidium@8138: 	CBM_HOUSE_DENY_DESTRUCTION          = 10,
maedhros@6658: };
maedhros@6658: 
maedhros@6658: /**
peter1138@6685:  * Callback masks for cargos.
peter1138@6685:  */
peter1138@6685: enum CargoCallbackMask {
rubidium@8138: 	CBM_CARGO_PROFIT_CALC         = 0, ///< custom profit calculation
rubidium@8138: 	CBM_CARGO_STATION_RATING_CALC = 1, ///< custom station rating for this cargo type
peter1138@6685: };
peter1138@6685: 
peter1138@6685: /**
belugas@6909:  * Callback masks for Industries
belugas@6909:  */
belugas@6909: enum IndustryCallbackMask {
rubidium@8138: 	CBM_IND_AVAILABLE                 =  0, ///< industry availability callback
rubidium@8138: 	CBM_IND_PRODUCTION_CARGO_ARRIVAL  =  1, ///< call production callback when cargo arrives at the industry
rubidium@8138: 	CBM_IND_PRODUCTION_256_TICKS      =  2, ///< call production callback every 256 ticks
rubidium@8138: 	CBM_IND_LOCATION                  =  3, ///< check industry construction on given area
rubidium@8138: 	CBM_IND_PRODUCTION_CHANGE         =  4, ///< controls random production change
rubidium@8138: 	CBM_IND_MONTHLYPROD_CHANGE        =  5, ///< controls monthly random production change
rubidium@8138: 	CBM_IND_CARGO_SUFFIX              =  6, ///< cargo sub-type display
rubidium@8138: 	CBM_IND_FUND_MORE_TEXT            =  7, ///< additional text in fund window
rubidium@8138: 	CBM_IND_WINDOW_MORE_TEXT          =  8, ///< additional text in industry window
rubidium@8138: 	CBM_IND_SPECIAL_EFFECT            =  9, ///< control special effects
belugas@6909: 	CBM_IND_REFUSE_CARGO              = 10, ///< option out of accepting cargo
rubidium@8138: 	CBM_IND_DECIDE_COLOUR             = 11, ///< give a custom colour to newly build industries
rubidium@8138: 	CBM_IND_INPUT_CARGO_TYPES         = 12, ///< customize the cargos the industry requires
rubidium@8138: 	CBM_IND_OUTPUT_CARGO_TYPES        = 13, ///< customize the cargos the industry produces
belugas@6909: };
belugas@6909: 
belugas@6909: /**
belugas@6909:  * Callback masks for industry tiles
belugas@6909:  */
belugas@6909: enum IndustryTileCallbackMask {
belugas@6909: 	CBM_INDT_ANIM_NEXT_FRAME          = 0,  ///< decides next animation frame
belugas@6909: 	CBM_INDT_ANIM_SPEED               = 1,  ///< decides animation speed
rubidium@7695: 	CBM_INDT_CARGO_ACCEPTANCE         = 2,  ///< decides amount of cargo acceptance
belugas@6909: 	CBM_INDT_ACCEPT_CARGO             = 3,  ///< decides accepted types
belugas@6909: 	CBM_INDT_SHAPE_CHECK              = 4,  ///< decides slope suitability
belugas@6909: 	CBM_INDT_DRAW_FOUNDATIONS         = 5,  ///< decides if default foundations need to be drawn
belugas@6909: 	CBM_INDT_AUTOSLOPE                = 6,  ///< decides allowance of autosloping
belugas@6909: };
belugas@6909: 
belugas@6909: /**
belugas@8783:  * Different values for Callback result evaluations
peter1138@3007:  */
hackykid@1883: enum {
belugas@8783: 	CALLBACK_FAILED              = 0xFFFF,  ///< Result of a failed callback.
belugas@8783: 	CALLBACK_HOUSEPRODCARGO_END  = 0x20FF,  ///< Sentinel indicating that the loop for CBID_HOUSE_PRODUCE_CARGO has ended
hackykid@1883: };
hackykid@1883: 
peter1138@2982: #endif /* NEWGRF_CALLBACKS_H */