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 Pttgen <michael (at) 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: */ 275
