kc3-lang/freetype/src/shared/sfnt.h
-
Show log
Commit
-
Hash : d42c68e8
Author :
Date : 2000-01-27T13:56:02
many new small, but important, changes there: - modified the interface of the "sfnt" module. There is now a function called "load_format_tag", and another called "load_directory". The first one is in charge of returning the 4-byte tag located at the beginning of a given font file. It understand TrueType collections and parses them automatically The second loads the table directory that is located just after the format tag. This is useful, because the "SFNT" storage scheme can be used by several distinct formats, each with its own format tag. The TrueType driver now checks the format tag in "src/truetype/ttobjs.c" - made some changes to "src/shared/t1types.h" to clearly separate the Type 1 font content from the rest of the T1_Face structure. This will be useful when adding the CFF/Type2 driver that will be able to reuse the "T1_Font" structure within a "TT_Font" one (which really describes a SFNT-based font file). Some changes in "src/type1" were thus performed to reflect this. Note that the current type1 driver will be discontinued in a distant future. More on this later..
-
src/shared/sfnt.h
-
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380
/***************************************************************************/ /* */ /* sfnt.h */ /* */ /* High-level `sfnt' driver interface (specification). */ /* */ /* Copyright 1996-2000 by */ /* David Turner, Robert Wilhelm, and Werner Lemberg. */ /* */ /* This file is part of the FreeType project, and may only be used, */ /* modified, and distributed under the terms of the FreeType project */ /* license, LICENSE.TXT. By continuing to use, modify, or distribute */ /* this file you indicate that you have read the license and */ /* understand and accept it fully. */ /* */ /***************************************************************************/ #ifndef SFNT_H #define SFNT_H #include <freetype.h> #include <tttypes.h> /*************************************************************************/ /* */ /* <FuncType> */ /* TT_Load_Format_Tag */ /* */ /* <Description> */ /* Loads the first 4 bytes of the font file. This is a tag that */ /* identifies the font format used. */ /* */ /* <Input> */ /* face :: A handle to the target face object. */ /* stream :: The input stream. */ /* faceIndex :: The index of the TrueType font, if we're opening a */ /* collection. */ /* <Output> */ /* format_tag :: a 4-byte tag */ /* */ /* <Return> */ /* TrueType error code. 0 means success. */ /* */ /* <Note> */ /* The stream cursor must be at the font file's origin */ /* This function recognizes fonts embedded in a "TrueType collection" */ /* */ typedef TT_Error (*TT_Load_Format_Tag_Func)( TT_Face face, FT_Stream stream, TT_Long faceIndex, TT_ULong *format_tag ); /*************************************************************************/ /* */ /* <FuncType> */ /* TT_Load_Directory_Func */ /* */ /* <Description> */ /* Loads the table directory into a face object. */ /* */ /* <Input> */ /* face :: A handle to the target face object. */ /* stream :: The input stream. */ /* faceIndex :: The index of the TrueType font, if we're opening a */ /* collection. */ /* */ /* <Return> */ /* TrueType error code. 0 means success. */ /* */ /* <Note> */ /* The stream cursor must be on the first byte after the 4-byte */ /* font format tag. This is the case just after a call to */ /* TT_Load_Format_Tag */ /* */ typedef TT_Error (*TT_Load_Directory_Func)( TT_Face face, FT_Stream stream, TT_Long faceIndex ); /*************************************************************************/ /* */ /* <FuncType> */ /* TT_Load_Any_Func */ /* */ /* <Description> */ /* Loads any font table into client memory. Used by the */ /* TT_Get_Font_Data() API function. */ /* */ /* <Input> */ /* face :: The face object to look for. */ /* */ /* tag :: The tag of table to load. Use the value 0 if you want */ /* to access the whole font file, else set this parameter */ /* to a valid TrueType table tag that you can forge with */ /* the MAKE_TT_TAG macro. */ /* */ /* offset :: The starting offset in the table (or the file if */ /* tag == 0). */ /* */ /* length :: The address of the decision variable: */ /* */ /* If length == NULL: */ /* Loads the whole table. Returns an error if */ /* `offset' == 0! */ /* */ /* If *length == 0: */ /* Exits immediately; returning the length of the given */ /* table or of the font file, depending on the value of */ /* `tag'. */ /* */ /* If *length != 0: */ /* Loads the next `length' bytes of table or font, */ /* starting at offset `offset' (in table or font too). */ /* */ /* <Output> */ /* buffer :: The address of target buffer. */ /* */ /* <Return> */ /* TrueType error code. 0 means success. */ /* */ typedef TT_Error (*TT_Load_Any_Func)( TT_Face face, TT_ULong tag, TT_Long offset, void* buffer, TT_Long* length ); /*************************************************************************/ /* */ /* <FuncType> */ /* TT_Load_SBit_Image_Func */ /* */ /* <Description> */ /* Loads a given glyph sbit image from the font resource. This also */ /* returns its metrics. */ /* */ /* <Input> */ /* face :: The target face object. */ /* */ /* x_ppem :: The horizontal resolution in points per EM. */ /* */ /* y_ppem :: The vertical resolution in points per EM. */ /* */ /* glyph_index :: The current glyph index. */ /* */ /* stream :: The input stream. */ /* */ /* <Output> */ /* map :: The target pixmap. */ /* metrics :: A big sbit metrics structure for the glyph image. */ /* */ /* <Return> */ /* TrueType error code. 0 means success. Returns an error if no */ /* glyph sbit exists for the index. */ /* */ /* <Note> */ /* The `map.buffer' field is always freed before the glyph is loaded. */ /* */ typedef TT_Error (*TT_Load_SBit_Image_Func)( TT_Face face, TT_Int x_ppem, TT_Int y_ppem, TT_UInt glyph_index, FT_Stream stream, FT_Bitmap* map, TT_SBit_Metrics* metrics ); /*************************************************************************/ /* */ /* <FuncType> */ /* TT_Get_PS_Name_Func */ /* */ /* <Description> */ /* Gets the PostScript glyph name of a glyph. */ /* */ /* <Input> */ /* index :: The glyph index. */ /* */ /* PSname :: The address of a string pointer. Will be NULL in case */ /* of error, otherwise it is a pointer to the glyph name. */ /* */ /* You must not modify the returned string! */ /* */ /* <Output> */ /* TrueType error code. 0 means success. */ /* */ typedef TT_Error (*TT_Get_PS_Name_Func)( TT_Face face, TT_UInt index, TT_String** PSname ); /*************************************************************************/ /* */ /* <FuncType> */ /* TT_Load_Metrics */ /* */ /* <Description> */ /* Loads the horizontal or vertical header in a face object. */ /* */ /* <Input> */ /* face :: A handle to the target face object. */ /* stream :: The input stream. */ /* vertical :: A boolean flag. If set, load vertical metrics. */ /* */ /* <Return> */ /* TrueType error code. 0 means success. */ /* */ typedef TT_Error (*TT_Load_Metrics_Func)( TT_Face face, FT_Stream stream, TT_Bool vertical ); /*************************************************************************/ /* */ /* <FuncType> */ /* TT_CharMap_Load_Func */ /* */ /* <Description> */ /* Loads a given TrueType character map into memory. */ /* */ /* <Input> */ /* face :: A handle to the parent face object. */ /* stream :: A handle to the current stream object. */ /* */ /* <InOut> */ /* cmap :: A pointer to a cmap object. */ /* */ /* <Return> */ /* Error code. 0 means success. */ /* */ /* <Note> */ /* The function assumes that the stream is already in use (i.e., */ /* opened). In case of error, all partially allocated tables are */ /* released. */ /* */ typedef TT_Error (*TT_CharMap_Load_Func)( TT_Face face, TT_CMapTable* cmap, FT_Stream input ); /*************************************************************************/ /* */ /* <FuncType> */ /* TT_CharMap_Free_Func */ /* */ /* <Description> */ /* Destroys a character mapping table. */ /* */ /* <Input> */ /* face :: A handle to the parent face object. */ /* cmap :: A handle to a cmap object. */ /* */ /* <Return> */ /* Error code. 0 means success. */ /* */ typedef TT_Error (*TT_CharMap_Free_Func)( TT_Face face, TT_CMapTable* cmap ); /*************************************************************************/ /* */ /* <FuncType> */ /* TT_Load_Table */ /* */ /* <Description> */ /* Loads a given TrueType table. */ /* */ /* <Input> */ /* face :: A handle to the target face object. */ /* stream :: The input stream. */ /* */ /* <Return> */ /* TrueType error code. 0 means success. */ /* */ /* <Note> */ /* The function will use `face->goto_table' to seek the stream to */ /* the start of the table */ /* */ typedef TT_Error (*TT_Load_Table_Func)( TT_Face face, FT_Stream stream ); /*************************************************************************/ /* */ /* <FuncType> */ /* TT_Load_Table */ /* */ /* <Description> */ /* Loads a given TrueType table. */ /* */ /* <Input> */ /* face :: A handle to the target face object. */ /* stream :: The input stream. */ /* */ /* <Return> */ /* TrueType error code. 0 means success. */ /* */ /* <Note> */ /* The function will use `face->goto_table' to seek the stream to */ /* the start of the table */ /* */ typedef void (*TT_Free_Table_Func)( TT_Face face ); /*************************************************************************/ /* */ /* <Struct> */ /* SFNT_Interface */ /* */ /* <Description> */ /* this structure holds pointers to the functions used to load and */ /* free the basic tables that are required in a `sfnt' font file. */ /* */ /* <Fields> */ /* */ /* */ /* */ /* */ /* */ /* */ /* */ /* */ typedef struct SFNT_Interface_ { TT_Goto_Table_Func goto_table; TT_Load_Any_Func load_any; TT_Load_Format_Tag_Func load_format_tag; TT_Load_Directory_Func load_directory; TT_Load_Table_Func load_header; TT_Load_Metrics_Func load_metrics; TT_Load_Table_Func load_charmaps; TT_Load_Table_Func load_max_profile; TT_Load_Table_Func load_os2; TT_Load_Table_Func load_psnames; TT_Load_Table_Func load_names; TT_Free_Table_Func free_names; /* optional tables */ TT_Load_Table_Func load_hdmx; TT_Free_Table_Func free_hdmx; TT_Load_Table_Func load_kerning; TT_Load_Table_Func load_gasp; /* see `ttsbit.h' */ TT_Load_Table_Func load_sbits; TT_Load_SBit_Image_Func load_sbit_image; TT_Free_Table_Func free_sbits; /* see `ttpost.h' */ TT_Get_PS_Name_Func get_psname; TT_Free_Table_Func free_psnames; /* see `ttcmap.h' */ TT_CharMap_Load_Func load_charmap; TT_CharMap_Free_Func free_charmap; } SFNT_Interface; #endif /* SFNT_H */ /* END */