1 /***************************************************************************/ 2 /* */ 3 /* tttables.h */ 4 /* */ 5 /* Basic SFNT/TrueType tables definitions and interface */ 6 /* (specification only). */ 7 /* */ 8 /* Copyright 1996-2015 by */ 9 /* David Turner, Robert Wilhelm, and Werner Lemberg. */ 10 /* */ 11 /* This file is part of the FreeType project, and may only be used, */ 12 /* modified, and distributed under the terms of the FreeType project */ 13 /* license, LICENSE.TXT. By continuing to use, modify, or distribute */ 14 /* this file you indicate that you have read the license and */ 15 /* understand and accept it fully. */ 16 /* */ 17 /***************************************************************************/ 18 19 20 #ifndef __TTTABLES_H__ 21 #define __TTTABLES_H__ 22 23 24 #include <ft2build.h> 25 #include FT_FREETYPE_H 26 27 #ifdef FREETYPE_H 28 #error "freetype.h of FreeType 1 has been loaded!" 29 #error "Please fix the directory search order for header files" 30 #error "so that freetype.h of FreeType 2 is found first." 31 #endif 32 33 34 FT_BEGIN_HEADER 35 36 /*************************************************************************/ 37 /* */ 38 /* <Section> */ 39 /* truetype_tables */ 40 /* */ 41 /* <Title> */ 42 /* TrueType Tables */ 43 /* */ 44 /* <Abstract> */ 45 /* TrueType specific table types and functions. */ 46 /* */ 47 /* <Description> */ 48 /* This section contains the definition of TrueType-specific tables */ 49 /* as well as some routines used to access and process them. */ 50 /* */ 51 /* <Order> */ 52 /* TT_Header */ 53 /* TT_HoriHeader */ 54 /* TT_VertHeader */ 55 /* TT_OS2 */ 56 /* TT_Postscript */ 57 /* TT_PCLT */ 58 /* TT_MaxProfile */ 59 /* */ 60 /* FT_Sfnt_Tag */ 61 /* FT_Get_Sfnt_Table */ 62 /* FT_Load_Sfnt_Table */ 63 /* FT_Sfnt_Table_Info */ 64 /* */ 65 /* FT_Get_CMap_Language_ID */ 66 /* FT_Get_CMap_Format */ 67 /* */ 68 /* FT_PARAM_TAG_UNPATENTED_HINTING */ 69 /* */ 70 /*************************************************************************/ 71 72 73 /*************************************************************************/ 74 /* */ 75 /* <Struct> */ 76 /* TT_Header */ 77 /* */ 78 /* <Description> */ 79 /* A structure used to model a TrueType font header table. All */ 80 /* fields follow the TrueType specification. */ 81 /* */ 82 typedef struct TT_Header_ 83 { 84 FT_Fixed Table_Version; 85 FT_Fixed Font_Revision; 86 87 FT_Long CheckSum_Adjust; 88 FT_Long Magic_Number; 89 90 FT_UShort Flags; 91 FT_UShort Units_Per_EM; 92 93 FT_Long Created [2]; 94 FT_Long Modified[2]; 95 96 FT_Short xMin; 97 FT_Short yMin; 98 FT_Short xMax; 99 FT_Short yMax; 100 101 FT_UShort Mac_Style; 102 FT_UShort Lowest_Rec_PPEM; 103 104 FT_Short Font_Direction; 105 FT_Short Index_To_Loc_Format; 106 FT_Short Glyph_Data_Format; 107 108 } TT_Header; 109 110 111 /*************************************************************************/ 112 /* */ 113 /* <Struct> */ 114 /* TT_HoriHeader */ 115 /* */ 116 /* <Description> */ 117 /* A structure used to model a TrueType horizontal header, the `hhea' */ 118 /* table, as well as the corresponding horizontal metrics table, */ 119 /* i.e., the `hmtx' table. */ 120 /* */ 121 /* <Fields> */ 122 /* Version :: The table version. */ 123 /* */ 124 /* Ascender :: The font's ascender, i.e., the distance */ 125 /* from the baseline to the top-most of all */ 126 /* glyph points found in the font. */ 127 /* */ 128 /* This value is invalid in many fonts, as */ 129 /* it is usually set by the font designer, */ 130 /* and often reflects only a portion of the */ 131 /* glyphs found in the font (maybe ASCII). */ 132 /* */ 133 /* You should use the `sTypoAscender' field */ 134 /* of the OS/2 table instead if you want */ 135 /* the correct one. */ 136 /* */ 137 /* Descender :: The font's descender, i.e., the distance */ 138 /* from the baseline to the bottom-most of */ 139 /* all glyph points found in the font. It */ 140 /* is negative. */ 141 /* */ 142 /* This value is invalid in many fonts, as */ 143 /* it is usually set by the font designer, */ 144 /* and often reflects only a portion of the */ 145 /* glyphs found in the font (maybe ASCII). */ 146 /* */ 147 /* You should use the `sTypoDescender' */ 148 /* field of the OS/2 table instead if you */ 149 /* want the correct one. */ 150 /* */ 151 /* Line_Gap :: The font's line gap, i.e., the distance */ 152 /* to add to the ascender and descender to */ 153 /* get the BTB, i.e., the */ 154 /* baseline-to-baseline distance for the */ 155 /* font. */ 156 /* */ 157 /* advance_Width_Max :: This field is the maximum of all advance */ 158 /* widths found in the font. It can be */ 159 /* used to compute the maximum width of an */ 160 /* arbitrary string of text. */ 161 /* */ 162 /* min_Left_Side_Bearing :: The minimum left side bearing of all */ 163 /* glyphs within the font. */ 164 /* */ 165 /* min_Right_Side_Bearing :: The minimum right side bearing of all */ 166 /* glyphs within the font. */ 167 /* */ 168 /* xMax_Extent :: The maximum horizontal extent (i.e., the */ 169 /* `width' of a glyph's bounding box) for */ 170 /* all glyphs in the font. */ 171 /* */ 172 /* caret_Slope_Rise :: The rise coefficient of the cursor's */ 173 /* slope of the cursor (slope=rise/run). */ 174 /* */ 175 /* caret_Slope_Run :: The run coefficient of the cursor's */ 176 /* slope. */ 177 /* */ 178 /* Reserved :: 8~reserved bytes. */ 179 /* */ 180 /* metric_Data_Format :: Always~0. */ 181 /* */ 182 /* number_Of_HMetrics :: Number of HMetrics entries in the `hmtx' */ 183 /* table -- this value can be smaller than */ 184 /* the total number of glyphs in the font. */ 185 /* */ 186 /* long_metrics :: A pointer into the `hmtx' table. */ 187 /* */ 188 /* short_metrics :: A pointer into the `hmtx' table. */ 189 /* */ 190 /* <Note> */ 191 /* IMPORTANT: The TT_HoriHeader and TT_VertHeader structures should */ 192 /* be identical except for the names of their fields, */ 193 /* which are different. */ 194 /* */ 195 /* This ensures that a single function in the `ttload' */ 196 /* module is able to read both the horizontal and vertical */ 197 /* headers. */ 198 /* */ 199 typedef struct TT_HoriHeader_ 200 { 201 FT_Fixed Version; 202 FT_Short Ascender; 203 FT_Short Descender; 204 FT_Short Line_Gap; 205 206 FT_UShort advance_Width_Max; /* advance width maximum */ 207 208 FT_Short min_Left_Side_Bearing; /* minimum left-sb */ 209 FT_Short min_Right_Side_Bearing; /* minimum right-sb */ 210 FT_Short xMax_Extent; /* xmax extents */ 211 FT_Short caret_Slope_Rise; 212 FT_Short caret_Slope_Run; 213 FT_Short caret_Offset; 214 215 FT_Short Reserved[4]; 216 217 FT_Short metric_Data_Format; 218 FT_UShort number_Of_HMetrics; 219 220 /* The following fields are not defined by the TrueType specification */ 221 /* but they are used to connect the metrics header to the relevant */ 222 /* `HMTX' table. */ 223 224 void* long_metrics; 225 void* short_metrics; 226 227 } TT_HoriHeader; 228 229 230 /*************************************************************************/ 231 /* */ 232 /* <Struct> */ 233 /* TT_VertHeader */ 234 /* */ 235 /* <Description> */ 236 /* A structure used to model a TrueType vertical header, the `vhea' */ 237 /* table, as well as the corresponding vertical metrics table, i.e., */ 238 /* the `vmtx' table. */ 239 /* */ 240 /* <Fields> */ 241 /* Version :: The table version. */ 242 /* */ 243 /* Ascender :: The font's ascender, i.e., the distance */ 244 /* from the baseline to the top-most of */ 245 /* all glyph points found in the font. */ 246 /* */ 247 /* This value is invalid in many fonts, as */ 248 /* it is usually set by the font designer, */ 249 /* and often reflects only a portion of */ 250 /* the glyphs found in the font (maybe */ 251 /* ASCII). */ 252 /* */ 253 /* You should use the `sTypoAscender' */ 254 /* field of the OS/2 table instead if you */ 255 /* want the correct one. */ 256 /* */ 257 /* Descender :: The font's descender, i.e., the */ 258 /* distance from the baseline to the */ 259 /* bottom-most of all glyph points found */ 260 /* in the font. It is negative. */ 261 /* */ 262 /* This value is invalid in many fonts, as */ 263 /* it is usually set by the font designer, */ 264 /* and often reflects only a portion of */ 265 /* the glyphs found in the font (maybe */ 266 /* ASCII). */ 267 /* */ 268 /* You should use the `sTypoDescender' */ 269 /* field of the OS/2 table instead if you */ 270 /* want the correct one. */ 271 /* */ 272 /* Line_Gap :: The font's line gap, i.e., the distance */ 273 /* to add to the ascender and descender to */ 274 /* get the BTB, i.e., the */ 275 /* baseline-to-baseline distance for the */ 276 /* font. */ 277 /* */ 278 /* advance_Height_Max :: This field is the maximum of all */ 279 /* advance heights found in the font. It */ 280 /* can be used to compute the maximum */ 281 /* height of an arbitrary string of text. */ 282 /* */ 283 /* min_Top_Side_Bearing :: The minimum top side bearing of all */ 284 /* glyphs within the font. */ 285 /* */ 286 /* min_Bottom_Side_Bearing :: The minimum bottom side bearing of all */ 287 /* glyphs within the font. */ 288 /* */ 289 /* yMax_Extent :: The maximum vertical extent (i.e., the */ 290 /* `height' of a glyph's bounding box) for */ 291 /* all glyphs in the font. */ 292 /* */ 293 /* caret_Slope_Rise :: The rise coefficient of the cursor's */ 294 /* slope of the cursor (slope=rise/run). */ 295 /* */ 296 /* caret_Slope_Run :: The run coefficient of the cursor's */ 297 /* slope. */ 298 /* */ 299 /* caret_Offset :: The cursor's offset for slanted fonts. */ 300 /* This value is `reserved' in vmtx */ 301 /* version 1.0. */ 302 /* */ 303 /* Reserved :: 8~reserved bytes. */ 304 /* */ 305 /* metric_Data_Format :: Always~0. */ 306 /* */ 307 /* number_Of_HMetrics :: Number of VMetrics entries in the */ 308 /* `vmtx' table -- this value can be */ 309 /* smaller than the total number of glyphs */ 310 /* in the font. */ 311 /* */ 312 /* long_metrics :: A pointer into the `vmtx' table. */ 313 /* */ 314 /* short_metrics :: A pointer into the `vmtx' table. */ 315 /* */ 316 /* <Note> */ 317 /* IMPORTANT: The TT_HoriHeader and TT_VertHeader structures should */ 318 /* be identical except for the names of their fields, */ 319 /* which are different. */ 320 /* */ 321 /* This ensures that a single function in the `ttload' */ 322 /* module is able to read both the horizontal and vertical */ 323 /* headers. */ 324 /* */ 325 typedef struct TT_VertHeader_ 326 { 327 FT_Fixed Version; 328 FT_Short Ascender; 329 FT_Short Descender; 330 FT_Short Line_Gap; 331 332 FT_UShort advance_Height_Max; /* advance height maximum */ 333 334 FT_Short min_Top_Side_Bearing; /* minimum left-sb or top-sb */ 335 FT_Short min_Bottom_Side_Bearing; /* minimum right-sb or bottom-sb */ 336 FT_Short yMax_Extent; /* xmax or ymax extents */ 337 FT_Short caret_Slope_Rise; 338 FT_Short caret_Slope_Run; 339 FT_Short caret_Offset; 340 341 FT_Short Reserved[4]; 342 343 FT_Short metric_Data_Format; 344 FT_UShort number_Of_VMetrics; 345 346 /* The following fields are not defined by the TrueType specification */ 347 /* but they're used to connect the metrics header to the relevant */ 348 /* `HMTX' or `VMTX' table. */ 349 350 void* long_metrics; 351 void* short_metrics; 352 353 } TT_VertHeader; 354 355 356 /*************************************************************************/ 357 /* */ 358 /* <Struct> */ 359 /* TT_OS2 */ 360 /* */ 361 /* <Description> */ 362 /* A structure used to model a TrueType OS/2 table. All fields */ 363 /* comply to the OpenType specification. */ 364 /* */ 365 /* Note that we now support old Mac fonts that do not include an OS/2 */ 366 /* table. In this case, the `version' field is always set to 0xFFFF. */ 367 /* */ 368 typedef struct TT_OS2_ 369 { 370 FT_UShort version; /* 0x0001 - more or 0xFFFF */ 371 FT_Short xAvgCharWidth; 372 FT_UShort usWeightClass; 373 FT_UShort usWidthClass; 374 FT_UShort fsType; 375 FT_Short ySubscriptXSize; 376 FT_Short ySubscriptYSize; 377 FT_Short ySubscriptXOffset; 378 FT_Short ySubscriptYOffset; 379 FT_Short ySuperscriptXSize; 380 FT_Short ySuperscriptYSize; 381 FT_Short ySuperscriptXOffset; 382 FT_Short ySuperscriptYOffset; 383 FT_Short yStrikeoutSize; 384 FT_Short yStrikeoutPosition; 385 FT_Short sFamilyClass; 386 387 FT_Byte panose[10]; 388 389 FT_ULong ulUnicodeRange1; /* Bits 0-31 */ 390 FT_ULong ulUnicodeRange2; /* Bits 32-63 */ 391 FT_ULong ulUnicodeRange3; /* Bits 64-95 */ 392 FT_ULong ulUnicodeRange4; /* Bits 96-127 */ 393 394 FT_Char achVendID[4]; 395 396 FT_UShort fsSelection; 397 FT_UShort usFirstCharIndex; 398 FT_UShort usLastCharIndex; 399 FT_Short sTypoAscender; 400 FT_Short sTypoDescender; 401 FT_Short sTypoLineGap; 402 FT_UShort usWinAscent; 403 FT_UShort usWinDescent; 404 405 /* only version 1 and higher: */ 406 407 FT_ULong ulCodePageRange1; /* Bits 0-31 */ 408 FT_ULong ulCodePageRange2; /* Bits 32-63 */ 409 410 /* only version 2 and higher: */ 411 412 FT_Short sxHeight; 413 FT_Short sCapHeight; 414 FT_UShort usDefaultChar; 415 FT_UShort usBreakChar; 416 FT_UShort usMaxContext; 417 418 /* only version 5 and higher: */ 419 420 FT_UShort usLowerOpticalPointSize; /* in twips (1/20th points) */ 421 FT_UShort usUpperOpticalPointSize; /* in twips (1/20th points) */ 422 423 } TT_OS2; 424 425 426 /*************************************************************************/ 427 /* */ 428 /* <Struct> */ 429 /* TT_Postscript */ 430 /* */ 431 /* <Description> */ 432 /* A structure used to model a TrueType PostScript table. All fields */ 433 /* comply to the TrueType specification. This structure does not */ 434 /* reference the PostScript glyph names, which can be nevertheless */ 435 /* accessed with the `ttpost' module. */ 436 /* */ 437 typedef struct TT_Postscript_ 438 { 439 FT_Fixed FormatType; 440 FT_Fixed italicAngle; 441 FT_Short underlinePosition; 442 FT_Short underlineThickness; 443 FT_ULong isFixedPitch; 444 FT_ULong minMemType42; 445 FT_ULong maxMemType42; 446 FT_ULong minMemType1; 447 FT_ULong maxMemType1; 448 449 /* Glyph names follow in the file, but we don't */ 450 /* load them by default. See the ttpost.c file. */ 451 452 } TT_Postscript; 453 454 455 /*************************************************************************/ 456 /* */ 457 /* <Struct> */ 458 /* TT_PCLT */ 459 /* */ 460 /* <Description> */ 461 /* A structure used to model a TrueType PCLT table. All fields */ 462 /* comply to the TrueType specification. */ 463 /* */ 464 typedef struct TT_PCLT_ 465 { 466 FT_Fixed Version; 467 FT_ULong FontNumber; 468 FT_UShort Pitch; 469 FT_UShort xHeight; 470 FT_UShort Style; 471 FT_UShort TypeFamily; 472 FT_UShort CapHeight; 473 FT_UShort SymbolSet; 474 FT_Char TypeFace[16]; 475 FT_Char CharacterComplement[8]; 476 FT_Char FileName[6]; 477 FT_Char StrokeWeight; 478 FT_Char WidthType; 479 FT_Byte SerifStyle; 480 FT_Byte Reserved; 481 482 } TT_PCLT; 483 484 485 /*************************************************************************/ 486 /* */ 487 /* <Struct> */ 488 /* TT_MaxProfile */ 489 /* */ 490 /* <Description> */ 491 /* The maximum profile is a table containing many max values, which */ 492 /* can be used to pre-allocate arrays. This ensures that no memory */ 493 /* allocation occurs during a glyph load. */ 494 /* */ 495 /* <Fields> */ 496 /* version :: The version number. */ 497 /* */ 498 /* numGlyphs :: The number of glyphs in this TrueType */ 499 /* font. */ 500 /* */ 501 /* maxPoints :: The maximum number of points in a */ 502 /* non-composite TrueType glyph. See also */ 503 /* the structure element */ 504 /* `maxCompositePoints'. */ 505 /* */ 506 /* maxContours :: The maximum number of contours in a */ 507 /* non-composite TrueType glyph. See also */ 508 /* the structure element */ 509 /* `maxCompositeContours'. */ 510 /* */ 511 /* maxCompositePoints :: The maximum number of points in a */ 512 /* composite TrueType glyph. See also the */ 513 /* structure element `maxPoints'. */ 514 /* */ 515 /* maxCompositeContours :: The maximum number of contours in a */ 516 /* composite TrueType glyph. See also the */ 517 /* structure element `maxContours'. */ 518 /* */ 519 /* maxZones :: The maximum number of zones used for */ 520 /* glyph hinting. */ 521 /* */ 522 /* maxTwilightPoints :: The maximum number of points in the */ 523 /* twilight zone used for glyph hinting. */ 524 /* */ 525 /* maxStorage :: The maximum number of elements in the */ 526 /* storage area used for glyph hinting. */ 527 /* */ 528 /* maxFunctionDefs :: The maximum number of function */ 529 /* definitions in the TrueType bytecode for */ 530 /* this font. */ 531 /* */ 532 /* maxInstructionDefs :: The maximum number of instruction */ 533 /* definitions in the TrueType bytecode for */ 534 /* this font. */ 535 /* */ 536 /* maxStackElements :: The maximum number of stack elements used */ 537 /* during bytecode interpretation. */ 538 /* */ 539 /* maxSizeOfInstructions :: The maximum number of TrueType opcodes */ 540 /* used for glyph hinting. */ 541 /* */ 542 /* maxComponentElements :: The maximum number of simple (i.e., non- */ 543 /* composite) glyphs in a composite glyph. */ 544 /* */ 545 /* maxComponentDepth :: The maximum nesting depth of composite */ 546 /* glyphs. */ 547 /* */ 548 /* <Note> */ 549 /* This structure is only used during font loading. */ 550 /* */ 551 typedef struct TT_MaxProfile_ 552 { 553 FT_Fixed version; 554 FT_UShort numGlyphs; 555 FT_UShort maxPoints; 556 FT_UShort maxContours; 557 FT_UShort maxCompositePoints; 558 FT_UShort maxCompositeContours; 559 FT_UShort maxZones; 560 FT_UShort maxTwilightPoints; 561 FT_UShort maxStorage; 562 FT_UShort maxFunctionDefs; 563 FT_UShort maxInstructionDefs; 564 FT_UShort maxStackElements; 565 FT_UShort maxSizeOfInstructions; 566 FT_UShort maxComponentElements; 567 FT_UShort maxComponentDepth; 568 569 } TT_MaxProfile; 570 571 572 /*************************************************************************/ 573 /* */ 574 /* <Enum> */ 575 /* FT_Sfnt_Tag */ 576 /* */ 577 /* <Description> */ 578 /* An enumeration used to specify the index of an SFNT table. */ 579 /* Used in the @FT_Get_Sfnt_Table API function. */ 580 /* */ 581 /* <Values> */ 582 /* FT_SFNT_HEAD :: To access the font's @TT_Header structure. */ 583 /* */ 584 /* FT_SFNT_MAXP :: To access the font's @TT_MaxProfile structure. */ 585 /* */ 586 /* FT_SFNT_OS2 :: To access the font's @TT_OS2 structure. */ 587 /* */ 588 /* FT_SFNT_HHEA :: To access the font's @TT_HoriHeader structure. */ 589 /* */ 590 /* FT_SFNT_VHEA :: To access the font's @TT_VertHeader struture. */ 591 /* */ 592 /* FT_SFNT_POST :: To access the font's @TT_Postscript structure. */ 593 /* */ 594 /* FT_SFNT_PCLT :: To access the font's @TT_PCLT structure. */ 595 /* */ 596 typedef enum FT_Sfnt_Tag_ 597 { 598 FT_SFNT_HEAD, 599 FT_SFNT_MAXP, 600 FT_SFNT_OS2, 601 FT_SFNT_HHEA, 602 FT_SFNT_VHEA, 603 FT_SFNT_POST, 604 FT_SFNT_PCLT, 605 606 FT_SFNT_MAX 607 608 } FT_Sfnt_Tag; 609 610 /* these constants are deprecated; use the corresponding `FT_Sfnt_Tag' */ 611 /* values instead */ 612 #define ft_sfnt_head FT_SFNT_HEAD 613 #define ft_sfnt_maxp FT_SFNT_MAXP 614 #define ft_sfnt_os2 FT_SFNT_OS2 615 #define ft_sfnt_hhea FT_SFNT_HHEA 616 #define ft_sfnt_vhea FT_SFNT_VHEA 617 #define ft_sfnt_post FT_SFNT_POST 618 #define ft_sfnt_pclt FT_SFNT_PCLT 619 620 621 /*************************************************************************/ 622 /* */ 623 /* <Function> */ 624 /* FT_Get_Sfnt_Table */ 625 /* */ 626 /* <Description> */ 627 /* Return a pointer to a given SFNT table within a face. */ 628 /* */ 629 /* <Input> */ 630 /* face :: A handle to the source. */ 631 /* */ 632 /* tag :: The index of the SFNT table. */ 633 /* */ 634 /* <Return> */ 635 /* A type-less pointer to the table. This will be~0 in case of */ 636 /* error, or if the corresponding table was not found *OR* loaded */ 637 /* from the file. */ 638 /* */ 639 /* Use a typecast according to `tag' to access the structure */ 640 /* elements. */ 641 /* */ 642 /* <Note> */ 643 /* The table is owned by the face object and disappears with it. */ 644 /* */ 645 /* This function is only useful to access SFNT tables that are loaded */ 646 /* by the sfnt, truetype, and opentype drivers. See @FT_Sfnt_Tag for */ 647 /* a list. */ 648 /* */ 649 /* Here an example how to access the `vhea' table: */ 650 /* */ 651 /* { */ 652 /* TT_VertHeader* vert_header; */ 653 /* */ 654 /* */ 655 /* vert_header = */ 656 /* (TT_VertHeader*)FT_Get_Sfnt_Table( face, FT_SFNT_VHEA ); */ 657 /* } */ 658 /* */ 659 FT_EXPORT( void* ) 660 FT_Get_Sfnt_Table( FT_Face face, 661 FT_Sfnt_Tag tag ); 662 663 664 /************************************************************************** 665 * 666 * @function: 667 * FT_Load_Sfnt_Table 668 * 669 * @description: 670 * Load any font table into client memory. 671 * 672 * @input: 673 * face :: 674 * A handle to the source face. 675 * 676 * tag :: 677 * The four-byte tag of the table to load. Use the value~0 if you want 678 * to access the whole font file. Otherwise, you can use one of the 679 * definitions found in the @FT_TRUETYPE_TAGS_H file, or forge a new 680 * one with @FT_MAKE_TAG. 681 * 682 * offset :: 683 * The starting offset in the table (or file if tag == 0). 684 * 685 * @output: 686 * buffer :: 687 * The target buffer address. The client must ensure that the memory 688 * array is big enough to hold the data. 689 * 690 * @inout: 691 * length :: 692 * If the `length' parameter is NULL, then try to load the whole table. 693 * Return an error code if it fails. 694 * 695 * Else, if `*length' is~0, exit immediately while returning the 696 * table's (or file) full size in it. 697 * 698 * Else the number of bytes to read from the table or file, from the 699 * starting offset. 700 * 701 * @return: 702 * FreeType error code. 0~means success. 703 * 704 * @note: 705 * If you need to determine the table's length you should first call this 706 * function with `*length' set to~0, as in the following example: 707 * 708 * { 709 * FT_ULong length = 0; 710 * 711 * 712 * error = FT_Load_Sfnt_Table( face, tag, 0, NULL, &length ); 713 * if ( error ) { ... table does not exist ... } 714 * 715 * buffer = malloc( length ); 716 * if ( buffer == NULL ) { ... not enough memory ... } 717 * 718 * error = FT_Load_Sfnt_Table( face, tag, 0, buffer, &length ); 719 * if ( error ) { ... could not load table ... } 720 * } 721 * 722 * Note that structures like @TT_Header or @TT_OS2 can't be used with 723 * this function; they are limited to @FT_Get_Sfnt_Table. Reason is that 724 * those structures depend on the processor architecture, with varying 725 * size (e.g. 32bit vs. 64bit) or order (big endian vs. little endian). 726 * 727 */ 728 FT_EXPORT( FT_Error ) 729 FT_Load_Sfnt_Table( FT_Face face, 730 FT_ULong tag, 731 FT_Long offset, 732 FT_Byte* buffer, 733 FT_ULong* length ); 734 735 736 /************************************************************************** 737 * 738 * @function: 739 * FT_Sfnt_Table_Info 740 * 741 * @description: 742 * Return information on an SFNT table. 743 * 744 * @input: 745 * face :: 746 * A handle to the source face. 747 * 748 * table_index :: 749 * The index of an SFNT table. The function returns 750 * FT_Err_Table_Missing for an invalid value. 751 * 752 * @inout: 753 * tag :: 754 * The name tag of the SFNT table. If the value is NULL, `table_index' 755 * is ignored, and `length' returns the number of SFNT tables in the 756 * font. 757 * 758 * @output: 759 * length :: 760 * The length of the SFNT table (or the number of SFNT tables, depending 761 * on `tag'). 762 * 763 * @return: 764 * FreeType error code. 0~means success. 765 * 766 * @note: 767 * While parsing fonts, FreeType handles SFNT tables with length zero as 768 * missing. 769 * 770 */ 771 FT_EXPORT( FT_Error ) 772 FT_Sfnt_Table_Info( FT_Face face, 773 FT_UInt table_index, 774 FT_ULong *tag, 775 FT_ULong *length ); 776 777 778 /*************************************************************************/ 779 /* */ 780 /* <Function> */ 781 /* FT_Get_CMap_Language_ID */ 782 /* */ 783 /* <Description> */ 784 /* Return TrueType/sfnt specific cmap language ID. Definitions of */ 785 /* language ID values are in `ttnameid.h'. */ 786 /* */ 787 /* <Input> */ 788 /* charmap :: */ 789 /* The target charmap. */ 790 /* */ 791 /* <Return> */ 792 /* The language ID of `charmap'. If `charmap' doesn't belong to a */ 793 /* TrueType/sfnt face, just return~0 as the default value. */ 794 /* */ 795 /* For a format~14 cmap (to access Unicode IVS), the return value is */ 796 /* 0xFFFFFFFF. */ 797 /* */ 798 FT_EXPORT( FT_ULong ) 799 FT_Get_CMap_Language_ID( FT_CharMap charmap ); 800 801 802 /*************************************************************************/ 803 /* */ 804 /* <Function> */ 805 /* FT_Get_CMap_Format */ 806 /* */ 807 /* <Description> */ 808 /* Return TrueType/sfnt specific cmap format. */ 809 /* */ 810 /* <Input> */ 811 /* charmap :: */ 812 /* The target charmap. */ 813 /* */ 814 /* <Return> */ 815 /* The format of `charmap'. If `charmap' doesn't belong to a */ 816 /* TrueType/sfnt face, return -1. */ 817 /* */ 818 FT_EXPORT( FT_Long ) 819 FT_Get_CMap_Format( FT_CharMap charmap ); 820 821 /* */ 822 823 824 FT_END_HEADER 825 826 #endif /* __TTTABLES_H__ */ 827 828 829 /* END */ 830