core/Translator.h
author David Anderson <dvander@alliedmods.net>
Wed Aug 01 02:12:47 2007 +0000 (2007-08-01)
changeset 1231 17badaf66ce4
parent 1105 ce907ba50921
child 1330 ab94316bb52b
permissions -rw-r--r--
updated more header files (mostly internal now)
dvander@591
     1
/**
ds@653
     2
 * vim: set ts=4 :
dvander@1231
     3
 * ================================================================
dvander@1231
     4
 * SourceMod
dvander@1231
     5
 * Copyright (C) 2004-2007 AlliedModders LLC.  All rights reserved.
dvander@1231
     6
 * ================================================================
dvander@591
     7
 *
dvander@1231
     8
 * This program is free software; you can redistribute it and/or 
dvander@1231
     9
 * modify it under the terms of the GNU General Public License, 
dvander@1231
    10
 * version 3.0, as published by the Free Software Foundation.
dvander@1231
    11
 * 
dvander@1231
    12
 * This program is distributed in the hope that it will be useful,
dvander@1231
    13
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
dvander@1231
    14
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
dvander@1231
    15
 * GNU General Public License for more details.
dvander@1231
    16
 *
dvander@1231
    17
 * You should have received a copy of the GNU General Public License
dvander@1231
    18
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
dvander@1231
    19
 *
dvander@1231
    20
 * As a special exception, AlliedModders LLC gives you permission to 
dvander@1231
    21
 * link the code of this program (as well as its derivative works) to 
dvander@1231
    22
 * "Half-Life 2," the "Source Engine," the "SourcePawn JIT," and any 
dvander@1231
    23
 * Game MODs that run on software by the Valve Corporation.  You must 
dvander@1231
    24
 * obey the GNU General Public License in all respects for all other 
dvander@1231
    25
 * code used. Additionally, AlliedModders LLC grants this exception 
dvander@1231
    26
 * to all derivative works. AlliedModders LLC defines further 
dvander@1231
    27
 * exceptions, found in LICENSE.txt (as of this writing, version 
dvander@1231
    28
 * JULY-31-2007), or <http://www.sourcemod.net/license.php>.
dvander@591
    29
 *
dvander@591
    30
 * Version: $Id$
dvander@591
    31
 */
dvander@591
    32
dvander@591
    33
#ifndef _INCLUDE_SOURCEMOD_TRANSLATOR_H_
dvander@591
    34
#define _INCLUDE_SOURCEMOD_TRANSLATOR_H_
dvander@591
    35
dvander@591
    36
#include "sm_trie.h"
dvander@591
    37
#include <sh_string.h>
dvander@591
    38
#include <sh_vector.h>
dvander@591
    39
#include "sm_globals.h"
dvander@591
    40
#include "sm_memtable.h"
dvander@591
    41
#include "ITextParsers.h"
dvander@591
    42
dvander@591
    43
#define MAX_TRANSLATE_PARAMS		32
dvander@732
    44
#define CORELANG_ENGLISH			0
dvander@591
    45
dvander@591
    46
/* :TODO: write a templatized version of tries? */
dvander@591
    47
dvander@591
    48
using namespace SourceHook;
dvander@616
    49
class Translator;
dvander@591
    50
dvander@591
    51
enum PhraseParseState
dvander@591
    52
{
dvander@591
    53
	PPS_None = 0,
dvander@591
    54
	PPS_Phrases,
dvander@591
    55
	PPS_InPhrase,
dvander@591
    56
};
dvander@591
    57
dvander@591
    58
struct Language
dvander@591
    59
{
dvander@591
    60
	char m_code2[3];
dvander@591
    61
	int m_FullName;
dvander@591
    62
};
dvander@591
    63
dvander@591
    64
struct Translation
dvander@591
    65
{
dvander@591
    66
	const char *szPhrase;		/**< Translated phrase. */
dvander@591
    67
	unsigned int fmt_count;		/**< Number of format parameters. */
dvander@591
    68
	int *fmt_order;				/**< Format phrase order. */
dvander@591
    69
};
dvander@591
    70
dvander@663
    71
#define LANGUAGE_ENGLISH			0
dvander@663
    72
dvander@591
    73
enum TransError
dvander@591
    74
{
dvander@591
    75
	Trans_Okay = 0,
dvander@591
    76
	Trans_BadLanguage = 1,
dvander@591
    77
	Trans_BadPhrase = 2,
dvander@591
    78
	Trans_BadPhraseLanguage = 3,
dvander@591
    79
	Trans_BadPhraseFile = 4,
dvander@591
    80
};
dvander@591
    81
dvander@591
    82
class CPhraseFile : public ITextListener_SMC
dvander@591
    83
{
dvander@591
    84
public:
dvander@616
    85
	CPhraseFile(Translator *pTranslator, const char *file);
dvander@591
    86
	~CPhraseFile();
dvander@591
    87
public:
dvander@591
    88
	void ReparseFile();
dvander@591
    89
	const char *GetFilename();
dvander@591
    90
	TransError GetTranslation(const char *szPhrase, unsigned int lang_id, Translation *pTrans);
dvander@591
    91
public: //ITextListener_SMC
dvander@591
    92
	void ReadSMC_ParseStart();
dvander@591
    93
	void ReadSMC_ParseEnd(bool halted, bool failed);
dvander@591
    94
	SMCParseResult ReadSMC_NewSection(const char *name, bool opt_quotes);
dvander@591
    95
	SMCParseResult ReadSMC_KeyValue(const char *key, const char *value, bool key_quotes, bool value_quotes);
dvander@591
    96
	SMCParseResult ReadSMC_LeavingSection();
dvander@591
    97
	SMCParseResult ReadSMC_RawLine(const char *line, unsigned int curline);
dvander@591
    98
private:
dvander@591
    99
	void ParseError(const char *message, ...);
dvander@591
   100
	void ParseWarning(const char *message, ...);
dvander@591
   101
private:
dvander@591
   102
	Trie *m_pPhraseLookup;
dvander@591
   103
	String m_File;
dvander@616
   104
	Translator *m_pTranslator;
dvander@591
   105
	PhraseParseState m_ParseState;
dvander@591
   106
	int m_CurPhrase;
dvander@591
   107
	BaseMemTable *m_pMemory;
dvander@591
   108
	BaseStringTable *m_pStringTab;
dvander@591
   109
	unsigned int m_LangCount;
dvander@591
   110
	String m_ParseError;
dvander@591
   111
	String m_LastPhraseString;
dvander@591
   112
	unsigned int m_CurLine;
dvander@591
   113
	bool m_FileLogged;
dvander@591
   114
};
dvander@591
   115
dvander@616
   116
class Translator : 
dvander@591
   117
	public ITextListener_SMC,
dvander@591
   118
	public SMGlobalClass
dvander@591
   119
{
dvander@591
   120
public:
dvander@616
   121
	Translator();
dvander@616
   122
	~Translator();
ds@661
   123
public: // SMGlobalClass
dvander@663
   124
	ConfigResult OnSourceModConfigChanged(const char *key, 
dvander@663
   125
		const char *value, 
dvander@663
   126
		ConfigSource source, 
dvander@663
   127
		char *error, 
dvander@663
   128
		size_t maxlength);
dvander@591
   129
	void OnSourceModAllInitialized();
dvander@673
   130
	void OnSourceModLevelChange(const char *mapName);
ds@661
   131
public: // ITextListener_SMC
dvander@591
   132
	void ReadSMC_ParseStart();
dvander@591
   133
	SMCParseResult ReadSMC_NewSection(const char *name, bool opt_quotes);
dvander@591
   134
	SMCParseResult ReadSMC_KeyValue(const char *key, const char *value, bool key_quotes, bool value_quotes);
dvander@591
   135
	SMCParseResult ReadSMC_LeavingSection();
dvander@591
   136
public:
dvander@591
   137
	void RebuildLanguageDatabase(const char *lang_header_file);
dvander@591
   138
	unsigned int FindOrAddPhraseFile(const char *phrase_file);
dvander@591
   139
	BaseStringTable *GetStringTable();
dvander@591
   140
	unsigned int GetLanguageCount();
dvander@1105
   141
	bool GetLanguageInfo(unsigned int number, const char **code, const char **name);
dvander@591
   142
	bool GetLanguageByCode(const char *code, unsigned int *index);
dvander@591
   143
	size_t Translate(char *buffer, size_t maxlength, void **params, const Translation *pTrans);
dvander@591
   144
	CPhraseFile *GetFileByIndex(unsigned int index);
dvander@591
   145
	TransError CoreTrans(int client, 
dvander@591
   146
						 char *buffer, 
dvander@591
   147
						 size_t maxlength, 
dvander@591
   148
						 const char *phrase, 
dvander@591
   149
						 void **params, 
dvander@591
   150
						 size_t *outlen=NULL);
ds@669
   151
	unsigned int GetServerLanguage();
dvander@1105
   152
	unsigned int GetClientLanguage(int client);
dvander@591
   153
private:
dvander@591
   154
	bool AddLanguage(const char *langcode, const char *description);
dvander@591
   155
private:
dvander@591
   156
	CVector<Language *> m_Languages;
dvander@591
   157
	CVector<CPhraseFile *> m_Files;
dvander@591
   158
	BaseStringTable *m_pStringTab;
dvander@591
   159
	Trie *m_pLCodeLookup;
dvander@591
   160
	bool m_InLanguageSection;
dvander@591
   161
	String m_CustomError;
ds@669
   162
	unsigned int m_ServerLang;
ds@669
   163
	char m_InitialLang[3];
dvander@591
   164
};
dvander@591
   165
dvander@591
   166
extern CPhraseFile *g_pCorePhrases;
dvander@616
   167
extern Translator g_Translator;
dvander@591
   168
dvander@591
   169
#endif //_INCLUDE_SOURCEMOD_TRANSLATOR_H_