| OLD | NEW |
| (Empty) |
| 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 "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: */ | |
| OLD | NEW |