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
131
132
133
|
/*
* 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"
// ------------------------------------------------------------------------------------------------------------
// LOCALIZE DEFINES/VARS
//
// language defines
#define LCL_NUM_LANGUAGES 4 // keep this up to date
#define LCL_ENGLISH 0
#define LCL_GERMAN 1
#define LCL_FRENCH 2
#define LCL_POLISH 3
#define LCL_DEFAULT_LANGUAGE LCL_ENGLISH
// following is the offset where special characters start in our font
extern int Lcl_special_chars;
// for language name strings
#define LCL_LANG_NAME_LEN 32
// 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);
// 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, uint path_max);
// open the externalization file for use during parsing (call before parsing a given file)
void lcl_ext_open();
// close the externalization file (call after parsing a given file)
void lcl_ext_close();
// Goober5000
void lcl_replace_stuff(char *text, unsigned int max_len);
void lcl_replace_stuff(SCP_string &text);
// Karajorma
void lcl_fred_replace_stuff(char *text, unsigned int 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(char *in, char *out, int max_len, int *id = NULL);
void lcl_ext_localize(SCP_string &in, SCP_string &out, int *id = NULL);
// translate the specified string based upon the current language
char *XSTR(char *str, int index);
int lcl_get_xstr_offset(int index, int res);
// translate umlauted chars from ascii to ansi codes
// used in launcher
#define LCL_TO_ANSI 0
#define LCL_TO_ASCII 1
char* lcl_fix_umlauts(char *str, int which_way);
// covert some polish characters
void lcl_fix_polish(char *str);
void lcl_fix_polish(SCP_string &str);
// macro for launcher xstrs
#if defined(GERMAN_BUILD)
#define LXSTR(str, i) (lcl_fix_umlauts(XSTR(str, i), LCL_TO_ANSI))
#else
#define LXSTR(str, i) (XSTR(str, i))
#endif // defined(GERMAN_BUILD)
void lcl_translate_wep_name(char *name);
void lcl_translate_ship_name(char *name);
void lcl_translate_brief_icon_name(char *name);
void lcl_translate_brief_icon_name_pl(char *name);
void lcl_translate_targetbox_name(char *name);
void lcl_translate_targetbox_name_pl(char *name);
#endif // defined __FREESPACE2_LOCALIZATION_UTILITIES_HEADER_FILE
|
