1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
|
/*
* Copyright (C) Volition, Inc. 1999. All rights reserved.
*
* All source code herein is the property of Volition, Inc. You may not sell
* or otherwise commercially exploit the source or things you created based on the
* source.
*
*/
#ifndef __FREESPACE2_LOCALIZATION_UTILITIES_HEADER_FILE
#define __FREESPACE2_LOCALIZATION_UTILITIES_HEADER_FILE
#include "globalincs/pstypes.h"
#include "graphics/font.h"
// ------------------------------------------------------------------------------------------------------------
// LOCALIZE DEFINES/VARS
//
// language defines
#define LCL_ENGLISH 0
#define LCL_GERMAN 1
#define LCL_FRENCH 2
#define LCL_POLISH 3
#define FS2_OPEN_DEFAULT_LANGUAGE 0
// for language name strings
#define LCL_LANG_NAME_LEN 32
// language info table
typedef struct lang_info {
char lang_name[LCL_LANG_NAME_LEN + 1]; // literal name of the language
char lang_ext[LCL_LANG_NAME_LEN + 1]; // the extension used for adding to names on disk access
ubyte special_char_indexes[MAX_FONTS]; // where in the font do we have the special characters for this language
// note: treats 0 as "none" since a zero offset in a font makes no sense
// i.e. all the normal chars start at zero
int checksum; // used for language auto-detection
} lang_info;
// These are the original languages supported by FS2. The code expects these languages to be supported even if the tables don't
#define NUM_BUILTIN_LANGUAGES 4
extern lang_info Lcl_builtin_languages[NUM_BUILTIN_LANGUAGES];
extern SCP_vector<lang_info> Lcl_languages;
// following is the offset where special characters start in our font
extern int Lcl_special_chars;
// use these to replace *_BUILD values
// only 1 will be active at a time
extern int Lcl_fr;
extern int Lcl_gr;
extern int Lcl_pl;
extern int Lcl_english;
// ------------------------------------------------------------------------------------------------------------
// LOCALIZE FUNCTIONS
//
// initialize localization, if no language is passed - use the language specified in the registry
void lcl_init(int lang = -1);
// shutdown localization
void lcl_close();
// initialize the xstr table
void lcl_xstr_init();
// free the xstr table
void lcl_xstr_close();
// determine what language we're running in, see LCL_* defines above
int lcl_get_language();
// returns the current language character string
void lcl_get_language_name(char *lang_name);
// set our current language
void lcl_set_language(int lang);
// get a fonts special characters index
ubyte lcl_get_font_index(int font_num);
// NOTE : generally you should only care about the above functions. Below are very low level functions
// which should already be well entrenched in FreeSpace. If you think you need to use one of the below
// functions - ask first :)
// externalization of table/mission files (only parse routines ever need to deal with these functions) -----------------------
// maybe add on an appropriate subdirectory when opening a localized file
void lcl_add_dir(char *current_path);
// maybe add localized directory to full path with file name when opening a localized file
int lcl_add_dir_to_path_with_filename(char *current_path, size_t path_max);
// Goober5000
void lcl_replace_stuff(char *text, size_t max_len);
void lcl_replace_stuff(SCP_string &text);
// Karajorma
void lcl_fred_replace_stuff(char *text, size_t max_len);
void lcl_fred_replace_stuff(SCP_string &text);
// get the localized version of the string. if none exists, return the original string
// valid input to this function includes :
// "this is some text"
// XSTR("wheeee", -1)
// XSTR("whee", 20)
// and these should cover all the externalized string cases
// fills in id if non-NULL. a value of -2 indicates it is not an external string
void lcl_ext_localize(const char *in, char *out, size_t max_len, int *id = NULL);
void lcl_ext_localize(const SCP_string &in, SCP_string &out, int *id = NULL);
// translate the specified string based upon the current language
const char *XSTR(const char *str, int index);
int lcl_get_xstr_offset(int index, int res);
void lcl_translate_wep_name_gr(char *name);
void lcl_translate_ship_name_gr(char *name);
void lcl_translate_brief_icon_name_gr(char *name);
void lcl_translate_brief_icon_name_pl(char *name);
void lcl_translate_targetbox_name_gr(char *name);
void lcl_translate_targetbox_name_pl(char *name);
void lcl_translate_medal_name_gr(char *name);
void lcl_translate_medal_name_pl(char *name);
#endif // defined __FREESPACE2_LOCALIZATION_UTILITIES_HEADER_FILE
|
