[692] | 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 */
|
---|