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"
|
2012-01-15 20:29:49 +01:00
|
|
|
#include "table/control_codes.h"
|
2020-05-17 23:31:47 +02:00
|
|
|
#include <utility>
|
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. */
|
2023-05-08 19:01:06 +02:00
|
|
|
static const char32_t NFO_UTF8_IDENTIFIER = 0x00DE;
|
2010-11-16 13:35:16 +01:00
|
|
|
|
2020-05-17 23:31:47 +02:00
|
|
|
/** A GRF text with associated language ID. */
|
|
|
|
struct GRFText {
|
|
|
|
byte langid; ///< The language associated with this GRFText.
|
|
|
|
std::string text; ///< The actual (translated) text.
|
|
|
|
};
|
|
|
|
|
|
|
|
/** A GRF text with a list of translations. */
|
|
|
|
typedef std::vector<GRFText> GRFTextList;
|
|
|
|
/** Reference counted wrapper around a GRFText pointer. */
|
|
|
|
typedef std::shared_ptr<GRFTextList> GRFTextWrapper;
|
|
|
|
|
2023-05-08 19:01:06 +02:00
|
|
|
StringID AddGRFString(uint32_t grfid, uint16_t stringid, byte langid, bool new_scheme, bool allow_newlines, const char *text_to_add, StringID def_string);
|
|
|
|
StringID GetGRFStringID(uint32_t grfid, StringID stringid);
|
2020-05-17 23:31:47 +02:00
|
|
|
const char *GetGRFStringFromGRFText(const GRFTextList &text_list);
|
|
|
|
const char *GetGRFStringFromGRFText(const GRFTextWrapper &text);
|
2023-09-04 09:12:51 +02:00
|
|
|
const char *GetGRFStringPtr(uint32_t stringid);
|
2007-03-07 12:47:46 +01:00
|
|
|
void CleanUpStrings();
|
2009-03-13 01:30:26 +01:00
|
|
|
void SetCurrentGrfLangID(byte language_id);
|
2023-05-08 19:01:06 +02:00
|
|
|
std::string TranslateTTDPatchCodes(uint32_t grfid, uint8_t language_id, bool allow_newlines, const std::string &str, StringControlCode byte80 = SCC_NEWGRF_PRINT_WORD_STRING_ID);
|
|
|
|
void AddGRFTextToList(GRFTextList &list, byte langid, uint32_t grfid, bool allow_newlines, const char *text_to_add);
|
|
|
|
void AddGRFTextToList(GRFTextWrapper &list, byte langid, uint32_t grfid, bool allow_newlines, const char *text_to_add);
|
2021-05-30 13:34:58 +02:00
|
|
|
void AddGRFTextToList(GRFTextWrapper &list, const std::string &text_to_add);
|
2006-04-21 05:00:20 +02:00
|
|
|
|
2007-06-12 15:22:14 +02:00
|
|
|
bool CheckGrfLangID(byte lang_id, byte grf_version);
|
|
|
|
|
2023-05-08 19:01:06 +02:00
|
|
|
void StartTextRefStackUsage(const struct GRFFile *grffile, byte numEntries, const uint32_t *values = nullptr);
|
2007-09-23 01:55:34 +02:00
|
|
|
void StopTextRefStackUsage();
|
2010-12-08 14:44:01 +01:00
|
|
|
bool UsingNewGRFTextStack();
|
|
|
|
struct TextRefStack *CreateTextRefStackBackup();
|
|
|
|
void RestoreTextRefStackBackup(struct TextRefStack *backup);
|
2007-09-23 01:55:34 +02:00
|
|
|
|
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. */
|
2019-03-03 18:30:09 +01:00
|
|
|
std::vector<Mapping> gender_map; ///< Mapping of NewGRF and OpenTTD IDs for genders.
|
|
|
|
std::vector<Mapping> case_map; ///< Mapping of NewGRF and OpenTTD IDs for cases.
|
2019-03-04 21:49:33 +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;
|
2023-05-08 19:01:06 +02:00
|
|
|
static const LanguageMap *GetLanguageMap(uint32_t grfid, uint8_t language_id);
|
2010-11-16 13:47:22 +01:00
|
|
|
};
|
|
|
|
|
2006-04-21 05:00:20 +02:00
|
|
|
#endif /* NEWGRF_TEXT_H */
|