Files @ r28396:ef195b601c72
Branch filter:

Location: cpp/openttd-patchpack/source/src/tile_cmd.h - annotation

Peter Nelson
Fix: Pass townnameparts as parameter when testing townname based companyname. (#11685)

Length of returned string could vary and pass/fail the length check with a different
string than the final selection.
r12768:980ae0491352
r12768:980ae0491352
r12768:980ae0491352
r12768:980ae0491352
r12768:980ae0491352
r12768:980ae0491352
r12768:980ae0491352
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r8616:656db5986c9e
r12234:fd1a494e7620
r27166:64e04a3ef9b1
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r8373:e7760b9340e5
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r14900:c679fdaeebe6
r8119:8fdb3a371896
r10260:88d82a40120c
r8138:f851b4cbdad1
r26819:530276d63631
r26819:530276d63631
r10260:88d82a40120c
r10260:88d82a40120c
r18260:9616113792ef
r8138:f851b4cbdad1
r8138:f851b4cbdad1
r10260:88d82a40120c
r8138:f851b4cbdad1
r14612:34835c8eb396
r27567:b9fab631f60e
r14612:34835c8eb396
r14612:34835c8eb396
r27166:64e04a3ef9b1
r14612:34835c8eb396
r14612:34835c8eb396
r16013:5414ec59355b
r16013:5414ec59355b
r14612:34835c8eb396
r14612:34835c8eb396
r22479:b6106f114b30
r27737:728d55b97775
r23698:1872cc5b7dd7
r27737:728d55b97775
r23698:1872cc5b7dd7
r27737:728d55b97775
r8138:f851b4cbdad1
r8138:f851b4cbdad1
r10260:88d82a40120c
r10260:88d82a40120c
r10260:88d82a40120c
r10260:88d82a40120c
r8119:8fdb3a371896
r27056:ac04ccbeb86c
r27056:ac04ccbeb86c
r27056:ac04ccbeb86c
r27056:ac04ccbeb86c
r27056:ac04ccbeb86c
r27056:ac04ccbeb86c
r27056:ac04ccbeb86c
r27056:ac04ccbeb86c
r27056:ac04ccbeb86c
r27056:ac04ccbeb86c
r27056:ac04ccbeb86c
r27056:ac04ccbeb86c
r27056:ac04ccbeb86c
r11090:9276cea703d4
r10260:88d82a40120c
r10260:88d82a40120c
r12251:58d0d73149cb
r13079:08897f5063ec
r13079:08897f5063ec
r13082:6e27873417fb
r10260:88d82a40120c
r22867:9bff1c966805
r10260:88d82a40120c
r10260:88d82a40120c
r10260:88d82a40120c
r10260:88d82a40120c
r10260:88d82a40120c
r10260:88d82a40120c
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r10260:88d82a40120c
r8616:656db5986c9e
r10260:88d82a40120c
r8616:656db5986c9e
r8119:8fdb3a371896
r8616:656db5986c9e
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r8616:656db5986c9e
r8119:8fdb3a371896
r8616:656db5986c9e
r10260:88d82a40120c
r10260:88d82a40120c
r10260:88d82a40120c
r12251:58d0d73149cb
r12251:58d0d73149cb
r10260:88d82a40120c
r12253:9cc92893e2d0
r10532:23a12232250b
r8119:8fdb3a371896
r8119:8fdb3a371896
r10207:a1fc2f2a33db
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r10260:88d82a40120c
r10260:88d82a40120c
r10260:88d82a40120c
r10260:88d82a40120c
r10260:88d82a40120c
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r18261:0aa61ca7490f
r8119:8fdb3a371896
r10233:f4b6f7cfa2ac
r10233:f4b6f7cfa2ac
r15613:193c12018337
r15613:193c12018337
r8119:8fdb3a371896
r10260:88d82a40120c
r8119:8fdb3a371896
r8119:8fdb3a371896
r12234:fd1a494e7620
r10260:88d82a40120c
r10260:88d82a40120c
r10260:88d82a40120c
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r12248:7acc3688a3f0
r10260:88d82a40120c
r8119:8fdb3a371896
r10260:88d82a40120c
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r8119:8fdb3a371896
r8616:656db5986c9e
r10496:066b00742139
r10207:a1fc2f2a33db
r8119:8fdb3a371896
r8119:8fdb3a371896
r22867:9bff1c966805
r12234:fd1a494e7620
r12234:fd1a494e7620
r23607:36c15679007d
r23607:36c15679007d
r23607:36c15679007d
r12234:fd1a494e7620
r12234:fd1a494e7620
r12253:9cc92893e2d0
r12248:7acc3688a3f0
r12248:7acc3688a3f0
r23607:36c15679007d
r12251:58d0d73149cb
r12248:7acc3688a3f0
r12248:7acc3688a3f0
r12235:f6faf5ffa926
r12235:f6faf5ffa926
r12235:f6faf5ffa926
r23607:36c15679007d
r12235:f6faf5ffa926
r12235:f6faf5ffa926
r12235:f6faf5ffa926
r12235:f6faf5ffa926
r12235:f6faf5ffa926
r12235:f6faf5ffa926
r23607:36c15679007d
r12235:f6faf5ffa926
r12235:f6faf5ffa926
r12235:f6faf5ffa926
r8119:8fdb3a371896
/*
 * This file is part of OpenTTD.
 * 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.
 * 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.
 * 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/>.
 */

/** @file tile_cmd.h Generic 'commands' that can be performed on all tiles. */

#ifndef TILE_CMD_H
#define TILE_CMD_H

#include "command_type.h"
#include "vehicle_type.h"
#include "cargo_type.h"
#include "track_type.h"
#include "tile_map.h"
#include "timer/timer_game_calendar.h"

/** The returned bits of VehicleEnterTile. */
enum VehicleEnterTileStatus {
	VETS_ENTERED_STATION  = 1, ///< The vehicle entered a station
	VETS_ENTERED_WORMHOLE = 2, ///< The vehicle either entered a bridge, tunnel or depot tile (this includes the last tile of the bridge/tunnel)
	VETS_CANNOT_ENTER     = 3, ///< The vehicle cannot enter the tile

	/**
	 * Shift the VehicleEnterTileStatus this many bits
	 * to the right to get the station ID when
	 * VETS_ENTERED_STATION is set
	 */
	VETS_STATION_ID_OFFSET = 8,
	VETS_STATION_MASK      = 0xFFFF << VETS_STATION_ID_OFFSET,

	/** Bit sets of the above specified bits */
	VETSB_CONTINUE         = 0,                          ///< The vehicle can continue normally
	VETSB_ENTERED_STATION  = 1 << VETS_ENTERED_STATION,  ///< The vehicle entered a station
	VETSB_ENTERED_WORMHOLE = 1 << VETS_ENTERED_WORMHOLE, ///< The vehicle either entered a bridge, tunnel or depot tile (this includes the last tile of the bridge/tunnel)
	VETSB_CANNOT_ENTER     = 1 << VETS_CANNOT_ENTER,     ///< The vehicle cannot enter the tile
};
DECLARE_ENUM_AS_BIT_SET(VehicleEnterTileStatus)

/** Tile information, used while rendering the tile */
struct TileInfo {
	int x;          ///< X position of the tile in unit coordinates
	int y;          ///< Y position of the tile in unit coordinates
	Slope tileh;    ///< Slope of the tile
	TileIndex tile; ///< Tile index
	int z;          ///< Height
};

/** Tile description for the 'land area information' tool */
struct TileDesc {
	StringID str;               ///< Description of the tile
	uint64_t dparam;            ///< Parameter of the \a str string
	Owner owner[4];             ///< Name of the owner(s)
	StringID owner_type[4];     ///< Type of each owner
	TimerGameCalendar::Date build_date; ///< Date of construction of tile contents
	StringID station_class;     ///< Class of station
	StringID station_name;      ///< Type of station within the class
	StringID airport_class;     ///< Name of the airport class
	StringID airport_name;      ///< Name of the airport
	StringID airport_tile_name; ///< Name of the airport tile
	const char *grf;            ///< newGRF used for the tile contents
	StringID railtype;          ///< Type of rail on the tile.
	uint16_t rail_speed;          ///< Speed limit of rail (bridges and track)
	StringID roadtype;          ///< Type of road on the tile.
	uint16_t road_speed;          ///< Speed limit of road (bridges and track)
	StringID tramtype;          ///< Type of tram on the tile.
	uint16_t tram_speed;          ///< Speed limit of tram (bridges and track)
};

/**
 * Tile callback function signature for drawing a tile and its contents to the screen
 * @param ti Information about the tile to draw
 */
typedef void DrawTileProc(TileInfo *ti);

/**
 * Tile callback function signature for obtaining the world \c Z coordinate of a given
 * point of a tile.
 *
 * @param tile The queries tile for the Z coordinate.
 * @param x World X coordinate in tile "units".
 * @param y World Y coordinate in tile "units".
 * @param ground_vehicle Whether to get the Z coordinate of the ground vehicle, or the ground.
 * @return World Z coordinate at tile ground (vehicle) level, including slopes and foundations.
 * @see GetSlopePixelZ
 */
typedef int GetSlopeZProc(TileIndex tile, uint x, uint y, bool ground_vehicle);
typedef CommandCost ClearTileProc(TileIndex tile, DoCommandFlag flags);

/**
 * Tile callback function signature for obtaining cargo acceptance of a tile
 * @param tile            Tile queried for its accepted cargo
 * @param acceptance      Storage destination of the cargo acceptance in 1/8
 * @param always_accepted Bitmask of always accepted cargo types
 */
typedef void AddAcceptedCargoProc(TileIndex tile, CargoArray &acceptance, CargoTypes *always_accepted);

/**
 * Tile callback function signature for obtaining a tile description
 * @param tile Tile being queried
 * @param td   Storage pointer for returned tile description
 */
typedef void GetTileDescProc(TileIndex tile, TileDesc *td);

/**
 * Tile callback function signature for getting the possible tracks
 * that can be taken on a given tile by a given transport.
 *
 * The return value contains the existing trackdirs and signal states.
 *
 * see track_func.h for usage of TrackStatus.
 *
 * @param tile     the tile to get the track status from
 * @param mode     the mode of transportation
 * @param sub_mode used to differentiate between different kinds within the mode
 * @return the track status information
 */
typedef TrackStatus GetTileTrackStatusProc(TileIndex tile, TransportType mode, uint sub_mode, DiagDirection side);

/**
 * Tile callback function signature for obtaining the produced cargo of a tile.
 * @param tile      Tile being queried
 * @param produced  Destination array for produced cargo
 */
typedef void AddProducedCargoProc(TileIndex tile, CargoArray &produced);
typedef bool ClickTileProc(TileIndex tile);
typedef void AnimateTileProc(TileIndex tile);
typedef void TileLoopProc(TileIndex tile);
typedef void ChangeTileOwnerProc(TileIndex tile, Owner old_owner, Owner new_owner);

/** @see VehicleEnterTileStatus to see what the return values mean */
typedef VehicleEnterTileStatus VehicleEnterTileProc(Vehicle *v, TileIndex tile, int x, int y);
typedef Foundation GetFoundationProc(TileIndex tile, Slope tileh);

/**
 * Tile callback function signature of the terraforming callback.
 *
 * The function is called when a tile is affected by a terraforming operation.
 * It has to check if terraforming of the tile is allowed and return extra terraform-cost that depend on the tiletype.
 * With DC_EXEC in \a flags it has to perform tiletype-specific actions (like clearing land etc., but not the terraforming itself).
 *
 * @note The terraforming has not yet taken place. So GetTileZ() and GetTileSlope() refer to the landscape before the terraforming operation.
 *
 * @param tile      The involved tile.
 * @param flags     Command flags passed to the terraform command (DC_EXEC, DC_QUERY_COST, etc.).
 * @param z_new     TileZ after terraforming.
 * @param tileh_new Slope after terraforming.
 * @return Error code or extra cost for terraforming (like clearing land, building foundations, etc., but not the terraforming itself.)
 */
typedef CommandCost TerraformTileProc(TileIndex tile, DoCommandFlag flags, int z_new, Slope tileh_new);

/**
 * Set of callback functions for performing tile operations of a given tile type.
 * @see TileType
 */
struct TileTypeProcs {
	DrawTileProc *draw_tile_proc;                  ///< Called to render the tile and its contents to the screen
	GetSlopeZProc *get_slope_z_proc;
	ClearTileProc *clear_tile_proc;
	AddAcceptedCargoProc *add_accepted_cargo_proc; ///< Adds accepted cargo of the tile to cargo array supplied as parameter
	GetTileDescProc *get_tile_desc_proc;           ///< Get a description of a tile (for the 'land area information' tool)
	GetTileTrackStatusProc *get_tile_track_status_proc; ///< Get available tracks and status of a tile
	ClickTileProc *click_tile_proc;                ///< Called when tile is clicked
	AnimateTileProc *animate_tile_proc;
	TileLoopProc *tile_loop_proc;
	ChangeTileOwnerProc *change_tile_owner_proc;
	AddProducedCargoProc *add_produced_cargo_proc; ///< Adds produced cargo of the tile to cargo array supplied as parameter
	VehicleEnterTileProc *vehicle_enter_tile_proc; ///< Called when a vehicle enters a tile
	GetFoundationProc *get_foundation_proc;
	TerraformTileProc *terraform_tile_proc;        ///< Called when a terraforming operation is about to take place
};

extern const TileTypeProcs * const _tile_type_procs[16];

TrackStatus GetTileTrackStatus(TileIndex tile, TransportType mode, uint sub_mode, DiagDirection side = INVALID_DIAGDIR);
VehicleEnterTileStatus VehicleEnterTile(Vehicle *v, TileIndex tile, int x, int y);
void ChangeTileOwner(TileIndex tile, Owner old_owner, Owner new_owner);
void GetTileDesc(TileIndex tile, TileDesc *td);

static inline void AddAcceptedCargo(TileIndex tile, CargoArray &acceptance, CargoTypes *always_accepted)
{
	AddAcceptedCargoProc *proc = _tile_type_procs[GetTileType(tile)]->add_accepted_cargo_proc;
	if (proc == nullptr) return;
	CargoTypes dummy = 0; // use dummy bitmask so there don't need to be several 'always_accepted != nullptr' checks
	proc(tile, acceptance, always_accepted == nullptr ? &dummy : always_accepted);
}

static inline void AddProducedCargo(TileIndex tile, CargoArray &produced)
{
	AddProducedCargoProc *proc = _tile_type_procs[GetTileType(tile)]->add_produced_cargo_proc;
	if (proc == nullptr) return;
	proc(tile, produced);
}

static inline void AnimateTile(TileIndex tile)
{
	AnimateTileProc *proc = _tile_type_procs[GetTileType(tile)]->animate_tile_proc;
	assert(proc != nullptr);
	proc(tile);
}

static inline bool ClickTile(TileIndex tile)
{
	ClickTileProc *proc = _tile_type_procs[GetTileType(tile)]->click_tile_proc;
	if (proc == nullptr) return false;
	return proc(tile);
}

#endif /* TILE_CMD_H */