1

/* $Id$ */

     2

     3

/** @file newgrf_config.h */

     4

     5

#ifndef NEWGRF_CONFIG_H

     6

#define NEWGRF_CONFIG_H

     7

     8

#include "strings_type.h"

     9

    10

/** GRF config bit flags */

    11

enum GCF_Flags {

    12

	GCF_SYSTEM,     ///< GRF file is an openttd-internal system grf

    13

	GCF_UNSAFE,     ///< GRF file is unsafe for static usage

    14

	GCF_STATIC,     ///< GRF file is used statically (can be used in any MP game)

    15

	GCF_COMPATIBLE, ///< GRF file does not exactly match the requested GRF (different MD5SUM), but grfid matches)

    16

	GCF_COPY,       ///< The data is copied from a grf in _all_grfs

    17

	GCF_INIT_ONLY,  ///< GRF file is processed up to GLS_INIT

    18

	GCF_RESERVED,   ///< GRF file passed GLS_RESERVE stage

    19

    20

};

    21

    22

/** Status of GRF */

    23

enum GRFStatus {

    24

	GCS_UNKNOWN,      ///< The status of this grf file is unknown

    25

	GCS_DISABLED,     ///< GRF file is disabled

    26

	GCS_NOT_FOUND,    ///< GRF file was not found in the local cache

    27

	GCS_INITIALISED,  ///< GRF file has been initialised

    28

	GCS_ACTIVATED     ///< GRF file has been activated

    29

};

    30

    31

/** Status of post-gameload GRF compatibility check */

    32

enum GRFListCompatibility{

    33

	GLC_ALL_GOOD,   ///< All GRF needed by game are present

    34

	GLC_COMPATIBLE, ///< Compatible (eg. the same ID, but different chacksum) GRF found in at least one case

    35

	GLC_NOT_FOUND   ///< At least one GRF couldn't be found (higher priority than GLC_COMPATIBLE)

    36

};

    37

    38

/** Basic data to distinguish a GRF. Used in the server list window */

    39

struct GRFIdentifier {

    40

	uint32 grfid;     ///< GRF ID (defined by Action 0x08)

    41

	uint8 md5sum[16]; ///< MD5 checksum of file to distinguish files with the same GRF ID (eg. newer version of GRF)

    42

};

    43

    44

/** Information about why GRF had problems during initialisation */

    45

struct GRFError {

    46

	char *custom_message;  ///< Custom message (if present)

    47

	char *data;            ///< Additional data for message and custom_message

    48

	StringID message;      ///< Default message

    49

	StringID severity;     ///< Info / Warning / Error / Fatal

    50

	uint8 num_params;      ///< Number of additinal parameters for custom_message (0, 1 or 2)

    51

	uint8 param_number[2]; ///< GRF parameters to show for custom_message

    52

};

    53

    54

/** Information about GRF, used in the game and (part of it) in savegames */

    55

struct GRFConfig : public GRFIdentifier {

    56

	char *filename;     ///< Filename - either with or without full path

    57

	char *name;         ///< NOSAVE: GRF name (Action 0x08)

    58

	char *info;         ///< NOSAVE: GRF info (author, copyright, ...) (Action 0x08)

    59

	GRFError *error;    ///< NOSAVE: Error/Warning during GRF loading (Action 0x0B)

    60

    61

	uint8 flags;        ///< NOSAVE: GCF_Flags, bitset

    62

	GRFStatus status;   ///< NOSAVE: GRFStatus, enum

    63

	uint32 param[0x80]; ///< GRF parameters

    64

	uint8 num_params;   ///< Number of used parameters

    65

    66

	struct GRFConfig *next; ///< NOSAVE: Next item in the linked list

    67

    68

	bool IsOpenTTDBaseGRF() const;

    69

};

    70

    71

extern GRFConfig *_all_grfs;          ///< First item in list of all scanned NewGRFs

    72

extern GRFConfig *_grfconfig;         ///< First item in list of current GRF set up

    73

extern GRFConfig *_grfconfig_newgame; ///< First item in list of default GRF set up

    74

extern GRFConfig *_grfconfig_static;  ///< First item in list of static GRF set up

    75

    76

void ScanNewGRFFiles();

    77

const GRFConfig *FindGRFConfig(uint32 grfid, const uint8 *md5sum = NULL);

    78

GRFConfig *GetGRFConfig(uint32 grfid);

    79

GRFConfig **CopyGRFConfigList(GRFConfig **dst, const GRFConfig *src, bool init_only);

    80

void AppendStaticGRFConfigs(GRFConfig **dst);

    81

void AppendToGRFConfigList(GRFConfig **dst, GRFConfig *el);

    82

void ClearGRFConfig(GRFConfig **config);

    83

void ClearGRFConfigList(GRFConfig **config);

    84

void ResetGRFConfig(bool defaults);

    85

GRFListCompatibility IsGoodGRFConfigList();

    86

bool FillGRFDetails(GRFConfig *config, bool is_static);

    87

char *GRFBuildParamList(char *dst, const GRFConfig *c, const char *last);

    88

    89

/* In newgrf_gui.cpp */

    90

void ShowNewGRFSettings(bool editable, bool show_params, bool exec_changes, GRFConfig **config);

    91

    92

#ifdef ENABLE_NETWORK

    93

/* For communication about GRFs over the network */

    94

#define UNKNOWN_GRF_NAME_PLACEHOLDER "<Unknown>"

    95

char *FindUnknownGRFName(uint32 grfid, uint8 *md5sum, bool create);

    96

#endif /* ENABLE_NETWORK */

    97

    98

#endif /* NEWGRF_CONFIG_H */