]>
Commit | Line | Data |
---|---|---|
7407ac7f BB |
1 | /***************************************************************************/ |
2 | /* */ | |
3 | /* ftwinfnt.h */ | |
4 | /* */ | |
5 | /* FreeType API for accessing Windows fnt-specific data. */ | |
6 | /* */ | |
7 | /* Copyright 2003, 2004, 2008 by */ | |
8 | /* David Turner, Robert Wilhelm, and Werner Lemberg. */ | |
9 | /* */ | |
10 | /* This file is part of the FreeType project, and may only be used, */ | |
11 | /* modified, and distributed under the terms of the FreeType project */ | |
12 | /* license, LICENSE.TXT. By continuing to use, modify, or distribute */ | |
13 | /* this file you indicate that you have read the license and */ | |
14 | /* understand and accept it fully. */ | |
15 | /* */ | |
16 | /***************************************************************************/ | |
17 | ||
18 | ||
19 | #ifndef __FTWINFNT_H__ | |
20 | #define __FTWINFNT_H__ | |
21 | ||
22 | #include <ft2build.h> | |
23 | #include FT_FREETYPE_H | |
24 | ||
25 | #ifdef FREETYPE_H | |
26 | #error "freetype.h of FreeType 1 has been loaded!" | |
27 | #error "Please fix the directory search order for header files" | |
28 | #error "so that freetype.h of FreeType 2 is found first." | |
29 | #endif | |
30 | ||
31 | ||
32 | FT_BEGIN_HEADER | |
33 | ||
34 | ||
35 | /*************************************************************************/ | |
36 | /* */ | |
37 | /* <Section> */ | |
38 | /* winfnt_fonts */ | |
39 | /* */ | |
40 | /* <Title> */ | |
41 | /* Window FNT Files */ | |
42 | /* */ | |
43 | /* <Abstract> */ | |
44 | /* Windows FNT specific API. */ | |
45 | /* */ | |
46 | /* <Description> */ | |
47 | /* This section contains the declaration of Windows FNT specific */ | |
48 | /* functions. */ | |
49 | /* */ | |
50 | /*************************************************************************/ | |
51 | ||
52 | ||
53 | /************************************************************************* | |
54 | * | |
55 | * @enum: | |
56 | * FT_WinFNT_ID_XXX | |
57 | * | |
58 | * @description: | |
59 | * A list of valid values for the `charset' byte in | |
60 | * @FT_WinFNT_HeaderRec. Exact mapping tables for the various cpXXXX | |
61 | * encodings (except for cp1361) can be found at ftp://ftp.unicode.org | |
62 | * in the MAPPINGS/VENDORS/MICSFT/WINDOWS subdirectory. cp1361 is | |
63 | * roughly a superset of MAPPINGS/OBSOLETE/EASTASIA/KSC/JOHAB.TXT. | |
64 | * | |
65 | * @values: | |
66 | * FT_WinFNT_ID_DEFAULT :: | |
67 | * This is used for font enumeration and font creation as a | |
68 | * `don't care' value. Valid font files don't contain this value. | |
69 | * When querying for information about the character set of the font | |
70 | * that is currently selected into a specified device context, this | |
71 | * return value (of the related Windows API) simply denotes failure. | |
72 | * | |
73 | * FT_WinFNT_ID_SYMBOL :: | |
74 | * There is no known mapping table available. | |
75 | * | |
76 | * FT_WinFNT_ID_MAC :: | |
77 | * Mac Roman encoding. | |
78 | * | |
79 | * FT_WinFNT_ID_OEM :: | |
80 | * From Michael Pöttgen <michael@poettgen.de>: | |
81 | * | |
82 | * The `Windows Font Mapping' article says that FT_WinFNT_ID_OEM | |
83 | * is used for the charset of vector fonts, like `modern.fon', | |
84 | * `roman.fon', and `script.fon' on Windows. | |
85 | * | |
86 | * The `CreateFont' documentation says: The FT_WinFNT_ID_OEM value | |
87 | * specifies a character set that is operating-system dependent. | |
88 | * | |
89 | * The `IFIMETRICS' documentation from the `Windows Driver | |
90 | * Development Kit' says: This font supports an OEM-specific | |
91 | * character set. The OEM character set is system dependent. | |
92 | * | |
93 | * In general OEM, as opposed to ANSI (i.e., cp1252), denotes the | |
94 | * second default codepage that most international versions of | |
95 | * Windows have. It is one of the OEM codepages from | |
96 | * | |
97 | * http://www.microsoft.com/globaldev/reference/cphome.mspx, | |
98 | * | |
99 | * and is used for the `DOS boxes', to support legacy applications. | |
100 | * A German Windows version for example usually uses ANSI codepage | |
101 | * 1252 and OEM codepage 850. | |
102 | * | |
103 | * FT_WinFNT_ID_CP874 :: | |
104 | * A superset of Thai TIS 620 and ISO 8859-11. | |
105 | * | |
106 | * FT_WinFNT_ID_CP932 :: | |
107 | * A superset of Japanese Shift-JIS (with minor deviations). | |
108 | * | |
109 | * FT_WinFNT_ID_CP936 :: | |
110 | * A superset of simplified Chinese GB 2312-1980 (with different | |
111 | * ordering and minor deviations). | |
112 | * | |
113 | * FT_WinFNT_ID_CP949 :: | |
114 | * A superset of Korean Hangul KS~C 5601-1987 (with different | |
115 | * ordering and minor deviations). | |
116 | * | |
117 | * FT_WinFNT_ID_CP950 :: | |
118 | * A superset of traditional Chinese Big~5 ETen (with different | |
119 | * ordering and minor deviations). | |
120 | * | |
121 | * FT_WinFNT_ID_CP1250 :: | |
122 | * A superset of East European ISO 8859-2 (with slightly different | |
123 | * ordering). | |
124 | * | |
125 | * FT_WinFNT_ID_CP1251 :: | |
126 | * A superset of Russian ISO 8859-5 (with different ordering). | |
127 | * | |
128 | * FT_WinFNT_ID_CP1252 :: | |
129 | * ANSI encoding. A superset of ISO 8859-1. | |
130 | * | |
131 | * FT_WinFNT_ID_CP1253 :: | |
132 | * A superset of Greek ISO 8859-7 (with minor modifications). | |
133 | * | |
134 | * FT_WinFNT_ID_CP1254 :: | |
135 | * A superset of Turkish ISO 8859-9. | |
136 | * | |
137 | * FT_WinFNT_ID_CP1255 :: | |
138 | * A superset of Hebrew ISO 8859-8 (with some modifications). | |
139 | * | |
140 | * FT_WinFNT_ID_CP1256 :: | |
141 | * A superset of Arabic ISO 8859-6 (with different ordering). | |
142 | * | |
143 | * FT_WinFNT_ID_CP1257 :: | |
144 | * A superset of Baltic ISO 8859-13 (with some deviations). | |
145 | * | |
146 | * FT_WinFNT_ID_CP1258 :: | |
147 | * For Vietnamese. This encoding doesn't cover all necessary | |
148 | * characters. | |
149 | * | |
150 | * FT_WinFNT_ID_CP1361 :: | |
151 | * Korean (Johab). | |
152 | */ | |
153 | ||
154 | #define FT_WinFNT_ID_CP1252 0 | |
155 | #define FT_WinFNT_ID_DEFAULT 1 | |
156 | #define FT_WinFNT_ID_SYMBOL 2 | |
157 | #define FT_WinFNT_ID_MAC 77 | |
158 | #define FT_WinFNT_ID_CP932 128 | |
159 | #define FT_WinFNT_ID_CP949 129 | |
160 | #define FT_WinFNT_ID_CP1361 130 | |
161 | #define FT_WinFNT_ID_CP936 134 | |
162 | #define FT_WinFNT_ID_CP950 136 | |
163 | #define FT_WinFNT_ID_CP1253 161 | |
164 | #define FT_WinFNT_ID_CP1254 162 | |
165 | #define FT_WinFNT_ID_CP1258 163 | |
166 | #define FT_WinFNT_ID_CP1255 177 | |
167 | #define FT_WinFNT_ID_CP1256 178 | |
168 | #define FT_WinFNT_ID_CP1257 186 | |
169 | #define FT_WinFNT_ID_CP1251 204 | |
170 | #define FT_WinFNT_ID_CP874 222 | |
171 | #define FT_WinFNT_ID_CP1250 238 | |
172 | #define FT_WinFNT_ID_OEM 255 | |
173 | ||
174 | ||
175 | /*************************************************************************/ | |
176 | /* */ | |
177 | /* <Struct> */ | |
178 | /* FT_WinFNT_HeaderRec */ | |
179 | /* */ | |
180 | /* <Description> */ | |
181 | /* Windows FNT Header info. */ | |
182 | /* */ | |
183 | typedef struct FT_WinFNT_HeaderRec_ | |
184 | { | |
185 | FT_UShort version; | |
186 | FT_ULong file_size; | |
187 | FT_Byte copyright[60]; | |
188 | FT_UShort file_type; | |
189 | FT_UShort nominal_point_size; | |
190 | FT_UShort vertical_resolution; | |
191 | FT_UShort horizontal_resolution; | |
192 | FT_UShort ascent; | |
193 | FT_UShort internal_leading; | |
194 | FT_UShort external_leading; | |
195 | FT_Byte italic; | |
196 | FT_Byte underline; | |
197 | FT_Byte strike_out; | |
198 | FT_UShort weight; | |
199 | FT_Byte charset; | |
200 | FT_UShort pixel_width; | |
201 | FT_UShort pixel_height; | |
202 | FT_Byte pitch_and_family; | |
203 | FT_UShort avg_width; | |
204 | FT_UShort max_width; | |
205 | FT_Byte first_char; | |
206 | FT_Byte last_char; | |
207 | FT_Byte default_char; | |
208 | FT_Byte break_char; | |
209 | FT_UShort bytes_per_row; | |
210 | FT_ULong device_offset; | |
211 | FT_ULong face_name_offset; | |
212 | FT_ULong bits_pointer; | |
213 | FT_ULong bits_offset; | |
214 | FT_Byte reserved; | |
215 | FT_ULong flags; | |
216 | FT_UShort A_space; | |
217 | FT_UShort B_space; | |
218 | FT_UShort C_space; | |
219 | FT_UShort color_table_offset; | |
220 | FT_ULong reserved1[4]; | |
221 | ||
222 | } FT_WinFNT_HeaderRec; | |
223 | ||
224 | ||
225 | /*************************************************************************/ | |
226 | /* */ | |
227 | /* <Struct> */ | |
228 | /* FT_WinFNT_Header */ | |
229 | /* */ | |
230 | /* <Description> */ | |
231 | /* A handle to an @FT_WinFNT_HeaderRec structure. */ | |
232 | /* */ | |
233 | typedef struct FT_WinFNT_HeaderRec_* FT_WinFNT_Header; | |
234 | ||
235 | ||
236 | /********************************************************************** | |
237 | * | |
238 | * @function: | |
239 | * FT_Get_WinFNT_Header | |
240 | * | |
241 | * @description: | |
242 | * Retrieve a Windows FNT font info header. | |
243 | * | |
244 | * @input: | |
245 | * face :: A handle to the input face. | |
246 | * | |
247 | * @output: | |
248 | * aheader :: The WinFNT header. | |
249 | * | |
250 | * @return: | |
251 | * FreeType error code. 0~means success. | |
252 | * | |
253 | * @note: | |
254 | * This function only works with Windows FNT faces, returning an error | |
255 | * otherwise. | |
256 | */ | |
257 | FT_EXPORT( FT_Error ) | |
258 | FT_Get_WinFNT_Header( FT_Face face, | |
259 | FT_WinFNT_HeaderRec *aheader ); | |
260 | ||
261 | ||
262 | /* */ | |
263 | ||
264 | FT_END_HEADER | |
265 | ||
266 | #endif /* __FTWINFNT_H__ */ | |
267 | ||
268 | ||
269 | /* END */ | |
270 | ||
271 | ||
272 | /* Local Variables: */ | |
273 | /* coding: utf-8 */ | |
274 | /* End: */ |