1 | /***************************************************************************/
|
---|
2 | /* */
|
---|
3 | /* ftwinfnt.h */
|
---|
4 | /* */
|
---|
5 | /* FreeType API for accessing Windows fnt-specific data. */
|
---|
6 | /* */
|
---|
7 | /* Copyright 2003, 2004 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 | * The `Windows Font Mapping' article says that FT_WinFNT_ID_OEM
|
---|
82 | * is used for the charset of vector fonts, like `modern.fon',
|
---|
83 | * `roman.fon', and `script.fon' on Windows.
|
---|
84 | *
|
---|
85 | * The `CreateFont' documentation says: The FT_WinFNT_ID_OEM value
|
---|
86 | * specifies a character set that is operating-system dependent.
|
---|
87 | *
|
---|
88 | * The `IFIMETRICS' documentation from the `Windows Driver
|
---|
89 | * Development Kit' says: This font supports an OEM-specific
|
---|
90 | * character set. The OEM character set is system dependent.
|
---|
91 | *
|
---|
92 | * In general OEM, as opposed to ANSI (i.e., cp1252), denotes the
|
---|
93 | * second default codepage that most international versions of
|
---|
94 | * Windows have. It is one of the OEM codepages from
|
---|
95 | *
|
---|
96 | * http://www.microsoft.com/globaldev/reference/cphome.mspx,
|
---|
97 | *
|
---|
98 | * and is used for the `DOS boxes', to support legacy applications.
|
---|
99 | * A German Windows version for example usually uses ANSI codepage
|
---|
100 | * 1252 and OEM codepage 850.
|
---|
101 | *
|
---|
102 | * FT_WinFNT_ID_CP874 ::
|
---|
103 | * A superset of Thai TIS 620 and ISO 8859-11.
|
---|
104 | *
|
---|
105 | * FT_WinFNT_ID_CP932 ::
|
---|
106 | * A superset of Japanese Shift-JIS (with minor deviations).
|
---|
107 | *
|
---|
108 | * FT_WinFNT_ID_CP936 ::
|
---|
109 | * A superset of simplified Chinese GB 2312-1980 (with different
|
---|
110 | * ordering and minor deviations).
|
---|
111 | *
|
---|
112 | * FT_WinFNT_ID_CP949 ::
|
---|
113 | * A superset of Korean Hangul KS C 5601-1987 (with different
|
---|
114 | * ordering and minor deviations).
|
---|
115 | *
|
---|
116 | * FT_WinFNT_ID_CP950 ::
|
---|
117 | * A superset of traditional Chinese Big 5 ETen (with different
|
---|
118 | * ordering and minor deviations).
|
---|
119 | *
|
---|
120 | * FT_WinFNT_ID_CP1250 ::
|
---|
121 | * A superset of East European ISO 8859-2 (with slightly different
|
---|
122 | * ordering).
|
---|
123 | *
|
---|
124 | * FT_WinFNT_ID_CP1251 ::
|
---|
125 | * A superset of Russian ISO 8859-5 (with different ordering).
|
---|
126 | *
|
---|
127 | * FT_WinFNT_ID_CP1252 ::
|
---|
128 | * ANSI encoding. A superset of ISO 8859-1.
|
---|
129 | *
|
---|
130 | * FT_WinFNT_ID_CP1253 ::
|
---|
131 | * A superset of Greek ISO 8859-7 (with minor modifications).
|
---|
132 | *
|
---|
133 | * FT_WinFNT_ID_CP1254 ::
|
---|
134 | * A superset of Turkish ISO 8859-9.
|
---|
135 | *
|
---|
136 | * FT_WinFNT_ID_CP1255 ::
|
---|
137 | * A superset of Hebrew ISO 8859-8 (with some modifications).
|
---|
138 | *
|
---|
139 | * FT_WinFNT_ID_CP1256 ::
|
---|
140 | * A superset of Arabic ISO 8859-6 (with different ordering).
|
---|
141 | *
|
---|
142 | * FT_WinFNT_ID_CP1257 ::
|
---|
143 | * A superset of Baltic ISO 8859-13 (with some deviations).
|
---|
144 | *
|
---|
145 | * FT_WinFNT_ID_CP1258 ::
|
---|
146 | * For Vietnamese. This encoding doesn't cover all necessary
|
---|
147 | * characters.
|
---|
148 | *
|
---|
149 | * FT_WinFNT_ID_CP1361 ::
|
---|
150 | * Korean (Johab).
|
---|
151 | */
|
---|
152 |
|
---|
153 | #define FT_WinFNT_ID_CP1252 0
|
---|
154 | #define FT_WinFNT_ID_DEFAULT 1
|
---|
155 | #define FT_WinFNT_ID_SYMBOL 2
|
---|
156 | #define FT_WinFNT_ID_MAC 77
|
---|
157 | #define FT_WinFNT_ID_CP932 128
|
---|
158 | #define FT_WinFNT_ID_CP949 129
|
---|
159 | #define FT_WinFNT_ID_CP1361 130
|
---|
160 | #define FT_WinFNT_ID_CP936 134
|
---|
161 | #define FT_WinFNT_ID_CP950 136
|
---|
162 | #define FT_WinFNT_ID_CP1253 161
|
---|
163 | #define FT_WinFNT_ID_CP1254 162
|
---|
164 | #define FT_WinFNT_ID_CP1258 163
|
---|
165 | #define FT_WinFNT_ID_CP1255 177
|
---|
166 | #define FT_WinFNT_ID_CP1256 178
|
---|
167 | #define FT_WinFNT_ID_CP1257 186
|
---|
168 | #define FT_WinFNT_ID_CP1251 204
|
---|
169 | #define FT_WinFNT_ID_CP874 222
|
---|
170 | #define FT_WinFNT_ID_CP1250 238
|
---|
171 | #define FT_WinFNT_ID_OEM 255
|
---|
172 |
|
---|
173 |
|
---|
174 | /*************************************************************************/
|
---|
175 | /* */
|
---|
176 | /* <Struct> */
|
---|
177 | /* FT_WinFNT_HeaderRec */
|
---|
178 | /* */
|
---|
179 | /* <Description> */
|
---|
180 | /* Windows FNT Header info. */
|
---|
181 | /* */
|
---|
182 | typedef struct FT_WinFNT_HeaderRec_
|
---|
183 | {
|
---|
184 | FT_UShort version;
|
---|
185 | FT_ULong file_size;
|
---|
186 | FT_Byte copyright[60];
|
---|
187 | FT_UShort file_type;
|
---|
188 | FT_UShort nominal_point_size;
|
---|
189 | FT_UShort vertical_resolution;
|
---|
190 | FT_UShort horizontal_resolution;
|
---|
191 | FT_UShort ascent;
|
---|
192 | FT_UShort internal_leading;
|
---|
193 | FT_UShort external_leading;
|
---|
194 | FT_Byte italic;
|
---|
195 | FT_Byte underline;
|
---|
196 | FT_Byte strike_out;
|
---|
197 | FT_UShort weight;
|
---|
198 | FT_Byte charset;
|
---|
199 | FT_UShort pixel_width;
|
---|
200 | FT_UShort pixel_height;
|
---|
201 | FT_Byte pitch_and_family;
|
---|
202 | FT_UShort avg_width;
|
---|
203 | FT_UShort max_width;
|
---|
204 | FT_Byte first_char;
|
---|
205 | FT_Byte last_char;
|
---|
206 | FT_Byte default_char;
|
---|
207 | FT_Byte break_char;
|
---|
208 | FT_UShort bytes_per_row;
|
---|
209 | FT_ULong device_offset;
|
---|
210 | FT_ULong face_name_offset;
|
---|
211 | FT_ULong bits_pointer;
|
---|
212 | FT_ULong bits_offset;
|
---|
213 | FT_Byte reserved;
|
---|
214 | FT_ULong flags;
|
---|
215 | FT_UShort A_space;
|
---|
216 | FT_UShort B_space;
|
---|
217 | FT_UShort C_space;
|
---|
218 | FT_UShort color_table_offset;
|
---|
219 | FT_ULong reserved1[4];
|
---|
220 |
|
---|
221 | } FT_WinFNT_HeaderRec, *FT_WinFNT_Header;
|
---|
222 |
|
---|
223 |
|
---|
224 | /**********************************************************************
|
---|
225 | *
|
---|
226 | * @function:
|
---|
227 | * FT_Get_WinFNT_Header
|
---|
228 | *
|
---|
229 | * @description:
|
---|
230 | * Retrieve a Windows FNT font info header.
|
---|
231 | *
|
---|
232 | * @input:
|
---|
233 | * face :: A handle to the input face.
|
---|
234 | *
|
---|
235 | * @output:
|
---|
236 | * aheader :: The WinFNT header.
|
---|
237 | *
|
---|
238 | * @return:
|
---|
239 | * FreeType error code. 0 means success.
|
---|
240 | *
|
---|
241 | * @note:
|
---|
242 | * This function only works with Windows FNT faces, returning an error
|
---|
243 | * otherwise.
|
---|
244 | */
|
---|
245 | FT_EXPORT( FT_Error )
|
---|
246 | FT_Get_WinFNT_Header( FT_Face face,
|
---|
247 | FT_WinFNT_HeaderRec *aheader );
|
---|
248 |
|
---|
249 |
|
---|
250 | /* */
|
---|
251 |
|
---|
252 | FT_END_HEADER
|
---|
253 |
|
---|
254 | #endif /* __FTWINFNT_H__ */
|
---|
255 |
|
---|
256 |
|
---|
257 | /* END */
|
---|