ReactOS 0.4.15-dev-8227-g32d615f
ftwinfnt.h
Go to the documentation of this file.
1/***************************************************************************/
2/* */
3/* ftwinfnt.h */
4/* */
5/* FreeType API for accessing Windows fnt-specific data. */
6/* */
7/* Copyright 2003-2018 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
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
62 * ftp://ftp.unicode.org/Public in the MAPPINGS/VENDORS/MICSFT/WINDOWS
63 * subdirectory. cp1361 is roughly a superset of
64 * MAPPINGS/OBSOLETE/EASTASIA/KSC/JOHAB.TXT.
65 *
66 * @values:
67 * FT_WinFNT_ID_DEFAULT ::
68 * This is used for font enumeration and font creation as a
69 * `don't care' value. Valid font files don't contain this value.
70 * When querying for information about the character set of the font
71 * that is currently selected into a specified device context, this
72 * return value (of the related Windows API) simply denotes failure.
73 *
74 * FT_WinFNT_ID_SYMBOL ::
75 * There is no known mapping table available.
76 *
77 * FT_WinFNT_ID_MAC ::
78 * Mac Roman encoding.
79 *
80 * FT_WinFNT_ID_OEM ::
81 * From Michael Poettgen <michael@poettgen.de>:
82 *
83 * The `Windows Font Mapping' article says that FT_WinFNT_ID_OEM
84 * is used for the charset of vector fonts, like `modern.fon',
85 * `roman.fon', and `script.fon' on Windows.
86 *
87 * The `CreateFont' documentation says: The FT_WinFNT_ID_OEM value
88 * specifies a character set that is operating-system dependent.
89 *
90 * The `IFIMETRICS' documentation from the `Windows Driver
91 * Development Kit' says: This font supports an OEM-specific
92 * character set. The OEM character set is system dependent.
93 *
94 * In general OEM, as opposed to ANSI (i.e., cp1252), denotes the
95 * second default codepage that most international versions of
96 * Windows have. It is one of the OEM codepages from
97 *
98 * https://msdn.microsoft.com/en-us/goglobal/bb964655,
99 *
100 * and is used for the `DOS boxes', to support legacy applications.
101 * A German Windows version for example usually uses ANSI codepage
102 * 1252 and OEM codepage 850.
103 *
104 * FT_WinFNT_ID_CP874 ::
105 * A superset of Thai TIS 620 and ISO 8859-11.
106 *
107 * FT_WinFNT_ID_CP932 ::
108 * A superset of Japanese Shift-JIS (with minor deviations).
109 *
110 * FT_WinFNT_ID_CP936 ::
111 * A superset of simplified Chinese GB 2312-1980 (with different
112 * ordering and minor deviations).
113 *
114 * FT_WinFNT_ID_CP949 ::
115 * A superset of Korean Hangul KS~C 5601-1987 (with different
116 * ordering and minor deviations).
117 *
118 * FT_WinFNT_ID_CP950 ::
119 * A superset of traditional Chinese Big~5 ETen (with different
120 * ordering and minor deviations).
121 *
122 * FT_WinFNT_ID_CP1250 ::
123 * A superset of East European ISO 8859-2 (with slightly different
124 * ordering).
125 *
126 * FT_WinFNT_ID_CP1251 ::
127 * A superset of Russian ISO 8859-5 (with different ordering).
128 *
129 * FT_WinFNT_ID_CP1252 ::
130 * ANSI encoding. A superset of ISO 8859-1.
131 *
132 * FT_WinFNT_ID_CP1253 ::
133 * A superset of Greek ISO 8859-7 (with minor modifications).
134 *
135 * FT_WinFNT_ID_CP1254 ::
136 * A superset of Turkish ISO 8859-9.
137 *
138 * FT_WinFNT_ID_CP1255 ::
139 * A superset of Hebrew ISO 8859-8 (with some modifications).
140 *
141 * FT_WinFNT_ID_CP1256 ::
142 * A superset of Arabic ISO 8859-6 (with different ordering).
143 *
144 * FT_WinFNT_ID_CP1257 ::
145 * A superset of Baltic ISO 8859-13 (with some deviations).
146 *
147 * FT_WinFNT_ID_CP1258 ::
148 * For Vietnamese. This encoding doesn't cover all necessary
149 * characters.
150 *
151 * FT_WinFNT_ID_CP1361 ::
152 * Korean (Johab).
153 */
154
155#define FT_WinFNT_ID_CP1252 0
156#define FT_WinFNT_ID_DEFAULT 1
157#define FT_WinFNT_ID_SYMBOL 2
158#define FT_WinFNT_ID_MAC 77
159#define FT_WinFNT_ID_CP932 128
160#define FT_WinFNT_ID_CP949 129
161#define FT_WinFNT_ID_CP1361 130
162#define FT_WinFNT_ID_CP936 134
163#define FT_WinFNT_ID_CP950 136
164#define FT_WinFNT_ID_CP1253 161
165#define FT_WinFNT_ID_CP1254 162
166#define FT_WinFNT_ID_CP1258 163
167#define FT_WinFNT_ID_CP1255 177
168#define FT_WinFNT_ID_CP1256 178
169#define FT_WinFNT_ID_CP1257 186
170#define FT_WinFNT_ID_CP1251 204
171#define FT_WinFNT_ID_CP874 222
172#define FT_WinFNT_ID_CP1250 238
173#define FT_WinFNT_ID_OEM 255
174
175
176 /*************************************************************************/
177 /* */
178 /* <Struct> */
179 /* FT_WinFNT_HeaderRec */
180 /* */
181 /* <Description> */
182 /* Windows FNT Header info. */
183 /* */
184 typedef struct FT_WinFNT_HeaderRec_
185 {
222
224
225
226 /*************************************************************************/
227 /* */
228 /* <Struct> */
229 /* FT_WinFNT_Header */
230 /* */
231 /* <Description> */
232 /* A handle to an @FT_WinFNT_HeaderRec structure. */
233 /* */
235
236
237 /**********************************************************************
238 *
239 * @function:
240 * FT_Get_WinFNT_Header
241 *
242 * @description:
243 * Retrieve a Windows FNT font info header.
244 *
245 * @input:
246 * face :: A handle to the input face.
247 *
248 * @output:
249 * aheader :: The WinFNT header.
250 *
251 * @return:
252 * FreeType error code. 0~means success.
253 *
254 * @note:
255 * This function only works with Windows FNT faces, returning an error
256 * otherwise.
257 */
260 FT_WinFNT_HeaderRec *aheader );
261
262 /* */
263
264
266
267#endif /* FTWINFNT_H_ */
268
269
270/* END */
271
272
273/* Local Variables: */
274/* coding: utf-8 */
275/* End: */
#define FT_EXPORT(x)
Definition: ftconfig.h:461
#define FT_END_HEADER
Definition: ftheader.h:54
#define FT_BEGIN_HEADER
Definition: ftheader.h:36
unsigned long FT_ULong
Definition: fttypes.h:253
unsigned char FT_Byte
Definition: fttypes.h:154
int FT_Error
Definition: fttypes.h:300
unsigned short FT_UShort
Definition: fttypes.h:209
struct FT_WinFNT_HeaderRec_ FT_WinFNT_HeaderRec
struct FT_WinFNT_HeaderRec_ * FT_WinFNT_Header
Definition: ftwinfnt.h:234
FT_Get_WinFNT_Header(FT_Face face, FT_WinFNT_HeaderRec *aheader)
Definition: ftwinfnt.c:29
GLenum GLuint GLint GLenum face
Definition: glext.h:7025
FT_UShort horizontal_resolution
Definition: ftwinfnt.h:192
FT_UShort file_type
Definition: ftwinfnt.h:189
FT_UShort C_space
Definition: ftwinfnt.h:219
FT_Byte pitch_and_family
Definition: ftwinfnt.h:203
FT_Byte copyright[60]
Definition: ftwinfnt.h:188
FT_Byte default_char
Definition: ftwinfnt.h:208
FT_UShort internal_leading
Definition: ftwinfnt.h:194
FT_UShort avg_width
Definition: ftwinfnt.h:204
FT_UShort color_table_offset
Definition: ftwinfnt.h:220
FT_UShort external_leading
Definition: ftwinfnt.h:195
FT_UShort version
Definition: ftwinfnt.h:186
FT_UShort nominal_point_size
Definition: ftwinfnt.h:190
FT_UShort ascent
Definition: ftwinfnt.h:193
FT_UShort weight
Definition: ftwinfnt.h:199
FT_UShort max_width
Definition: ftwinfnt.h:205
FT_UShort B_space
Definition: ftwinfnt.h:218
FT_ULong bits_pointer
Definition: ftwinfnt.h:213
FT_ULong face_name_offset
Definition: ftwinfnt.h:212
FT_UShort pixel_height
Definition: ftwinfnt.h:202
FT_ULong bits_offset
Definition: ftwinfnt.h:214
FT_ULong device_offset
Definition: ftwinfnt.h:211
FT_UShort bytes_per_row
Definition: ftwinfnt.h:210
FT_UShort vertical_resolution
Definition: ftwinfnt.h:191
FT_UShort A_space
Definition: ftwinfnt.h:217
FT_ULong file_size
Definition: ftwinfnt.h:187
FT_UShort pixel_width
Definition: ftwinfnt.h:201
FT_ULong reserved1[4]
Definition: ftwinfnt.h:221