From cb4ab6a23158163e848ab2b5887d1eb449b86a4c Mon Sep 17 00:00:00 2001 From: rubidium Date: Sat, 7 Aug 2010 22:05:58 +0000 Subject: (svn r20405) -Add: generic class for "classes" for NewGRFs, e.g. the Station classes and Airport classes --- src/newgrf_class.h | 102 +++++++++++++++++++++++++++++++++++++ src/newgrf_class_func.h | 132 ++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 234 insertions(+) create mode 100644 src/newgrf_class.h create mode 100644 src/newgrf_class_func.h diff --git a/src/newgrf_class.h b/src/newgrf_class.h new file mode 100644 index 000000000..6411492c1 --- /dev/null +++ b/src/newgrf_class.h @@ -0,0 +1,102 @@ +/* $Id$ */ + +/* + * This file is part of OpenTTD. + * OpenTTD is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2. + * OpenTTD is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. + * See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see . + */ + +/** @file newgrf_class.h Header file for classes to be used by e.g. NewGRF stations and airports */ + +#ifndef NEWGRF_CLASS_H +#define NEWGRF_CLASS_H + +#include "strings_type.h" + +/** + * Struct containing information relating to NewGRF classes for stations and airports. + */ +template +struct NewGRFClass { + uint32 global_id; ///< Global ID for class, e.g. 'DFLT', 'WAYP', etc. + StringID name; ///< Name of this class. + uint count; ///< Number of stations in this class. + Tspec **spec; ///< Array of station specifications. + + /** The actual classes. */ + static NewGRFClass classes[Tmax]; + + /** Reset the classes, i.e. clear everything. */ + static void Reset(); + + /** Initialise the defaults. */ + static void InsertDefaults(); + + /** + * Allocate a class with a given global class ID. + * @param cls_id The global class id, such as 'DFLT'. + * @return The (non global!) class ID for the class. + * @note Upon allocating the same global class ID for a + * second time, this first allocation will be given. + */ + static Tid Allocate(uint32 global_id); + + /** + * Set the name of a particular class. + * @param cls_id The id for the class. + * @pre index < GetCount(cls_id) + * @param name The new name for the class. + */ + static void SetName(Tid cls_id, StringID name); + + /** + * Assign a spec to one of the classes. + * @param spec The spec to assign. + * @note The spec must have a valid class id set. + */ + static void Assign(Tspec *spec); + + + /** + * Get the name of a particular class. + * @param cls_id The class to get the name of. + * @pre index < GetCount(cls_id) + * @return The name of said class. + */ + static StringID GetName(Tid cls_id); + + /** + * Get the number of allocated classes. + * @return The number of classes. + */ + static uint GetCount(); + + /** + * Get the number of allocated specs within a particular class. + * @param cls_id The class to get the size of. + * @pre cls_id < GetCount() + * @return The size of the class. + */ + static uint GetCount(Tid cls_id); + + /** + * Get a spec from a particular class at a given index. + * @param cls_id The class to get the spec from. + * @param index The index where to find the spec. + * @pre index < GetCount(cls_id) + * @return The spec at given location. + */ + static const Tspec *Get(Tid cls_id, uint index); + + /** + * Retrieve a spec by GRF location. + * @param grfid GRF ID of spec. + * @param local_id Index within GRF file of spec. + * @param index Pointer to return the index of the spec in its class. If NULL then not used. + * @return The spec. + */ + static const Tspec *GetByGrf(uint32 grfid, byte local_id, int *index); +}; + +#endif /* NEWGRF_STATION_H */ diff --git a/src/newgrf_class_func.h b/src/newgrf_class_func.h new file mode 100644 index 000000000..bd83376f7 --- /dev/null +++ b/src/newgrf_class_func.h @@ -0,0 +1,132 @@ +/* $Id$ */ + +/* + * This file is part of OpenTTD. + * OpenTTD is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2. + * OpenTTD is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. + * See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see . + */ + +/** @file newgrf_class_func.h Implementation of the NewGRF class' functions. */ + +#include "stdafx.h" +#include "core/alloc_func.hpp" +#include "newgrf_class.h" + +#include "table/strings.h" + +#define DEFINE_NEWGRF_CLASS_METHOD(type) \ + template \ + type NewGRFClass + +/** Instantiate the array. */ +template +NewGRFClass NewGRFClass::classes[Tmax]; + +DEFINE_NEWGRF_CLASS_METHOD(void)::Reset() +{ + for (Tid i = (Tid)0; i < Tmax; i++) { + classes[i].global_id = 0; + classes[i].name = STR_EMPTY; + classes[i].count = 0; + + free(classes[i].spec); + classes[i].spec = NULL; + } + + InsertDefaults(); +} + +DEFINE_NEWGRF_CLASS_METHOD(Tid)::Allocate(uint32 global_id) +{ + for (Tid i = (Tid)0; i < Tmax; i++) { + if (classes[i].global_id == global_id) { + /* ClassID is already allocated, so reuse it. */ + return i; + } else if (classes[i].global_id == 0) { + /* This class is empty, so allocate it to the global id. */ + classes[i].global_id = global_id; + return i; + } + } + + grfmsg(2, "ClassAllocate: already allocated %d classes, using default", Tmax); + return (Tid)0; +} + +DEFINE_NEWGRF_CLASS_METHOD(void)::SetName(Tid cls_id, StringID name) +{ + assert(cls_id < Tmax); + classes[cls_id].name = name; +} + +DEFINE_NEWGRF_CLASS_METHOD(void)::Assign(Tspec *spec) +{ + assert(spec->cls_id < Tmax); + NewGRFClass *cls = &classes[spec->cls_id]; + + uint i = cls->count++; + cls->spec = ReallocT(cls->spec, cls->count); + + cls->spec[i] = spec; +} + +DEFINE_NEWGRF_CLASS_METHOD(StringID)::GetName(Tid cls_id) +{ + assert(cls_id < Tmax); + return classes[cls_id].name; +} + +DEFINE_NEWGRF_CLASS_METHOD(uint)::GetCount() +{ + uint i; + for (i = 0; i < Tmax && classes[i].global_id != 0; i++) {} + return i; +} + +DEFINE_NEWGRF_CLASS_METHOD(uint)::GetCount(Tid cls_id) +{ + assert(cls_id < Tmax); + return classes[cls_id].count; +} + +DEFINE_NEWGRF_CLASS_METHOD(const Tspec *)::Get(Tid cls_id, uint index) +{ + assert(cls_id < Tmax); + if (index < classes[cls_id].count) return classes[cls_id].spec[index]; + + /* If the custom spec isn't defined any more, then the GRF file probably was not loaded. */ + return NULL; +} + +DEFINE_NEWGRF_CLASS_METHOD(const Tspec *)::GetByGrf(uint32 grfid, byte local_id, int *index) +{ + uint j; + + for (Tid i = (Tid)0; i < Tmax; i++) { + for (j = 0; j < classes[i].count; j++) { + const Tspec *spec = classes[i].spec[j]; + if (spec == NULL) continue; + if (spec->grf_prop.grffile->grfid == grfid && spec->grf_prop.local_id == local_id) { + if (index != NULL) *index = j; + return spec; + } + } + } + + return NULL; +} + +#undef DEFINE_NEWGRF_CLASS_METHOD + +/** Force instantiation of the methods so we don't get linker errors. */ +#define INSTANTIATE_NEWGRF_CLASS_METHODS(name, Tspec, Tid, Tmax) \ + template void name::Reset(); \ + template Tid name::Allocate(uint32 global_id); \ + template void name::SetName(Tid cls_id, StringID name); \ + template void name::Assign(Tspec *spec); \ + template StringID name::GetName(Tid cls_id); \ + template uint name::GetCount(); \ + template uint name::GetCount(Tid cls_id); \ + template const Tspec *name::Get(Tid cls_id, uint index); \ + template const Tspec *name::GetByGrf(uint32 grfid, byte localidx, int *index); -- cgit v1.2.3-54-g00ecf