cpp/openttd-patchpack/source Changeset - r17472:0c79f01bb563

Changeset - r17472:0c79f01bb563

Parent rev.

Child rev.

[Not reviewed]

master

0 1 0

alberth - 14 years ago 2011-03-13 13:49:31
alberth@openttd.org

(svn r22237) -Doc: Add some doxyments to structs and enums in engine_type.h

1 file changed with 17 insertions and 9 deletions:

src/engine_type.h

0 comments (0 inline, 0 general)

src/engine_type.h

➞

Show inline comments

@@ @@ -19,24 +19,27 @@ @@
 #include "sound_type.h"
 #include "strings_type.h"
 typedef uint16 EngineID;
+typedef uint16 EngineID; ///< Unique identification number of an engine.
 struct Engine;
 /** Available types of rail vehicles. */
 enum RailVehicleTypes {
 	RAILVEH_SINGLEHEAD,  ///< indicates a "standalone" locomotive
 	RAILVEH_MULTIHEAD,   ///< indicates a combination of two locomotives
 	RAILVEH_WAGON,       ///< simple wagon, not motorized
 };
 /** Type of rail engine. */
 enum EngineClass {
 	EC_STEAM,
 	EC_DIESEL,
 	EC_ELECTRIC,
 	EC_MONORAIL,
 	EC_MAGLEV,
 	EC_STEAM,    ///< Steam rail engine.
 	EC_DIESEL,   ///< Diesel rail engine.
 	EC_ELECTRIC, ///< Electric rail engine.
 	EC_MONORAIL, ///< Mono rail engine.
 	EC_MAGLEV,   ///< Maglev engine.
 };
 /** Information about a rail vehicle. */
 struct RailVehicleInfo {
 	byte image_index;
 	RailVehicleTypes railveh_type;
@@ @@ -59,6 +62,7 @@ struct RailVehicleInfo { @@
 	byte user_def_data;             ///< Property 0x25: "User-defined bit mask" Used only for (very few) NewGRF vehicles
 };
 /** Information about a ship vehicle. */
 struct ShipVehicleInfo {
 	byte image_index;
 	byte cost_factor;
@@ @@ -70,15 +74,18 @@ struct ShipVehicleInfo { @@
 	byte visual_effect;    ///< Bitstuffed NewGRF visual effect data
 };
 /* AircraftVehicleInfo subtypes, bitmask type.
 /**
  * AircraftVehicleInfo subtypes, bitmask type.
  * If bit 0 is 0 then it is a helicopter, otherwise it is a plane
  * in which case bit 1 tells us whether it's a big(fast) plane or not */
  * in which case bit 1 tells us whether it's a big(fast) plane or not.
  */
 enum AircraftSubTypeBits {
 	AIR_HELI = 0,
 	AIR_CTOL = 1, ///< Conventional Take Off and Landing, i.e. planes
 	AIR_FAST = 2
 };
 /** Information about a aircraft vehicle. */
 struct AircraftVehicleInfo {
 	byte image_index;
 	byte cost_factor;
@@ @@ -91,6 +98,7 @@ struct AircraftVehicleInfo { @@
 	uint16 passenger_capacity;
 };
 /** Information about a road vehicle. */
 struct RoadVehicleInfo {
 	byte image_index;
 	byte cost_factor;
@@ @@ -150,6 +158,6 @@ static const uint NUM_VEHICLE_TYPES @@
 static const uint MAX_LENGTH_ENGINE_NAME_CHARS  =  32; ///< The maximum length of an engine name in characters including '\0'
 static const uint MAX_LENGTH_ENGINE_NAME_PIXELS = 160; ///< The maximum length of an engine name in pixels
 static const EngineID INVALID_ENGINE = 0xFFFF;
+static const EngineID INVALID_ENGINE = 0xFFFF; ///< Constant denoting an invalid engine.
 #endif /* ENGINE_TYPE_H */

0 comments (0 inline, 0 general)