1

/* $Id$ */

     2

     3

/** @file fios.h Declarations for savegames operations */

     4

     5

#ifndef FIOS_H

     6

#define FIOS_H

     7

     8

#include "strings_type.h"

     9

    10

enum {

    11

	/**

    12

	 * Slot used for the GRF scanning and such. This slot cannot be reused

    13

	 * as it will otherwise cause issues when pressing "rescan directories".

    14

	 * It can furthermore not be larger than LAST_GRF_SLOT as that complicates

    15

	 * the testing for "too much NewGRFs".

    16

	 */

    17

	CONFIG_SLOT    =  0,

    18

	/** Slot for the sound. */

    19

	SOUND_SLOT     =  1,

    20

	/** First slot useable for (New)GRFs used during the game. */

    21

	FIRST_GRF_SLOT =  2,

    22

	/** Last slot useable for (New)GRFs used during the game. */

    23

	LAST_GRF_SLOT  = 63,

    24

	/** Maximum number of slots. */

    25

	MAX_FILE_SLOTS = 64

    26

};

    27

    28

enum SaveLoadDialogMode{

    29

	SLD_LOAD_GAME,

    30

	SLD_LOAD_SCENARIO,

    31

	SLD_SAVE_GAME,

    32

	SLD_SAVE_SCENARIO,

    33

	SLD_LOAD_HEIGHTMAP,

    34

	SLD_NEW_GAME,

    35

};

    36

    37

/* The different types of files been handled by the system */

    38

enum FileType {

    39

	FT_NONE,      ///< nothing to do

    40

	FT_SAVEGAME,  ///< old or new savegame

    41

	FT_SCENARIO,  ///< old or new scenario

    42

	FT_HEIGHTMAP, ///< heightmap file

    43

};

    44

    45

enum FiosType {

    46

	FIOS_TYPE_DRIVE,

    47

	FIOS_TYPE_PARENT,

    48

	FIOS_TYPE_DIR,

    49

	FIOS_TYPE_FILE,

    50

	FIOS_TYPE_OLDFILE,

    51

	FIOS_TYPE_SCENARIO,

    52

	FIOS_TYPE_OLD_SCENARIO,

    53

	FIOS_TYPE_DIRECT,

    54

	FIOS_TYPE_PNG,

    55

	FIOS_TYPE_BMP,

    56

	FIOS_TYPE_INVALID = 255,

    57

};

    58

    59

/* Deals with finding savegames */

    60

struct FiosItem {

    61

	FiosType type;

    62

	uint64 mtime;

    63

	char title[64];

    64

	char name[256 - 12 - 64];

    65

};

    66

    67

/* Deals with the type of the savegame, independent of extension */

    68

struct SmallFiosItem {

    69

	int mode;             ///< savegame/scenario type (old, new)

    70

	FileType filetype;    ///< what type of file are we dealing with

    71

	char name[MAX_PATH];  ///< name

    72

	char title[255];      ///< internal name of the game

    73

};

    74

    82

/* Variables to display file lists */

    83

extern FiosItem *_fios_list; ///< defined in misc_gui.cpp

    84

extern int _fios_num;        ///< defined in fios.cpp, read_only version of _fios_count

    85

extern SmallFiosItem _file_to_saveload;

    86

extern SaveLoadDialogMode _saveload_mode;   ///< defined in misc_gui.cpp

    88

    89

/* Launch save/load dialog */

    90

void ShowSaveLoadDialog(SaveLoadDialogMode mode);

    91

    92

/* Get a list of savegames */

    93

FiosItem *FiosGetSavegameList(SaveLoadDialogMode mode);

    94

/* Get a list of scenarios */

    95

FiosItem *FiosGetScenarioList(SaveLoadDialogMode mode);

    96

/* Get a list of Heightmaps */

    97

FiosItem *FiosGetHeightmapList(SaveLoadDialogMode mode);

    98

/* Free the list of savegames */

    99

void FiosFreeSavegameList();

   100

/* Browse to. Returns a filename w/path if we reached a file. */

   101

char *FiosBrowseTo(const FiosItem *item);

   102

/* Return path, free space and stringID */

   103

StringID FiosGetDescText(const char **path, uint32 *total_free);

   104

/* Delete a name */

   105

bool FiosDelete(const char *name);

   106

/* Make a filename from a name */

   107

void FiosMakeSavegameName(char *buf, const char *name, size_t size);

   108

/* Allocate a new FiosItem */

   109

FiosItem *FiosAlloc();

   110

   111

int CDECL compare_FiosItems(const void *a, const void *b);

   112

   113

/* Implementation of opendir/readdir/closedir for Windows */

   114

#if defined(WIN32)

   115

#include <windows.h>

   116

struct DIR;

   117

   118

struct dirent { // XXX - only d_name implemented

   119

	TCHAR *d_name; // name of found file

   120

	/* little hack which will point to parent DIR struct which will

   121

	 * save us a call to GetFileAttributes if we want information

   122

	 * about the file (for example in function fio_bla) */

   123

	DIR *dir;

   124

};

   125

   126

struct DIR {

   127

	HANDLE hFind;

   128

	/* the dirent returned by readdir.

   129

	 * note: having only one global instance is not possible because

   130

	 * multiple independent opendir/readdir sequences must be supported. */

   131

	dirent ent;

   132

	WIN32_FIND_DATA fd;

   133

	/* since opendir calls FindFirstFile, we need a means of telling the

   134

	 * first call to readdir that we already have a file.

   135

	 * that's the case iff this is true */

   136

	bool at_first_entry;

   137

};

   138

   139

DIR *opendir(const TCHAR *path);

   140

struct dirent *readdir(DIR *d);

   141

int closedir(DIR *d);

   142

#else

   143

/* Use system-supplied opendir/readdir/closedir functions */

   144

# include <sys/types.h>

   145

# include <dirent.h>

   146

#endif /* defined(WIN32) */

   147

   148

/**

   149

 * A wrapper around opendir() which will convert the string from

   150

 * OPENTTD encoding to that of the filesystem. For all purposes this

   151

 * function behaves the same as the original opendir function

   152

 * @param path string to open directory of

   153

 * @return DIR pointer

   154

 */

   155

static inline DIR *ttd_opendir(const char *path)

   156

{

   157

	return opendir(OTTD2FS(path));

   158

}

   159

   160

#endif /* FIOS_H */