2006-04-21 05:00:20 +02:00
|
|
|
/* $Id$ */
|
2009-01-03 23:20:18 +01:00
|
|
|
|
2009-08-21 22:21:05 +02:00
|
|
|
/*
|
|
|
|
* 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 <http://www.gnu.org/licenses/>.
|
|
|
|
*/
|
|
|
|
|
2009-01-03 23:20:18 +01:00
|
|
|
/** @file newgrf_text.h Header of Action 04 "universal holder" structure and functions */
|
|
|
|
|
2006-04-21 05:00:20 +02:00
|
|
|
#ifndef NEWGRF_TEXT_H
|
|
|
|
#define NEWGRF_TEXT_H
|
|
|
|
|
2010-11-16 13:35:16 +01:00
|
|
|
#include "string_type.h"
|
2010-01-15 17:41:15 +01:00
|
|
|
#include "strings_type.h"
|
2010-11-16 13:47:22 +01:00
|
|
|
#include "core/smallvec_type.hpp"
|
2010-01-15 17:41:15 +01:00
|
|
|
|
2010-11-16 13:35:16 +01:00
|
|
|
/** This character, the thorn ('þ'), indicates a unicode string to NFO. */
|
|
|
|
static const WChar NFO_UTF8_IDENTIFIER = 0x00DE;
|
|
|
|
|
2011-10-01 22:31:21 +02:00
|
|
|
StringID AddGRFString(uint32 grfid, uint16 stringid, byte langid, bool new_scheme, bool allow_newlines, const char *text_to_add, StringID def_string);
|
2006-04-21 05:00:20 +02:00
|
|
|
StringID GetGRFStringID(uint32 grfid, uint16 stringid);
|
2010-07-31 11:33:39 +02:00
|
|
|
const char *GetGRFStringFromGRFText(const struct GRFText *text);
|
2008-01-29 18:09:00 +01:00
|
|
|
const char *GetGRFStringPtr(uint16 stringid);
|
2007-03-07 12:47:46 +01:00
|
|
|
void CleanUpStrings();
|
2009-03-13 01:30:26 +01:00
|
|
|
void SetCurrentGrfLangID(byte language_id);
|
2011-10-01 22:31:21 +02:00
|
|
|
char *TranslateTTDPatchCodes(uint32 grfid, uint8 language_id, bool allow_newlines, const char *str, int *olen = NULL);
|
2010-07-31 11:33:39 +02:00
|
|
|
struct GRFText *DuplicateGRFText(struct GRFText *orig);
|
|
|
|
void AddGRFTextToList(struct GRFText **list, struct GRFText *text_to_add);
|
2011-10-01 22:31:21 +02:00
|
|
|
void AddGRFTextToList(struct GRFText **list, byte langid, uint32 grfid, bool allow_newlines, const char *text_to_add);
|
2010-07-31 11:33:39 +02:00
|
|
|
void AddGRFTextToList(struct GRFText **list, const char *text_to_add);
|
|
|
|
void CleanUpGRFText(struct GRFText *grftext);
|
2006-04-21 05:00:20 +02:00
|
|
|
|
2007-06-12 15:22:14 +02:00
|
|
|
bool CheckGrfLangID(byte lang_id, byte grf_version);
|
|
|
|
|
2011-07-03 15:53:42 +02:00
|
|
|
void StartTextRefStackUsage(byte numEntries, const uint32 *values = NULL);
|
2007-09-23 01:55:34 +02:00
|
|
|
void StopTextRefStackUsage();
|
2007-10-17 22:09:16 +02:00
|
|
|
void RewindTextRefStack();
|
2010-12-08 14:44:01 +01:00
|
|
|
bool UsingNewGRFTextStack();
|
|
|
|
struct TextRefStack *CreateTextRefStackBackup();
|
|
|
|
void RestoreTextRefStackBackup(struct TextRefStack *backup);
|
2010-04-06 23:16:36 +02:00
|
|
|
uint RemapNewGRFStringControlCode(uint scc, char *buf_start, char **buff, const char **str, int64 *argv);
|
2007-09-23 01:55:34 +02:00
|
|
|
|
2009-09-20 12:21:00 +02:00
|
|
|
StringID TTDPStringIDToOTTDStringIDMapping(StringID string);
|
|
|
|
|
2010-11-16 13:47:22 +01:00
|
|
|
/** Mapping of language data between a NewGRF and OpenTTD. */
|
|
|
|
struct LanguageMap {
|
|
|
|
/** Mapping between NewGRF and OpenTTD IDs. */
|
|
|
|
struct Mapping {
|
|
|
|
byte newgrf_id; ///< NewGRF's internal ID for a case/gender.
|
|
|
|
byte openttd_id; ///< OpenTTD's internal ID for a case/gender.
|
|
|
|
};
|
|
|
|
|
|
|
|
/* We need a vector and can't use SmallMap due to the fact that for "setting" a
|
|
|
|
* gender of a string or requesting a case for a substring we want to map from
|
|
|
|
* the NewGRF's internal ID to OpenTTD's ID whereas for the choice lists we map
|
|
|
|
* the genders/cases/plural OpenTTD IDs to the NewGRF's internal IDs. In this
|
|
|
|
* case a NewGRF developer/translator might want a different translation for
|
|
|
|
* both cases. Thus we are basically implementing a multi-map. */
|
|
|
|
SmallVector<Mapping, 1> gender_map; ///< Mapping of NewGRF and OpenTTD IDs for genders.
|
|
|
|
SmallVector<Mapping, 1> case_map; ///< Mapping of NewGRF and OpenTTD IDs for cases.
|
2010-11-16 22:03:39 +01:00
|
|
|
int plural_form; ///< The plural form used for this language.
|
2010-11-16 15:00:02 +01:00
|
|
|
|
|
|
|
int GetMapping(int newgrf_id, bool gender) const;
|
2010-11-16 17:58:19 +01:00
|
|
|
int GetReverseMapping(int openttd_id, bool gender) const;
|
2010-11-16 15:00:02 +01:00
|
|
|
static const LanguageMap *GetLanguageMap(uint32 grfid, uint8 language_id);
|
2010-11-16 13:47:22 +01:00
|
|
|
};
|
|
|
|
|
2006-04-21 05:00:20 +02:00
|
|
|
#endif /* NEWGRF_TEXT_H */
|