(svn r22541) -Document: GoodsEntry struct.

This commit is contained in:
terkhen 2011-06-04 21:19:00 +00:00
parent 5bb79b1f46
commit 9f68c20d10

View File

@ -23,10 +23,14 @@ extern StationPool _station_pool;
static const byte INITIAL_STATION_RATING = 175; static const byte INITIAL_STATION_RATING = 175;
/**
* Stores station stats for a single cargo.
*/
struct GoodsEntry { struct GoodsEntry {
/** Status of this cargo for the station. */
enum GoodsEntryStatus { enum GoodsEntryStatus {
GES_ACCEPTANCE, GES_ACCEPTANCE, ///< This cargo is currently being accepted by the station.
GES_PICKUP, GES_PICKUP, ///< This cargo has been picked up at this station at least once.
}; };
GoodsEntry() : GoodsEntry() :
@ -37,11 +41,11 @@ struct GoodsEntry {
last_age(255) last_age(255)
{} {}
byte acceptance_pickup; byte acceptance_pickup; ///< Status of this cargo, see #GoodsEntryStatus.
byte days_since_pickup; byte days_since_pickup; ///< Number of days since the last pickup for this cargo (up to 255).
byte rating; byte rating; ///< Station rating for this cargo.
byte last_speed; byte last_speed; ///< Maximum speed of the last vehicle that picked up this cargo (up to 255).
byte last_age; byte last_age; ///< Age in years of the last vehicle that picked up this cargo.
byte amount_fract; ///< Fractional part of the amount in the cargo list byte amount_fract; ///< Fractional part of the amount in the cargo list
StationCargoList cargo; ///< The cargo packets of cargo waiting in this station StationCargoList cargo; ///< The cargo packets of cargo waiting in this station
}; };