Details | Last modification | View Log | RSS feed
Rev | Author | Line No. | Line |
---|---|---|---|
4759 | right-hear | 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 |
||
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 | /* |
||
38 | /* winfnt_fonts */ |
||
39 | /* */ |
||
40 | /* |
||
41 | /* Window FNT Files */ |
||
42 | /* */ |
||
43 | /* |
||
44 | /* Windows FNT specific API. */ |
||
45 | /* */ |
||
46 | /* |
||
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 |
||
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 | /* |
||
178 | /* FT_WinFNT_HeaderRec */ |
||
179 | /* */ |
||
180 | /* |
||
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 | /* |
||
228 | /* FT_WinFNT_Header */ |
||
229 | /* */ |
||
230 | /* |
||
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: */ |