← Back to branch summary

~ubuntu-branches/ubuntu/vivid/emscripten/vivid

« back to all changes in this revision

Viewing changes to tests/freetype/include/freetype/ftwinfnt.h

  • Committer: Package Import Robot
  • Author(s): Sylvestre Ledru
  • Date: 2013-05-02 13:11:51 UTC
  • Revision ID: package-import@ubuntu.com-20130502131151-q8dvteqr1ef2x7xz
Tags: upstream-1.4.1~20130504~adb56cb
Import upstream version 1.4.1~20130504~adb56cb

Show diffs side-by-side

added added

removed removed

Lines of Context:
tests/freetype/include/freetype/ftwinfnt.h
 
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:             */