core/Translator.h
author Scott Ehlert <ds@alliedmods.net>
Wed Feb 25 23:17:37 2009 -0600 (2009-02-25)
changeset 2617 253d6b4f15ab
parent 2478 1899f97aded6
permissions -rw-r--r--
Merged changes from 1.1
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@591
    35
#include "sm_trie.h"
dvander@591
    36
#include <sh_string.h>
dvander@591
    37
#include <sh_vector.h>
dvander@591
    38
#include "sm_globals.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
#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@2478
    60
	char m_code2[4];
dvander@591
    61
	int m_FullName;
dvander@591
    62
};
dvander@591
    63
dvander@2042
    64
class CPhraseFile : 
dvander@2042
    65
	public ITextListener_SMC,
dvander@2042
    66
	public IPhraseFile
dvander@591
    67
{
dvander@591
    68
public:
dvander@616
    69
	CPhraseFile(Translator *pTranslator, const char *file);
dvander@591
    70
	~CPhraseFile();
dvander@591
    71
public:
dvander@591
    72
	void ReparseFile();
dvander@591
    73
	const char *GetFilename();
dvander@591
    74
	TransError GetTranslation(const char *szPhrase, unsigned int lang_id, Translation *pTrans);
dvander@591
    75
public: //ITextListener_SMC
dvander@591
    76
	void ReadSMC_ParseStart();
dvander@1656
    77
	SMCResult ReadSMC_NewSection(const SMCStates *states, const char *name);
dvander@1656
    78
	SMCResult ReadSMC_KeyValue(const SMCStates *states, const char *key, const char *value);
dvander@1656
    79
	SMCResult ReadSMC_LeavingSection(const SMCStates *states);
dvander@591
    80
	void ReadSMC_ParseEnd(bool halted, bool failed);
dvander@591
    81
private:
dvander@591
    82
	void ParseError(const char *message, ...);
dvander@591
    83
	void ParseWarning(const char *message, ...);
dvander@591
    84
private:
dvander@591
    85
	Trie *m_pPhraseLookup;
dvander@591
    86
	String m_File;
dvander@616
    87
	Translator *m_pTranslator;
dvander@591
    88
	PhraseParseState m_ParseState;
dvander@591
    89
	int m_CurPhrase;
dvander@591
    90
	BaseMemTable *m_pMemory;
dvander@591
    91
	BaseStringTable *m_pStringTab;
dvander@591
    92
	unsigned int m_LangCount;
dvander@591
    93
	String m_ParseError;
dvander@591
    94
	String m_LastPhraseString;
dvander@591
    95
	bool m_FileLogged;
dvander@591
    96
};
dvander@591
    97
dvander@616
    98
class Translator : 
dvander@591
    99
	public ITextListener_SMC,
dvander@2042
   100
	public SMGlobalClass,
dvander@2042
   101
	public ITranslator
dvander@591
   102
{
dvander@591
   103
public:
dvander@616
   104
	Translator();
dvander@616
   105
	~Translator();
ds@661
   106
public: // SMGlobalClass
dvander@663
   107
	ConfigResult OnSourceModConfigChanged(const char *key, 
dvander@663
   108
		const char *value, 
dvander@663
   109
		ConfigSource source, 
dvander@663
   110
		char *error, 
dvander@663
   111
		size_t maxlength);
dvander@591
   112
	void OnSourceModAllInitialized();
dvander@673
   113
	void OnSourceModLevelChange(const char *mapName);
dvander@2042
   114
	void OnSourceModShutdown();
ds@661
   115
public: // ITextListener_SMC
dvander@591
   116
	void ReadSMC_ParseStart();
dvander@1656
   117
	SMCResult ReadSMC_NewSection(const SMCStates *states, const char *name);
dvander@1656
   118
	SMCResult ReadSMC_KeyValue(const SMCStates *states, const char *key, const char *value);
dvander@1656
   119
	SMCResult ReadSMC_LeavingSection(const SMCStates *states);
dvander@591
   120
public:
dvander@591
   121
	void RebuildLanguageDatabase(const char *lang_header_file);
dvander@591
   122
	unsigned int FindOrAddPhraseFile(const char *phrase_file);
dvander@591
   123
	BaseStringTable *GetStringTable();
dvander@591
   124
	unsigned int GetLanguageCount();
dvander@1105
   125
	bool GetLanguageInfo(unsigned int number, const char **code, const char **name);
dvander@591
   126
	bool GetLanguageByCode(const char *code, unsigned int *index);
faluco@1352
   127
	bool GetLanguageByName(const char *name, unsigned int *index);
dvander@591
   128
	CPhraseFile *GetFileByIndex(unsigned int index);
dvander@2042
   129
public: //ITranslator
dvander@2042
   130
	unsigned int GetServerLanguage();
dvander@2042
   131
	unsigned int GetClientLanguage(int client);
dvander@2042
   132
	const char *GetInterfaceName();
dvander@2042
   133
	unsigned int GetInterfaceVersion();
dvander@2042
   134
	IPhraseCollection *CreatePhraseCollection();
dvander@2042
   135
	int SetGlobalTarget(int index);
dvander@2042
   136
	int GetGlobalTarget() const;
dvander@2042
   137
	size_t FormatString(
dvander@1925
   138
		char *buffer, 
dvander@1925
   139
		size_t maxlength, 
dvander@2042
   140
		SourcePawn::IPluginContext *pContext,
dvander@2042
   141
		const cell_t *params,
dvander@2042
   142
		unsigned int param);
dvander@2042
   143
	bool FormatString(
dvander@2042
   144
		char *buffer,
dvander@2042
   145
		size_t maxlength,
dvander@2042
   146
		const char *format,
dvander@2042
   147
		IPhraseCollection *pPhrases,
dvander@2042
   148
		void **params,
dvander@2042
   149
		unsigned int numparams,
dvander@2042
   150
		size_t *pOutLength,
dvander@2042
   151
		const char **pFailPhrase);
dvander@591
   152
private:
dvander@591
   153
	bool AddLanguage(const char *langcode, const char *description);
dvander@591
   154
private:
dvander@591
   155
	CVector<Language *> m_Languages;
dvander@591
   156
	CVector<CPhraseFile *> m_Files;
dvander@591
   157
	BaseStringTable *m_pStringTab;
dvander@591
   158
	Trie *m_pLCodeLookup;
dvander@591
   159
	bool m_InLanguageSection;
dvander@591
   160
	String m_CustomError;
ds@669
   161
	unsigned int m_ServerLang;
dvander@2478
   162
	char m_InitialLang[4];
dvander@591
   163
};
dvander@591
   164
dvander@2042
   165
/* Nice little wrapper to handle error logging and whatnot */
dvander@2042
   166
bool CoreTranslate(char *buffer, 
dvander@2042
   167
				   size_t maxlength,
dvander@2042
   168
				   const char *format,
dvander@2042
   169
				   unsigned int numparams,
dvander@2042
   170
				   size_t *pOutLength,
dvander@2042
   171
				   ...);
dvander@2042
   172
dvander@2042
   173
extern IPhraseCollection *g_pCorePhrases;
dvander@1621
   174
extern unsigned int g_pCorePhraseID;
dvander@616
   175
extern Translator g_Translator;
dvander@591
   176
dvander@591
   177
#endif //_INCLUDE_SOURCEMOD_TRANSLATOR_H_