core/logic/Translator.h
author Fyren <fyrenmoo@gmail.com>
Sun Jul 24 19:52:22 2011 -0700 (2011-07-24)
changeset 3366 d4afcec1be26
parent 3291 1be149cf4e89
child 3532 88a0d2c30bc3
permissions -rw-r--r--
Let logic binary access ServerLang value on startup (bug 4675, r=dvander).
dvander@591
     1
/**
ds@653
     2
 * vim: set ts=4 :
ds@1330
     3
 * =============================================================================
dvander@1231
     4
 * SourceMod
ds@1947
     5
 * Copyright (C) 2004-2008 AlliedModders LLC.  All rights reserved.
ds@1330
     6
 * =============================================================================
dvander@591
     7
 *
ds@1330
     8
 * This program is free software; you can redistribute it and/or modify it under
ds@1330
     9
 * the terms of the GNU General Public License, version 3.0, as published by the
ds@1330
    10
 * Free Software Foundation.
dvander@1231
    11
 * 
ds@1330
    12
 * This program is distributed in the hope that it will be useful, but WITHOUT
ds@1330
    13
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
ds@1330
    14
 * FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
ds@1330
    15
 * details.
dvander@1231
    16
 *
ds@1330
    17
 * You should have received a copy of the GNU General Public License along with
ds@1330
    18
 * this program.  If not, see <http://www.gnu.org/licenses/>.
dvander@1231
    19
 *
ds@1330
    20
 * As a special exception, AlliedModders LLC gives you permission to link the
ds@1330
    21
 * code of this program (as well as its derivative works) to "Half-Life 2," the
ds@1330
    22
 * "Source Engine," the "SourcePawn JIT," and any Game MODs that run on software
ds@1330
    23
 * by the Valve Corporation.  You must obey the GNU General Public License in
ds@1330
    24
 * all respects for all other code used.  Additionally, AlliedModders LLC grants
ds@1330
    25
 * this exception to all derivative works.  AlliedModders LLC defines further
ds@1330
    26
 * exceptions, found in LICENSE.txt (as of this writing, version JULY-31-2007),
ds@1330
    27
 * or <http://www.sourcemod.net/license.php>.
dvander@591
    28
 *
dvander@591
    29
 * Version: $Id$
dvander@591
    30
 */
dvander@591
    31
dvander@591
    32
#ifndef _INCLUDE_SOURCEMOD_TRANSLATOR_H_
dvander@591
    33
#define _INCLUDE_SOURCEMOD_TRANSLATOR_H_
dvander@591
    34
dvander@3004
    35
#include "common_logic.h"
dvander@3004
    36
#include <sm_trie_tpl.h>
dvander@591
    37
#include <sh_string.h>
dvander@591
    38
#include <sh_vector.h>
dvander@591
    39
#include "sm_memtable.h"
dvander@591
    40
#include "ITextParsers.h"
dvander@2042
    41
#include <ITranslator.h>
dvander@591
    42
dvander@591
    43
/* :TODO: write a templatized version of tries? */
dvander@591
    44
dvander@591
    45
using namespace SourceHook;
dvander@616
    46
class Translator;
dvander@591
    47
dvander@591
    48
enum PhraseParseState
dvander@591
    49
{
dvander@591
    50
	PPS_None = 0,
dvander@591
    51
	PPS_Phrases,
dvander@591
    52
	PPS_InPhrase,
dvander@591
    53
};
dvander@591
    54
dvander@591
    55
struct Language
dvander@591
    56
{
dvander@2478
    57
	char m_code2[4];
fyrenmoo@3291
    58
	int m_CanonicalName;
dvander@591
    59
};
dvander@591
    60
dvander@2042
    61
class CPhraseFile : 
dvander@2042
    62
	public ITextListener_SMC,
dvander@2042
    63
	public IPhraseFile
dvander@591
    64
{
dvander@591
    65
public:
dvander@616
    66
	CPhraseFile(Translator *pTranslator, const char *file);
dvander@591
    67
	~CPhraseFile();
dvander@591
    68
public:
dvander@591
    69
	void ReparseFile();
dvander@591
    70
	const char *GetFilename();
dvander@591
    71
	TransError GetTranslation(const char *szPhrase, unsigned int lang_id, Translation *pTrans);
dvander@591
    72
public: //ITextListener_SMC
dvander@591
    73
	void ReadSMC_ParseStart();
dvander@1656
    74
	SMCResult ReadSMC_NewSection(const SMCStates *states, const char *name);
dvander@1656
    75
	SMCResult ReadSMC_KeyValue(const SMCStates *states, const char *key, const char *value);
dvander@1656
    76
	SMCResult ReadSMC_LeavingSection(const SMCStates *states);
dvander@591
    77
	void ReadSMC_ParseEnd(bool halted, bool failed);
dvander@591
    78
private:
dvander@591
    79
	void ParseError(const char *message, ...);
dvander@591
    80
	void ParseWarning(const char *message, ...);
dvander@591
    81
private:
dvander@3004
    82
	KTrie<int> m_PhraseLookup;
dvander@591
    83
	String m_File;
dvander@616
    84
	Translator *m_pTranslator;
dvander@591
    85
	PhraseParseState m_ParseState;
dvander@591
    86
	int m_CurPhrase;
dvander@591
    87
	BaseMemTable *m_pMemory;
dvander@591
    88
	BaseStringTable *m_pStringTab;
dvander@591
    89
	unsigned int m_LangCount;
dvander@591
    90
	String m_ParseError;
dvander@591
    91
	String m_LastPhraseString;
dvander@591
    92
	bool m_FileLogged;
dvander@591
    93
};
dvander@591
    94
dvander@616
    95
class Translator : 
dvander@591
    96
	public ITextListener_SMC,
dvander@2042
    97
	public SMGlobalClass,
dvander@2042
    98
	public ITranslator
dvander@591
    99
{
dvander@591
   100
public:
dvander@616
   101
	Translator();
dvander@616
   102
	~Translator();
ds@661
   103
public: // SMGlobalClass
dvander@663
   104
	ConfigResult OnSourceModConfigChanged(const char *key, 
dvander@663
   105
		const char *value, 
dvander@663
   106
		ConfigSource source, 
dvander@663
   107
		char *error, 
dvander@663
   108
		size_t maxlength);
dvander@591
   109
	void OnSourceModAllInitialized();
dvander@673
   110
	void OnSourceModLevelChange(const char *mapName);
dvander@2042
   111
	void OnSourceModShutdown();
ds@661
   112
public: // ITextListener_SMC
dvander@591
   113
	void ReadSMC_ParseStart();
dvander@1656
   114
	SMCResult ReadSMC_NewSection(const SMCStates *states, const char *name);
dvander@1656
   115
	SMCResult ReadSMC_KeyValue(const SMCStates *states, const char *key, const char *value);
dvander@1656
   116
	SMCResult ReadSMC_LeavingSection(const SMCStates *states);
dvander@591
   117
public:
dvander@591
   118
	void RebuildLanguageDatabase(const char *lang_header_file);
dvander@591
   119
	unsigned int FindOrAddPhraseFile(const char *phrase_file);
dvander@591
   120
	BaseStringTable *GetStringTable();
dvander@591
   121
	unsigned int GetLanguageCount();
dvander@1105
   122
	bool GetLanguageInfo(unsigned int number, const char **code, const char **name);
dvander@591
   123
	bool GetLanguageByCode(const char *code, unsigned int *index);
faluco@1352
   124
	bool GetLanguageByName(const char *name, unsigned int *index);
dvander@591
   125
	CPhraseFile *GetFileByIndex(unsigned int index);
dvander@2042
   126
public: //ITranslator
dvander@2042
   127
	unsigned int GetServerLanguage();
dvander@2042
   128
	unsigned int GetClientLanguage(int client);
dvander@2042
   129
	const char *GetInterfaceName();
dvander@2042
   130
	unsigned int GetInterfaceVersion();
dvander@2042
   131
	IPhraseCollection *CreatePhraseCollection();
dvander@2042
   132
	int SetGlobalTarget(int index);
dvander@2042
   133
	int GetGlobalTarget() const;
dvander@2042
   134
	size_t FormatString(
dvander@1925
   135
		char *buffer, 
dvander@1925
   136
		size_t maxlength, 
dvander@2042
   137
		SourcePawn::IPluginContext *pContext,
dvander@2042
   138
		const cell_t *params,
dvander@2042
   139
		unsigned int param);
dvander@2042
   140
	bool FormatString(
dvander@2042
   141
		char *buffer,
dvander@2042
   142
		size_t maxlength,
dvander@2042
   143
		const char *format,
dvander@2042
   144
		IPhraseCollection *pPhrases,
dvander@2042
   145
		void **params,
dvander@2042
   146
		unsigned int numparams,
dvander@2042
   147
		size_t *pOutLength,
dvander@2042
   148
		const char **pFailPhrase);
dvander@591
   149
private:
dvander@591
   150
	bool AddLanguage(const char *langcode, const char *description);
dvander@591
   151
private:
dvander@591
   152
	CVector<Language *> m_Languages;
dvander@591
   153
	CVector<CPhraseFile *> m_Files;
dvander@591
   154
	BaseStringTable *m_pStringTab;
dvander@3004
   155
	KTrie<unsigned int> m_LCodeLookup;
fyrenmoo@3291
   156
	KTrie<unsigned int> m_LAliases;
dvander@591
   157
	bool m_InLanguageSection;
dvander@591
   158
	String m_CustomError;
ds@669
   159
	unsigned int m_ServerLang;
dvander@2478
   160
	char m_InitialLang[4];
dvander@591
   161
};
dvander@591
   162
dvander@2042
   163
/* Nice little wrapper to handle error logging and whatnot */
dvander@2042
   164
bool CoreTranslate(char *buffer, 
dvander@2042
   165
				   size_t maxlength,
dvander@2042
   166
				   const char *format,
dvander@2042
   167
				   unsigned int numparams,
dvander@2042
   168
				   size_t *pOutLength,
dvander@2042
   169
				   ...);
dvander@2042
   170
dvander@2042
   171
extern IPhraseCollection *g_pCorePhrases;
dvander@1621
   172
extern unsigned int g_pCorePhraseID;
dvander@616
   173
extern Translator g_Translator;
dvander@591
   174
dvander@591
   175
#endif //_INCLUDE_SOURCEMOD_TRANSLATOR_H_
dvander@3004
   176