(svn r8853) -Cleanup: doxygen changes. Correct forgotten c files to cpp files with the @file tag as well as a few general comments style

This commit is contained in:
belugas 2007-02-23 01:48:53 +00:00
parent 202702c007
commit a723770836
27 changed files with 211 additions and 185 deletions

View File

@ -1,5 +1,7 @@
/* $Id$ */
/** @file aircraft_cmd.h */
#ifndef AIRCRAFT_H
#define AIRCRAFT_H

View File

@ -1,5 +1,8 @@
/* $Id$ */
/** @file aircraft_cmd.cpp
* This file deals with aircraft and airport movements functionalities */
#include "stdafx.h"
#include "openttd.h"
#include "aircraft.h"

View File

@ -1,5 +1,7 @@
/* $Id$ */
/** @file aircraft_gui.cpp */
#include "stdafx.h"
#include "openttd.h"
#include "aircraft.h"

View File

@ -1,5 +1,7 @@
/* $Id$ */
/** @file airport.cpp */
#include "stdafx.h"
#include "openttd.h"
#include "debug.h"

View File

@ -1,5 +1,7 @@
/* $Id$ */
/** @file airport.h Various declarations for airports */
#ifndef AIRPORT_H
#define AIRPORT_H

View File

@ -1,5 +1,7 @@
/* $Id$ */
/** @file airport_gui.cpp */
#include "stdafx.h"
#include "openttd.h"
#include "table/sprites.h"

View File

@ -1,5 +1,7 @@
/* $Id$ */
/** @file airport_movement.h Heart of the airports and their finite state machines */
#ifndef AIRPORT_MOVEMENT_H
#define AIRPORT_MOVEMENT_H

View File

@ -1,5 +1,7 @@
/* $Id$ */
/** @file autoreplace_gui.cpp */
#include "stdafx.h"
#include "openttd.h"
#include "debug.h"

View File

@ -1,5 +1,7 @@
/* $Id$ */
/** @file aystar.cpp
/*
* This file has the core function for AyStar
* AyStar is a fast pathfinding routine and is used for things like

View File

@ -1,6 +1,6 @@
/* $Id$ */
/*
/** @file aystar.h
* This file has the header for AyStar
* AyStar is a fast pathfinding routine and is used for things like
* AI_pathfinding and Train_pathfinding.

View File

@ -1,6 +1,6 @@
/* $Id$ */
/** @file bridge_gui.c Graphical user interface for bridge construction*/
/** @file bridge_gui.cpp Graphical user interface for bridge construction */
#include "stdafx.h"
#include "openttd.h"

View File

@ -1,6 +1,6 @@
/* $Id$ */
/** @file
/** @file disaster_cmd.cpp
* All disaster/easter egg vehicles are handled here.
* The general flow of control for the disaster vehicles is as follows:
* <ol>

View File

@ -1,5 +1,5 @@
/* $Id$ */
/** @file elrail.c
/** @file elrail.cpp
* This file deals with displaying wires and pylons for electric railways.
* <h2>Basics</h2>
*

View File

@ -1,6 +1,6 @@
/* $Id$ */
/** @file fios.c
/** @file fios.cpp
* This file contains functions for building file lists for the save/load dialogs.
*/

View File

@ -1,7 +1,7 @@
/* $Id$ */
/**
* @file qtmidi.c
* @file qtmidi.cpp
* @brief MIDI music player for MacOS X using QuickTime.
*
* This music player should work in all MacOS X releases starting from 10.0,

View File

@ -1,6 +1,6 @@
/* $Id$ */
/** @file newgrf_station.c Functions for dealing with station classes and custom stations. */
/** @file newgrf_station.cpp Functions for dealing with station classes and custom stations. */
#include "stdafx.h"
#include "openttd.h"

View File

@ -1,6 +1,6 @@
/* $Id$ */
/** @file players.c
/** @file players.cpp
* @todo Cleanup the messy DrawPlayerFace function asap
*/
#include "stdafx.h"

View File

@ -1,6 +1,6 @@
/* $Id$ */
/** @file rail_gui.c File for dealing with rail construction user interface */
/** @file rail_gui.cpp File for dealing with rail construction user interface */
#include "stdafx.h"
#include "openttd.h"

View File

@ -1,6 +1,6 @@
/* $Id$ */
/** @file
/** @file saveload.cpp
* All actions handling saving and loading goes on in this file. The general actions
* are as follows for saving a game (loading is analogous):
* <ol>
@ -12,8 +12,6 @@
* <li>when the buffer is full; flush it to the output (eg save to file) (_sl.buf, _sl.bufp, _sl.bufe)
* <li>repeat this until everything is done, and flush any remaining output to file
* </ol>
* @see ChunkHandler
* @see SaveLoad
*/
#include "stdafx.h"
#include "openttd.h"
@ -31,43 +29,43 @@
#include <setjmp.h>
extern const uint16 SAVEGAME_VERSION = 47;
uint16 _sl_version; /// the major savegame version identifier
byte _sl_minor_version; /// the minor savegame version, DO NOT USE!
uint16 _sl_version; ///< the major savegame version identifier
byte _sl_minor_version; ///< the minor savegame version, DO NOT USE!
typedef void WriterProc(uint len);
typedef uint ReaderProc(void);
/** The saveload struct, containing reader-writer functions, bufffer, version, etc. */
static struct {
bool save; /// are we doing a save or a load atm. True when saving
byte need_length; /// ???
byte block_mode; /// ???
bool error; /// did an error occur or not
bool save; ///< are we doing a save or a load atm. True when saving
byte need_length; ///< ???
byte block_mode; ///< ???
bool error; ///< did an error occur or not
int obj_len; /// the length of the current object we are busy with
int array_index, last_array_index; /// in the case of an array, the current and last positions
int obj_len; ///< the length of the current object we are busy with
int array_index, last_array_index; ///< in the case of an array, the current and last positions
uint32 offs_base; /// the offset in number of bytes since we started writing data (eg uncompressed savegame size)
uint32 offs_base; ///< the offset in number of bytes since we started writing data (eg uncompressed savegame size)
WriterProc *write_bytes; /// savegame writer function
ReaderProc *read_bytes; /// savegame loader function
WriterProc *write_bytes; ///< savegame writer function
ReaderProc *read_bytes; ///< savegame loader function
const ChunkHandler* const *chs; /// the chunk of data that is being processed atm (vehicles, signs, etc.)
const SaveLoad* const *includes; /// the internal layouf of the given chunk
const ChunkHandler* const *chs; ///< the chunk of data that is being processed atm (vehicles, signs, etc.)
const SaveLoad* const *includes; ///< the internal layouf of the given chunk
/** When saving/loading savegames, they are always saved to a temporary memory-place
/* When saving/loading savegames, they are always saved to a temporary memory-place
* to be flushed to file (save) or to final place (load) when full. */
byte *bufp, *bufe; /// bufp(ointer) gives the current position in the buffer bufe(nd) gives the end of the buffer
byte *bufp, *bufe; ///< bufp(ointer) gives the current position in the buffer bufe(nd) gives the end of the buffer
// these 3 may be used by compressor/decompressors.
byte *buf; /// pointer to temporary memory to read/write, initialized by SaveLoadFormat->initread/write
byte *buf_ori; /// pointer to the original memory location of buf, used to free it afterwards
uint bufsize; /// the size of the temporary memory *buf
FILE *fh; /// the file from which is read or written to
/* these 3 may be used by compressor/decompressors. */
byte *buf; ///< pointer to temporary memory to read/write, initialized by SaveLoadFormat->initread/write
byte *buf_ori; ///< pointer to the original memory location of buf, used to free it afterwards
uint bufsize; ///< the size of the temporary memory *buf
FILE *fh; ///< the file from which is read or written to
void (*excpt_uninit)(void); /// the function to execute on any encountered error
const char *excpt_msg; /// the error message
jmp_buf excpt; /// @todo used to jump to "exception handler"; really ugly
void (*excpt_uninit)(void); ///< the function to execute on any encountered error
const char *excpt_msg; ///< the error message
jmp_buf excpt; ///< @todo used to jump to "exception handler"; really ugly
} _sl;
@ -89,8 +87,8 @@ static void SlReadFill(void)
static inline uint32 SlGetOffs(void) {return _sl.offs_base - (_sl.bufe - _sl.bufp);}
/** Return the size in bytes of a certain type of normal/atomic variable
* as it appears in memory. @see VarTypes
* @param conv @VarType type of variable that is used for calculating the size
* as it appears in memory. See VarTypes
* @param conv VarType type of variable that is used for calculating the size
* @return Return the size of this type in bytes */
static inline byte SlCalcConvMemLen(VarType conv)
{
@ -101,8 +99,8 @@ static inline byte SlCalcConvMemLen(VarType conv)
}
/** Return the size in bytes of a certain type of normal/atomic variable
* as it appears in a saved game. @see VarTypes
* @param conv @VarType type of variable that is used for calculating the size
* as it appears in a saved game. See VarTypes
* @param conv VarType type of variable that is used for calculating the size
* @return Return the size of this type in bytes */
static inline byte SlCalcConvFileLen(VarType conv)
{
@ -112,7 +110,7 @@ static inline byte SlCalcConvFileLen(VarType conv)
return conv_file_size[length];
}
/* Return the size in bytes of a reference (pointer) */
/** Return the size in bytes of a reference (pointer) */
static inline size_t SlCalcRefLen(void) {return 2;}
/** Flush the output buffer by writing to disk with the given reader.
@ -121,7 +119,7 @@ static inline size_t SlCalcRefLen(void) {return 2;}
*/
static void SlWriteFill(void)
{
// flush the buffer to disk (the writer)
/* flush the buffer to disk (the writer) */
if (_sl.bufp != NULL) {
uint len = _sl.bufp - _sl.buf;
_sl.offs_base += len;
@ -129,7 +127,7 @@ static void SlWriteFill(void)
}
/* All the data from the buffer has been written away, rewind to the beginning
* to start reading in more data */
* to start reading in more data */
_sl.bufp = _sl.buf;
_sl.bufe = _sl.buf + _sl.bufsize;
}
@ -333,9 +331,9 @@ void SlSetLength(size_t length)
_sl.need_length = NL_NONE;
switch (_sl.block_mode) {
case CH_RIFF:
// Ugly encoding of >16M RIFF chunks
// The lower 24 bits are normal
// The uppermost 4 bits are bits 24:27
/* Ugly encoding of >16M RIFF chunks
* The lower 24 bits are normal
* The uppermost 4 bits are bits 24:27 */
assert(length < (1<<28));
SlWriteUint32((length & 0xFFFFFF) | ((length >> 24) << 28));
break;
@ -439,13 +437,13 @@ void WriteValue(void *ptr, VarType conv, int64 val)
* and then write them to file, endian safely. Loading a value
* goes exactly the opposite way
* @param ptr The object being filled/read
* @param conv @VarType type of the current element of the struct
* @param conv VarType type of the current element of the struct
*/
static void SlSaveLoadConv(void *ptr, VarType conv)
{
int64 x = 0;
if (_sl.save) { /* SAVE values */
if (_sl.save) { // SAVE values
/* Read a value from the struct. These ARE endian safe. */
x = ReadValue(ptr, conv);
@ -462,7 +460,7 @@ static void SlSaveLoadConv(void *ptr, VarType conv)
case SLE_FILE_U64: SlWriteUint64(x);break;
default: NOT_REACHED();
}
} else { /* LOAD values */
} else { // LOAD values
/* Read a value from the file */
switch (GetVarFileType(conv)) {
@ -533,7 +531,7 @@ static void SlString(void *ptr, size_t length, VarType conv)
{
size_t len;
if (_sl.save) { /* SAVE string */
if (_sl.save) { // SAVE string
switch (GetVarMemType(conv)) {
default: NOT_REACHED();
case SLE_VAR_STRB:
@ -549,7 +547,7 @@ static void SlString(void *ptr, size_t length, VarType conv)
SlWriteArrayLength(len);
SlCopyBytes(ptr, len);
} else { /* LOAD string */
} else { // LOAD string
len = SlReadArrayLength();
switch (GetVarMemType(conv)) {
@ -566,7 +564,7 @@ static void SlString(void *ptr, size_t length, VarType conv)
}
break;
case SLE_VAR_STR:
case SLE_VAR_STRQ: /* Malloc'd string, free previous incarnation, and allocate */
case SLE_VAR_STRQ: // Malloc'd string, free previous incarnation, and allocate
free(*(char**)ptr);
*(char**)ptr = (char*)malloc(len + 1); // terminating '\0'
ptr = *(char**)ptr;
@ -581,7 +579,7 @@ static void SlString(void *ptr, size_t length, VarType conv)
/**
* Return the size in bytes of a certain type of atomic array
* @param length The length of the array counted in elements
* @param conv @VarType type of the variable that is used in calculating the size
* @param conv VarType type of the variable that is used in calculating the size
*/
static inline size_t SlCalcArrayLen(uint length, VarType conv)
{
@ -592,14 +590,14 @@ static inline size_t SlCalcArrayLen(uint length, VarType conv)
* Save/Load an array.
* @param array The array being manipulated
* @param length The length of the array in elements
* @param conv @VarType type of the atomic array (int, byte, uint64, etc.)
* @param conv VarType type of the atomic array (int, byte, uint64, etc.)
*/
void SlArray(void *array, uint length, VarType conv)
{
// Automatically calculate the length?
/* Automatically calculate the length? */
if (_sl.need_length != NL_NONE) {
SlSetLength(SlCalcArrayLen(length, conv));
// Determine length only?
/* Determine length only? */
if (_sl.need_length == NL_CALCLENGTH) return;
}
@ -628,7 +626,7 @@ void SlArray(void *array, uint length, VarType conv)
}
}
/* Are we going to save this object or not? */
/** Are we going to save this object or not? */
static inline bool SlIsObjectValidInSavegame(const SaveLoad *sld)
{
if (_sl_version < sld->version_from || _sl_version > sld->version_to) return false;
@ -652,13 +650,13 @@ static inline bool SlSkipVariableOnLoad(const SaveLoad *sld)
/**
* Calculate the size of an object.
* @param sld The @SaveLoad description of the object so we know how to manipulate it
* @param sld The SaveLoad description of the object so we know how to manipulate it
*/
static size_t SlCalcObjLength(const void *object, const SaveLoad *sld)
{
size_t length = 0;
// Need to determine the length and write a length tag.
/* Need to determine the length and write a length tag. */
for (; sld->cmd != SL_END; sld++) {
length += SlCalcObjMemberLength(object, sld);
}
@ -711,8 +709,8 @@ bool SlObjectMember(void *ptr, const SaveLoad *sld)
switch (sld->cmd) {
case SL_VAR: SlSaveLoadConv(ptr, conv); break;
case SL_REF: /* Reference variable, translate */
/// @todo XXX - another artificial limitof 65K elements of pointers?
case SL_REF: // Reference variable, translate
/* @todo XXX - another artificial limitof 65K elements of pointers? */
if (_sl.save) { // XXX - read/write pointer as uint16? What is with higher indeces?
SlWriteUint16(ReferenceToInt(*(void**)ptr, (SLRefType)conv));
} else {
@ -726,10 +724,10 @@ bool SlObjectMember(void *ptr, const SaveLoad *sld)
break;
/* SL_WRITEBYTE translates a value of a variable to another one upon
* saving or loading.
* XXX - variable renaming abuse
* game_value: the value of the variable ingame is abused by sld->version_from
* file_value: the value of the variable in the savegame is abused by sld->version_to */
* saving or loading.
* XXX - variable renaming abuse
* game_value: the value of the variable ingame is abused by sld->version_from
* file_value: the value of the variable in the savegame is abused by sld->version_to */
case SL_WRITEBYTE:
if (_sl.save) {
SlWriteByte(sld->version_to);
@ -752,11 +750,11 @@ bool SlObjectMember(void *ptr, const SaveLoad *sld)
/**
* Main SaveLoad function.
* @param object The object that is being saved or loaded
* @param sld The @SaveLoad description of the object so we know how to manipulate it
* @param sld The SaveLoad description of the object so we know how to manipulate it
*/
void SlObject(void *object, const SaveLoad *sld)
{
// Automatically calculate the length?
/* Automatically calculate the length? */
if (_sl.need_length != NL_NONE) {
SlSetLength(SlCalcObjLength(object, sld));
if (_sl.need_length == NL_CALCLENGTH) return;
@ -795,18 +793,18 @@ void SlAutolength(AutolengthProc *proc, void *arg)
assert(_sl.save);
// Tell it to calculate the length
/* Tell it to calculate the length */
_sl.need_length = NL_CALCLENGTH;
_sl.obj_len = 0;
proc(arg);
// Setup length
/* Setup length */
_sl.need_length = NL_WANTLENGTH;
SlSetLength(_sl.obj_len);
offs = SlGetOffs() + _sl.obj_len;
// And write the stuff
/* And write the stuff */
proc(arg);
assert(offs == SlGetOffs());
@ -835,7 +833,7 @@ static void SlLoadChunk(const ChunkHandler *ch)
break;
default:
if ((m & 0xF) == CH_RIFF) {
// Read length
/* Read length */
len = (SlReadByte() << 16) | ((m >> 4) << 24);
len += SlReadUint16();
_sl.obj_len = len;
@ -866,7 +864,7 @@ static void SlSaveChunk(const ChunkHandler *ch)
DEBUG(sl, 2, "Saving chunk %c%c%c%c", ch->id >> 24, ch->id >> 16, ch->id >> 8, ch->id);
if (ch->flags & CH_AUTO_LENGTH) {
// Need to calculate the length. Solve that by calling SlAutoLength in the save_proc.
/* Need to calculate the length. Solve that by calling SlAutoLength in the save_proc. */
_tmp_proc_1 = proc;
proc = SlStubSaveProc;
}
@ -911,7 +909,7 @@ static void SlSaveChunks(void)
}
}
// Terminator
/* Terminator */
SlWriteUint32(0);
}
@ -949,9 +947,9 @@ static void SlLoadChunks(void)
}
}
//*******************************************
//********** START OF LZO CODE **************
//*******************************************
/*******************************************
********** START OF LZO CODE **************
*******************************************/
#define LZO_SIZE 8192
#include "minilzo.h"
@ -963,10 +961,10 @@ static uint ReadLZO(void)
uint32 size;
uint len;
// Read header
/* Read header*/
if (fread(tmp, sizeof(tmp), 1, _sl.fh) != 1) SlError("file read failed");
// Check if size is bad
/* Check if size is bad */
((uint32*)out)[0] = size = tmp[1];
if (_sl_version != 0) {
@ -976,19 +974,19 @@ static uint ReadLZO(void)
if (size >= sizeof(out)) SlError("inconsistent size");
// Read block
/* Read block */
if (fread(out + sizeof(uint32), size, 1, _sl.fh) != 1) SlError("file read failed");
// Verify checksum
/* Verify checksum */
if (tmp[0] != lzo_adler32(0, out, size + sizeof(uint32))) SlError("bad checksum");
// Decompress
/* Decompress */
lzo1x_decompress(out + sizeof(uint32)*1, size, _sl.buf, &len, NULL);
return len;
}
// p contains the pointer to the buffer, len contains the pointer to the length.
// len bytes will be written, p and l will be updated to reflect the next buffer.
/* p contains the pointer to the buffer, len contains the pointer to the length.
* len bytes will be written, p and l will be updated to reflect the next buffer. */
static void WriteLZO(uint size)
{
byte out[LZO_SIZE + LZO_SIZE / 64 + 16 + 3 + 8];
@ -1013,9 +1011,9 @@ static void UninitLZO(void)
free(_sl.buf_ori);
}
//*********************************************
//******** START OF NOCOMP CODE (uncompressed)*
//*********************************************
/*********************************************
******** START OF NOCOMP CODE (uncompressed)*
*********************************************/
static uint ReadNoComp(void)
{
return fread(_sl.buf, 1, LZO_SIZE, _sl.fh);
@ -1038,9 +1036,9 @@ static void UninitNoComp(void)
free(_sl.buf_ori);
}
//********************************************
//********** START OF MEMORY CODE (in ram)****
//********************************************
/********************************************
********** START OF MEMORY CODE (in ram)****
********************************************/
#include "table/strings.h"
#include "table/sprites.h"
@ -1084,9 +1082,9 @@ static void WriteMem(uint size)
_sl.buf = GetSavegame(_ts.count);
}
//********************************************
//********** START OF ZLIB CODE **************
//********************************************
/********************************************
********** START OF ZLIB CODE **************
********************************************/
#if defined(WITH_ZLIB)
#include <zlib.h>
@ -1111,12 +1109,12 @@ static uint ReadZlib(void)
_z.avail_out = 4096;
do {
// read more bytes from the file?
/* read more bytes from the file?*/
if (_z.avail_in == 0) {
_z.avail_in = fread(_z.next_in = _sl.buf + 4096, 1, 4096, _sl.fh);
}
// inflate the data
/* inflate the data */
r = inflate(&_z, 0);
if (r == Z_STREAM_END)
break;
@ -1155,7 +1153,7 @@ static void WriteZlibLoop(z_streamp z, byte *p, uint len, int mode)
z->next_out = buf;
z->avail_out = sizeof(buf);
r = deflate(z, mode);
// bytes were emitted?
/* bytes were emitted? */
if ((n=sizeof(buf) - z->avail_out) != 0) {
if (fwrite(buf, n, 1, _sl.fh) != 1) SlError("file write error");
}
@ -1172,7 +1170,7 @@ static void WriteZlib(uint len)
static void UninitWriteZlib(void)
{
// flush any pending output.
/* flush any pending output. */
if (_sl.fh) WriteZlibLoop(&_z, NULL, 0, Z_FINISH);
deflateEnd(&_z);
free(_sl.buf_ori);
@ -1180,11 +1178,11 @@ static void UninitWriteZlib(void)
#endif /* WITH_ZLIB */
//*******************************************
//************* END OF CODE *****************
//*******************************************
/*******************************************
************* END OF CODE *****************
*******************************************/
// these define the chunks
/* these define the chunks */
extern const ChunkHandler _misc_chunk_handlers[];
extern const ChunkHandler _setting_chunk_handlers[];
extern const ChunkHandler _player_chunk_handlers[];
@ -1220,7 +1218,7 @@ static const ChunkHandler * const _chunk_handlers[] = {
NULL,
};
// used to include a vehicle desc in another desc.
/* used to include a vehicle desc in another desc. */s
extern const SaveLoad _common_veh_desc[];
static const SaveLoad* const _desc_includes[] = {
_common_veh_desc
@ -1233,7 +1231,7 @@ static const SaveLoad* const _desc_includes[] = {
* Remember that a NULL item has value 0, and all
* indeces have +1, so vehicle 0 is saved as index 1.
* @param obj The object that we want to get the index of
* @param rt @SLRefType type of the object the index is being sought of
* @param rt SLRefType type of the object the index is being sought of
* @return Return the pointer converted to an index of the type pointed to
*/
static uint ReferenceToInt(const void *obj, SLRefType rt)
@ -1261,7 +1259,7 @@ static uint ReferenceToInt(const void *obj, SLRefType rt)
* Remember that an index of 0 is a NULL pointer so all indeces
* are +1 so vehicle 0 is saved as 1.
* @param index The index that is being converted to a pointer
* @param rt @SLRefType type of the object the pointer is sought of
* @param rt SLRefType type of the object the pointer is sought of
* @return Return the index converted to a pointer of any type
*/
static void *IntToReference(uint index, SLRefType rt)
@ -1329,16 +1327,16 @@ static void *IntToReference(uint index, SLRefType rt)
/** The format for a reader/writer type of a savegame */
typedef struct {
const char *name; /// name of the compressor/decompressor (debug-only)
uint32 tag; /// the 4-letter tag by which it is identified in the savegame
const char *name; ///< name of the compressor/decompressor (debug-only)
uint32 tag; ///< the 4-letter tag by which it is identified in the savegame
bool (*init_read)(void); /// function executed upon initalization of the loader
ReaderProc *reader; /// function that loads the data from the file
void (*uninit_read)(void); /// function executed when reading is finished
bool (*init_read)(void); ///< function executed upon initalization of the loader
ReaderProc *reader; ///< function that loads the data from the file
void (*uninit_read)(void); ///< function executed when reading is finished
bool (*init_write)(void); /// function executed upon intialization of the saver
WriterProc *writer; /// function that saves the data to the file
void (*uninit_write)(void); /// function executed when writing is done
bool (*init_write)(void); ///< function executed upon intialization of the saver
WriterProc *writer; ///< function that saves the data to the file
void (*uninit_write)(void); ///< function executed when writing is done
} SaveLoadFormat;
static const SaveLoadFormat _saveload_formats[] = {
@ -1356,13 +1354,13 @@ static const SaveLoadFormat _saveload_formats[] = {
* Return the savegameformat of the game. Whether it was create with ZLIB compression
* uncompressed, or another type
* @param s Name of the savegame format. If NULL it picks the first available one
* @return Pointer to @SaveLoadFormat struct giving all characteristics of this type of savegame
* @return Pointer to SaveLoadFormat struct giving all characteristics of this type of savegame
*/
static const SaveLoadFormat *GetSavegameFormat(const char *s)
{
const SaveLoadFormat *def = endof(_saveload_formats) - 1;
// find default savegame format, the highest one with which files can be written
/* find default savegame format, the highest one with which files can be written */
while (!def->init_write) def--;
if (s != NULL && s[0] != '\0') {
@ -1377,7 +1375,7 @@ static const SaveLoadFormat *GetSavegameFormat(const char *s)
return def;
}
// actual loader/saver function
/* actual loader/saver function */
void InitializeGame(int mode, uint size_x, uint size_y);
extern bool AfterLoadGame(void);
extern void BeforeSaveGame(void);
@ -1509,7 +1507,7 @@ SaveOrLoadResult SaveOrLoad(const char *filename, int mode)
/* An instance of saving is already active, so don't go saving again */
if (_ts.saveinprogress && mode == SL_SAVE) {
// if not an autosave, but a user action, show error message
/* if not an autosave, but a user action, show error message */
if (!_do_autosave) ShowErrorMessage(INVALID_STRING_ID, STR_SAVE_STILL_IN_PROGRESS, 0, 0);
return SL_OK;
}
@ -1541,7 +1539,7 @@ SaveOrLoadResult SaveOrLoad(const char *filename, int mode)
if (setjmp(_sl.excpt)) {
AbortSaveLoad();
// deinitialize compressor.
/* deinitialize compressor. */
_sl.excpt_uninit();
/* A saver/loader exception!! reinitialize all variables to prevent crash! */
@ -1590,7 +1588,7 @@ SaveOrLoadResult SaveOrLoad(const char *filename, int mode)
return AbortSaveLoad();
}
// see if we have any loader for this type.
/* see if we have any loader for this type. */
for (fmt = _saveload_formats; ; fmt++) {
/* No loader found, treat as version 0 and use LZO format */
if (fmt == endof(_saveload_formats)) {
@ -1609,12 +1607,12 @@ SaveOrLoadResult SaveOrLoad(const char *filename, int mode)
}
if (fmt->tag == hdr[0]) {
// check version number
/* check version number */
_sl_version = TO_BE32(hdr[1]) >> 16;
/* Minor is not used anymore from version 18.0, but it is still needed
* in versions before that (4 cases) which can't be removed easy.
* Therefor it is loaded, but never saved (or, it saves a 0 in any scenario).
* So never EVER use this minor version again. -- TrueLight -- 22-11-2005 */
* in versions before that (4 cases) which can't be removed easy.
* Therefor it is loaded, but never saved (or, it saves a 0 in any scenario).
* So never EVER use this minor version again. -- TrueLight -- 22-11-2005 */
_sl_minor_version = (TO_BE32(hdr[1]) >> 8) & 0xFF;
DEBUG(sl, 1, "Loading savegame version %d", _sl_version);
@ -1631,7 +1629,7 @@ SaveOrLoadResult SaveOrLoad(const char *filename, int mode)
_sl.read_bytes = fmt->reader;
_sl.excpt_uninit = fmt->uninit_read;
// loader for this savegame type is not implemented?
/* loader for this savegame type is not implemented? */
if (fmt->init_read == NULL) {
ShowInfoF("Loader for '%s' is not available.", fmt->name);
return AbortSaveLoad();
@ -1686,7 +1684,7 @@ int GetSavegameType(char *file)
DEBUG(sl, 0, "Savegame is obsolete or invalid format");
mode = SL_LOAD; // don't try to get filename, just show name as it is written
} else {
// see if we have any loader for this type.
/* see if we have any loader for this type. */
for (fmt = _saveload_formats; fmt != endof(_saveload_formats); fmt++) {
if (fmt->tag == hdr) {
mode = SL_LOAD; // new type of savegame

View File

@ -1,6 +1,6 @@
/* $Id$ */
/** @file station_cmd.c */
/** @file station_cmd.cpp */
#include "stdafx.h"
#include "openttd.h"

View File

@ -1,6 +1,6 @@
/* $Id$ */
/** @file station_cmd.c */
/** @file station_cmd.cpp */
#include "stdafx.h"
#include "openttd.h"

View File

@ -1,6 +1,6 @@
/* $Id$ */
/** @file tunnelbridge_cmd.c
/** @file tunnelbridge_cmd.cpp
* This file deals with tunnels and bridges (non-gui stuff)
* @todo seperate this file into two
*/

View File

@ -1,5 +1,7 @@
/* $Id$ */
/** @file viewport.cpp */
#include "stdafx.h"
#include "openttd.h"
#include "debug.h"
@ -23,7 +25,6 @@
#define VIEWPORT_DRAW_MEM (65536 * 2)
/* viewport.c */
// XXX - maximum viewports is maximum windows - 2 (main toolbar + status bar)
static ViewPort _viewports[25 - 2];
static uint32 _active_viewports; ///< bitmasked variable where each bit signifies if a viewport is in use or not

View File

@ -1,5 +1,7 @@
/* $Id$ */
/** @file win32.cpp Implementation of MS Windows system calls */
#include "stdafx.h"
#include "hal.h"
#include "openttd.h"

View File

@ -1,5 +1,7 @@
/* $Id$ */
/** @file win32.h declarations of functions for MS windows systems */
#ifndef WIN32_H
#define WIN32_H

View File

@ -1,5 +1,7 @@
/* $Id$ */
/** @file window.cpp windowing system, widgets and events */
#include "stdafx.h"
#include <stdarg.h>
#include "openttd.h"

View File

@ -1,5 +1,7 @@
/* $Id$ */
/** @file window.h regroups declarations for all windowing system, as well as a few helper functions */
#ifndef WINDOW_H
#define WINDOW_H
@ -59,9 +61,9 @@ typedef enum ResizeFlags {
* They are used in the same place as the above RESIZE_x flags, Widget visual_flags.
* These states are used in exceptions. If nothing is specified, they will indicate
* Enabled, visible or unclicked widgets*/
WIDG_DISABLED = 4, // widget is greyed out, not available
WIDG_HIDDEN = 5, // widget is made invisible
WIDG_LOWERED = 6, // widget is paint lowered, a pressed button in fact
WIDG_DISABLED = 4, ///< widget is greyed out, not available
WIDG_HIDDEN = 5, ///< widget is made invisible
WIDG_LOWERED = 6, ///< widget is paint lowered, a pressed button in fact
} ResizeFlag;
/* used to indicate the end of widgets' list for vararg functions */
@ -70,8 +72,8 @@ enum {
};
typedef struct Widget {
byte type; ///< Widget type, see @WindowWidgetTypes
byte display_flags; ///< Resize direction, alignment, etc. during resizing, see @ResizeFlags
byte type; ///< Widget type, see WindowWidgetTypes
byte display_flags; ///< Resize direction, alignment, etc. during resizing, see ResizeFlags
byte color; ///< Widget colour, see docs/ottd-colourtext-palette.png
int16 left, right, top, bottom; ///< The position offsets inside the window
uint16 data; ///< The String/Image or special code (list-matrixes) of a widget
@ -164,23 +166,23 @@ struct WindowEvent {
} mouseover;
struct {
bool cont; // continue the search? (default true)
uint16 key; // 16-bit Unicode value of the key
uint16 keycode;// untranslated key (including shift-state)
bool cont; ///< continue the search? (default true)
uint16 key; ///< 16-bit Unicode value of the key
uint16 keycode; ///< untranslated key (including shift-state)
} keypress;
struct {
int msg; // message to be sent
int wparam; // additional message-specific information
int lparam; // additional message-specific information
int msg; ///< message to be sent
int wparam; ///< additional message-specific information
int lparam; ///< additional message-specific information
} message;
struct {
Point delta; // delta position against position of last call
Point delta; ///< delta position against position of last call
} scroll;
struct {
int wheel; // how much was 'wheel'd'
int wheel; ///< how much was 'wheel'd'
} wheel;
} we;
};
@ -195,14 +197,14 @@ typedef struct WindowDesc {
} WindowDesc;
enum WindowDefaultFlag {
WDF_STD_TOOLTIPS = 1, /* use standard routine when displaying tooltips */
WDF_DEF_WIDGET = 2, /* default widget control for some widgets in the on click event */
WDF_STD_BTN = 4, /* default handling for close and drag widgets (widget no 0 and 1) */
WDF_STD_TOOLTIPS = 1, ///< use standard routine when displaying tooltips
WDF_DEF_WIDGET = 2, ///< default widget control for some widgets in the on click event
WDF_STD_BTN = 4, ///< default handling for close and drag widgets (widget no 0 and 1)
WDF_UNCLICK_BUTTONS = 16, /* Unclick buttons when the window event times out */
WDF_STICKY_BUTTON = 32, /* Set window to sticky mode; they are not closed unless closed with 'X' (widget 2) */
WDF_RESIZABLE = 64, /* A window can be resized */
WDF_MODAL = 128, /* The window is a modal child of some other window, meaning the parent is 'inactive' */
WDF_UNCLICK_BUTTONS = 16, ///< Unclick buttons when the window event times out */
WDF_STICKY_BUTTON = 32, ///< Set window to sticky mode; they are not closed unless closed with 'X' (widget 2)
WDF_RESIZABLE = 64, ///< A window can be resized
WDF_MODAL = 128, ///< The window is a modal child of some other window, meaning the parent is 'inactive'
};
/* can be used as x or y coordinates to cause a specific placement */
@ -214,12 +216,12 @@ enum WindowDefaultPosition {
};
typedef struct Textbuf {
char *buf; /* buffer in which text is saved */
uint16 maxlength, maxwidth; /* the maximum size of the buffer. Maxwidth specifies screensize in pixels, maxlength is in bytes */
uint16 length, width; /* the current size of the string. Width specifies screensize in pixels, length is in bytes */
bool caret; /* is the caret ("_") visible or not */
uint16 caretpos; /* the current position of the caret in the buffer, in bytes */
uint16 caretxoffs; /* the current position of the caret in pixels */
char *buf; ///< buffer in which text is saved
uint16 maxlength, maxwidth; ///< the maximum size of the buffer. Maxwidth specifies screensize in pixels, maxlength is in bytes
uint16 length, width; ///< the current size of the string. Width specifies screensize in pixels, length is in bytes
bool caret; ///< is the caret ("_") visible or not
uint16 caretpos; ///< the current position of the caret in the buffer, in bytes
uint16 caretxoffs; ///< the current position of the caret in pixels
} Textbuf;
#define WP(ptr,str) (*(str*)(ptr)->custom)
@ -233,10 +235,10 @@ typedef struct Scrollbar {
} Scrollbar;
typedef struct ResizeInfo {
uint width; /* Minimum width and height */
uint width; ///< Minimum width and height
uint height;
uint step_width; /* In how big steps the width and height go */
uint step_width; ///< In how big steps the width and height go
uint step_height;
} ResizeInfo;
@ -281,12 +283,12 @@ typedef struct querystr_d {
assert_compile(WINDOW_CUSTOM_SIZE >= sizeof(querystr_d));
typedef struct {
byte item_count; /* follow_vehicle */
byte sel_index; /* scrollpos_x */
byte main_button; /* scrollpos_y */
byte item_count; ///< follow_vehicle
byte sel_index; ///< scrollpos_x
byte main_button; ///< scrollpos_y
byte action_id;
StringID string_id; /* unk30 */
uint16 checked_items; /* unk32 */
StringID string_id; ///< unk30
uint16 checked_items; ///< unk32
byte disabled_items;
} menu_d;
assert_compile(WINDOW_CUSTOM_SIZE >= sizeof(menu_d));
@ -323,7 +325,7 @@ typedef struct {
RailTypeByte railtype;
AirportFTAClass::Flags flags;
} filter;
byte sel_index; // deprecated value, used for 'unified' ship and road
byte sel_index; ///< deprecated value, used for 'unified' ship and road
bool descending_sort_order;
byte sort_criteria;
bool regenerate_list;
@ -337,7 +339,7 @@ typedef struct {
byte sel_index[2];
EngineID sel_engine[2];
uint16 count[2];
bool wagon_btnstate; // true means engine is selected
bool wagon_btnstate; ///< true means engine is selected
EngineList list[2];
bool update_left;
bool update_right;
@ -397,7 +399,7 @@ typedef struct {
} vp_d;
assert_compile(WINDOW_CUSTOM_SIZE >= sizeof(vp_d));
// vp2_d is the same as vp_d, except for the data_# values..
/* vp2_d is the same as vp_d, except for the data_# values.. */
typedef struct {
VehicleID follow_vehicle;
int32 scrollpos_x;
@ -430,24 +432,24 @@ assert_compile(WINDOW_CUSTOM_SIZE >= sizeof(scroller_d));
typedef enum SortListFlags {
VL_NONE = 0x00,
VL_DESC = 0x01, // sort descending or ascending
VL_RESORT = 0x02, // instruct the code to resort the list in the next loop
VL_REBUILD = 0x04, // create sort-listing to use for qsort and friends
VL_DESC = 0x01, ///< sort descending or ascending
VL_RESORT = 0x02, ///< instruct the code to resort the list in the next loop
VL_REBUILD = 0x04, ///< create sort-listing to use for qsort and friends
VL_END = 0x08
} SortListFlags;
DECLARE_ENUM_AS_BIT_SET(SortListFlags);
typedef struct Listing {
bool order; // Ascending/descending
byte criteria; // Sorting criteria
bool order; ///< Ascending/descending
byte criteria; ///< Sorting criteria
} Listing;
typedef struct list_d {
uint16 list_length; // length of the list being sorted
byte sort_type; // what criteria to sort on
SortListFlags flags; // used to control sorting/resorting/etc.
uint16 resort_timer; // resort list after a given amount of ticks if set
uint16 list_length; ///< length of the list being sorted
byte sort_type; ///< what criteria to sort on
SortListFlags flags; ///< used to control sorting/resorting/etc.
uint16 resort_timer; ///< resort list after a given amount of ticks if set
} list_d;
assert_compile(WINDOW_CUSTOM_SIZE >= sizeof(list_d));
@ -484,25 +486,25 @@ enum WindowWidgetBehaviours {
enum WindowWidgetTypes {
WWT_EMPTY,
WWT_PANEL, /* simple depressed panel */
WWT_INSET, /* pressed (inset) panel, most commonly used as combo box _text_ area */
WWT_IMGBTN, /* button with image */
WWT_IMGBTN_2, /* button with diff image when clicked */
WWT_PANEL, ///< simple depressed panel
WWT_INSET, ///< pressed (inset) panel, most commonly used as combo box _text_ area
WWT_IMGBTN, ///< button with image
WWT_IMGBTN_2, ///< button with diff image when clicked
WWT_TEXTBTN, /* button with text */
WWT_TEXTBTN_2, /* button with diff text when clicked */
WWT_LABEL, /* centered label */
WWT_TEXTBTN, ///< button with text
WWT_TEXTBTN_2, ///< button with diff text when clicked
WWT_LABEL, ///< centered label
WWT_MATRIX,
WWT_SCROLLBAR,
WWT_FRAME, /* frame */
WWT_FRAME, ///< frame
WWT_CAPTION,
WWT_HSCROLLBAR,
WWT_STICKYBOX,
WWT_SCROLL2BAR, /* 2nd vertical scrollbar*/
WWT_SCROLL2BAR, ///< 2nd vertical scrollbar
WWT_RESIZEBOX,
WWT_CLOSEBOX,
WWT_LAST, /* Last Item. use WIDGETS_END to fill up padding!! */
WWT_LAST, ///< Last Item. use WIDGETS_END to fill up padding!!
WWT_MASK = 0x1F,
@ -531,7 +533,7 @@ enum WindowFlags {
WF_SCROLL2 = 1 << 13,
};
/* window.c */
/* window.cpp */
void CallWindowEventNP(Window *w, int event);
void CallWindowTickEvent(void);
void SetWindowDirty(const Window *w);
@ -724,14 +726,14 @@ void CDECL SetWindowWidgetsDisabledState(Window *w, bool disab_stat, int widgets
void CDECL SetWindowWidgetsHiddenState(Window *w, bool hidden_stat, int widgets, ...);
void CDECL SetWindowWidgetsLoweredState(Window *w, bool lowered_stat, int widgets, ...);
/* misc_gui.c*/
/* misc_gui.cpp */
void GuiShowTooltipsWithArgs(StringID str, uint paramcount, const uint params[]);
static inline void GuiShowTooltips(StringID str)
{
GuiShowTooltipsWithArgs(str, 0, NULL);
}
/* widget.c */
/* widget.cpp */
int GetWidgetFromPos(const Window *w, int x, int y);
void DrawWindowWidgets(const Window *w);
void ShowDropDownMenu(Window *w, const StringID *strings, int selected, int button, uint32 disabled_mask, uint32 hidden_mask);
@ -745,7 +747,7 @@ void HideVitalWindows(void);
void ShowVitalWindows(void);
Window **FindWindowZPosition(const Window *w);
/* window.c */
/* window.cpp */
extern Window *_z_windows[];
extern Window **_last_z_window;
#define FOR_ALL_WINDOWS(wz) for (wz = _z_windows; wz != _last_z_window; wz++)