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: */ |
|