1 2<!doctype html> 3<html lang="en" class="no-js"> 4 <head> 5 6 <meta charset="utf-8"> 7 <meta name="viewport" content="width=device-width,initial-scale=1"> 8 9 <meta name="description" content="API Reference Documentation for FreeType-2.12.1"> 10 11 12 13 <meta name="author" content="FreeType Contributors"> 14 15 16 <link rel="icon" href="images/favico.ico"> 17 <meta name="generator" content="mkdocs-1.2.1, mkdocs-material-7.1.9"> 18 19 20 21 <title>Font Formats - FreeType-2.12.1 API Reference</title> 22 23 24 25 <link rel="stylesheet" href="assets/stylesheets/main.ca7ac06f.min.css"> 26 27 28 <link rel="stylesheet" href="assets/stylesheets/palette.f1a3b89f.min.css"> 29 30 31 32 <meta name="theme-color" content="#4cae4f"> 33 34 35 36 37 38 39 40 <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin> 41 <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Noto+Serif:300,400,400i,700%7CRoboto+Mono&display=fallback"> 42 <style>:root{--md-text-font-family:"Noto Serif";--md-code-font-family:"Roboto Mono"}</style> 43 44 45 46 47 <link rel="stylesheet" href="stylesheets/extra.css"> 48 49 50 51 52 53 54 55 </head> 56 57 58 59 60 61 62 63 <body dir="ltr" data-md-color-scheme="" data-md-color-primary="green" data-md-color-accent="green"> 64 65 66 <script>function __prefix(e){return new URL(".",location).pathname+"."+e}function __get(e,t=localStorage){return JSON.parse(t.getItem(__prefix(e)))}</script> 67 68 <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off"> 69 <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off"> 70 <label class="md-overlay" for="__drawer"></label> 71 <div data-md-component="skip"> 72 73 74 <a href="#font-formats" class="md-skip"> 75 Skip to content 76 </a> 77 78 </div> 79 <div data-md-component="announce"> 80 81 </div> 82 83 <header class="md-header" data-md-component="header"> 84 <nav class="md-header__inner md-grid" aria-label="Header"> 85 <a href="index.html" title="FreeType-2.12.1 API Reference" class="md-header__button md-logo" aria-label="FreeType-2.12.1 API Reference" data-md-component="logo"> 86 87 <img src="images/favico.ico" alt="logo"> 88 89 </a> 90 <label class="md-header__button md-icon" for="__drawer"> 91 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2z"/></svg> 92 </label> 93 <div class="md-header__title" data-md-component="header-title"> 94 <div class="md-header__ellipsis"> 95 <div class="md-header__topic"> 96 <span class="md-ellipsis"> 97 FreeType-2.12.1 API Reference 98 </span> 99 </div> 100 <div class="md-header__topic" data-md-component="header-topic"> 101 <span class="md-ellipsis"> 102 103 Font Formats 104 105 </span> 106 </div> 107 </div> 108 </div> 109 110 111 112 <label class="md-header__button md-icon" for="__search"> 113 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5z"/></svg> 114 </label> 115 116<div class="md-search" data-md-component="search" role="dialog"> 117 <label class="md-search__overlay" for="__search"></label> 118 <div class="md-search__inner" role="search"> 119 <form class="md-search__form" name="search"> 120 <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" data-md-state="active" required> 121 <label class="md-search__icon md-icon" for="__search"> 122 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5z"/></svg> 123 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12z"/></svg> 124 </label> 125 <button type="reset" class="md-search__icon md-icon" aria-label="Clear" tabindex="-1"> 126 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41z"/></svg> 127 </button> 128 </form> 129 <div class="md-search__output"> 130 <div class="md-search__scrollwrap" data-md-scrollfix> 131 <div class="md-search-result" data-md-component="search-result"> 132 <div class="md-search-result__meta"> 133 Initializing search 134 </div> 135 <ol class="md-search-result__list"></ol> 136 </div> 137 </div> 138 </div> 139 </div> 140</div> 141 142 143 </nav> 144</header> 145 146 <div class="md-container" data-md-component="container"> 147 148 149 150 151 <main class="md-main" data-md-component="main"> 152 <div class="md-main__inner md-grid"> 153 154 155 156 <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" > 157 <div class="md-sidebar__scrollwrap"> 158 <div class="md-sidebar__inner"> 159 160 161 162<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0"> 163 <label class="md-nav__title" for="__drawer"> 164 <a href="index.html" title="FreeType-2.12.1 API Reference" class="md-nav__button md-logo" aria-label="FreeType-2.12.1 API Reference" data-md-component="logo"> 165 166 <img src="images/favico.ico" alt="logo"> 167 168 </a> 169 FreeType-2.12.1 API Reference 170 </label> 171 172 <ul class="md-nav__list" data-md-scrollfix> 173 174 175 176 177 178 179 180 181 <li class="md-nav__item"> 182 <a href="index.html" class="md-nav__link"> 183 TOC 184 </a> 185 </li> 186 187 188 189 190 191 192 193 194 195 196 <li class="md-nav__item"> 197 <a href="ft2-index.html" class="md-nav__link"> 198 Index 199 </a> 200 </li> 201 202 203 204 205 206 207 208 209 210 211 212 <li class="md-nav__item md-nav__item--nested"> 213 214 215 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_3" type="checkbox" id="__nav_3" > 216 217 <label class="md-nav__link" for="__nav_3"> 218 General Remarks 219 <span class="md-nav__icon md-icon"></span> 220 </label> 221 <nav class="md-nav" aria-label="General Remarks" data-md-level="1"> 222 <label class="md-nav__title" for="__nav_3"> 223 <span class="md-nav__icon md-icon"></span> 224 General Remarks 225 </label> 226 <ul class="md-nav__list" data-md-scrollfix> 227 228 229 230 231 232 <li class="md-nav__item"> 233 <a href="ft2-preamble.html" class="md-nav__link"> 234 Preamble 235 </a> 236 </li> 237 238 239 240 241 242 243 244 <li class="md-nav__item"> 245 <a href="ft2-header_inclusion.html" class="md-nav__link"> 246 FreeType's header inclusion scheme 247 </a> 248 </li> 249 250 251 252 253 254 255 256 <li class="md-nav__item"> 257 <a href="ft2-user_allocation.html" class="md-nav__link"> 258 User allocation 259 </a> 260 </li> 261 262 263 264 </ul> 265 </nav> 266 </li> 267 268 269 270 271 272 273 274 275 276 277 278 <li class="md-nav__item md-nav__item--nested"> 279 280 281 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_4" type="checkbox" id="__nav_4" > 282 283 <label class="md-nav__link" for="__nav_4"> 284 Core API 285 <span class="md-nav__icon md-icon"></span> 286 </label> 287 <nav class="md-nav" aria-label="Core API" data-md-level="1"> 288 <label class="md-nav__title" for="__nav_4"> 289 <span class="md-nav__icon md-icon"></span> 290 Core API 291 </label> 292 <ul class="md-nav__list" data-md-scrollfix> 293 294 295 296 297 298 <li class="md-nav__item"> 299 <a href="ft2-version.html" class="md-nav__link"> 300 FreeType Version 301 </a> 302 </li> 303 304 305 306 307 308 309 310 <li class="md-nav__item"> 311 <a href="ft2-basic_types.html" class="md-nav__link"> 312 Basic Data Types 313 </a> 314 </li> 315 316 317 318 319 320 321 322 <li class="md-nav__item"> 323 <a href="ft2-base_interface.html" class="md-nav__link"> 324 Base Interface 325 </a> 326 </li> 327 328 329 330 331 332 333 334 <li class="md-nav__item"> 335 <a href="ft2-glyph_variants.html" class="md-nav__link"> 336 Unicode Variation Sequences 337 </a> 338 </li> 339 340 341 342 343 344 345 346 <li class="md-nav__item"> 347 <a href="ft2-color_management.html" class="md-nav__link"> 348 Glyph Color Management 349 </a> 350 </li> 351 352 353 354 355 356 357 358 <li class="md-nav__item"> 359 <a href="ft2-layer_management.html" class="md-nav__link"> 360 Glyph Layer Management 361 </a> 362 </li> 363 364 365 366 367 368 369 370 <li class="md-nav__item"> 371 <a href="ft2-glyph_management.html" class="md-nav__link"> 372 Glyph Management 373 </a> 374 </li> 375 376 377 378 379 380 381 382 <li class="md-nav__item"> 383 <a href="ft2-mac_specific.html" class="md-nav__link"> 384 Mac Specific Interface 385 </a> 386 </li> 387 388 389 390 391 392 393 394 <li class="md-nav__item"> 395 <a href="ft2-sizes_management.html" class="md-nav__link"> 396 Size Management 397 </a> 398 </li> 399 400 401 402 403 404 405 406 <li class="md-nav__item"> 407 <a href="ft2-header_file_macros.html" class="md-nav__link"> 408 Header File Macros 409 </a> 410 </li> 411 412 413 414 </ul> 415 </nav> 416 </li> 417 418 419 420 421 422 423 424 425 426 427 428 429 430 <li class="md-nav__item md-nav__item--active md-nav__item--nested"> 431 432 433 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_5" type="checkbox" id="__nav_5" checked> 434 435 <label class="md-nav__link" for="__nav_5"> 436 Format-Specific API 437 <span class="md-nav__icon md-icon"></span> 438 </label> 439 <nav class="md-nav" aria-label="Format-Specific API" data-md-level="1"> 440 <label class="md-nav__title" for="__nav_5"> 441 <span class="md-nav__icon md-icon"></span> 442 Format-Specific API 443 </label> 444 <ul class="md-nav__list" data-md-scrollfix> 445 446 447 448 449 450 <li class="md-nav__item"> 451 <a href="ft2-multiple_masters.html" class="md-nav__link"> 452 Multiple Masters 453 </a> 454 </li> 455 456 457 458 459 460 461 462 <li class="md-nav__item"> 463 <a href="ft2-truetype_tables.html" class="md-nav__link"> 464 TrueType Tables 465 </a> 466 </li> 467 468 469 470 471 472 473 474 <li class="md-nav__item"> 475 <a href="ft2-type1_tables.html" class="md-nav__link"> 476 Type 1 Tables 477 </a> 478 </li> 479 480 481 482 483 484 485 486 <li class="md-nav__item"> 487 <a href="ft2-sfnt_names.html" class="md-nav__link"> 488 SFNT Names 489 </a> 490 </li> 491 492 493 494 495 496 497 498 <li class="md-nav__item"> 499 <a href="ft2-bdf_fonts.html" class="md-nav__link"> 500 BDF and PCF Files 501 </a> 502 </li> 503 504 505 506 507 508 509 510 <li class="md-nav__item"> 511 <a href="ft2-cid_fonts.html" class="md-nav__link"> 512 CID Fonts 513 </a> 514 </li> 515 516 517 518 519 520 521 522 <li class="md-nav__item"> 523 <a href="ft2-pfr_fonts.html" class="md-nav__link"> 524 PFR Fonts 525 </a> 526 </li> 527 528 529 530 531 532 533 534 <li class="md-nav__item"> 535 <a href="ft2-winfnt_fonts.html" class="md-nav__link"> 536 Window FNT Files 537 </a> 538 </li> 539 540 541 542 543 544 545 546 <li class="md-nav__item"> 547 <a href="ft2-svg_fonts.html" class="md-nav__link"> 548 OpenType SVG Fonts 549 </a> 550 </li> 551 552 553 554 555 556 557 558 559 560 <li class="md-nav__item md-nav__item--active"> 561 562 <input class="md-nav__toggle md-toggle" data-md-toggle="toc" type="checkbox" id="__toc"> 563 564 565 566 567 568 <label class="md-nav__link md-nav__link--active" for="__toc"> 569 Font Formats 570 <span class="md-nav__icon md-icon"></span> 571 </label> 572 573 <a href="ft2-font_formats.html" class="md-nav__link md-nav__link--active"> 574 Font Formats 575 </a> 576 577 578<nav class="md-nav md-nav--secondary" aria-label="Table of contents"> 579 580 581 582 583 584 585 <label class="md-nav__title" for="__toc"> 586 <span class="md-nav__icon md-icon"></span> 587 Table of contents 588 </label> 589 <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix> 590 591 <li class="md-nav__item"> 592 <a href="#synopsis" class="md-nav__link"> 593 Synopsis 594 </a> 595 596</li> 597 598 <li class="md-nav__item"> 599 <a href="#ft_get_font_format" class="md-nav__link"> 600 FT_Get_Font_Format 601 </a> 602 603</li> 604 605 </ul> 606 607</nav> 608 609 </li> 610 611 612 613 614 615 616 617 <li class="md-nav__item"> 618 <a href="ft2-gasp_table.html" class="md-nav__link"> 619 Gasp Table 620 </a> 621 </li> 622 623 624 625 </ul> 626 </nav> 627 </li> 628 629 630 631 632 633 634 635 636 637 638 639 <li class="md-nav__item md-nav__item--nested"> 640 641 642 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_6" type="checkbox" id="__nav_6" > 643 644 <label class="md-nav__link" for="__nav_6"> 645 Controlling FreeType Modules 646 <span class="md-nav__icon md-icon"></span> 647 </label> 648 <nav class="md-nav" aria-label="Controlling FreeType Modules" data-md-level="1"> 649 <label class="md-nav__title" for="__nav_6"> 650 <span class="md-nav__icon md-icon"></span> 651 Controlling FreeType Modules 652 </label> 653 <ul class="md-nav__list" data-md-scrollfix> 654 655 656 657 658 659 <li class="md-nav__item"> 660 <a href="ft2-auto_hinter.html" class="md-nav__link"> 661 The auto-hinter 662 </a> 663 </li> 664 665 666 667 668 669 670 671 <li class="md-nav__item"> 672 <a href="ft2-cff_driver.html" class="md-nav__link"> 673 The CFF driver 674 </a> 675 </li> 676 677 678 679 680 681 682 683 <li class="md-nav__item"> 684 <a href="ft2-t1_cid_driver.html" class="md-nav__link"> 685 The Type 1 and CID drivers 686 </a> 687 </li> 688 689 690 691 692 693 694 695 <li class="md-nav__item"> 696 <a href="ft2-tt_driver.html" class="md-nav__link"> 697 The TrueType driver 698 </a> 699 </li> 700 701 702 703 704 705 706 707 <li class="md-nav__item"> 708 <a href="ft2-pcf_driver.html" class="md-nav__link"> 709 The PCF driver 710 </a> 711 </li> 712 713 714 715 716 717 718 719 <li class="md-nav__item"> 720 <a href="ft2-ot_svg_driver.html" class="md-nav__link"> 721 The SVG driver 722 </a> 723 </li> 724 725 726 727 728 729 730 731 <li class="md-nav__item"> 732 <a href="ft2-properties.html" class="md-nav__link"> 733 Driver properties 734 </a> 735 </li> 736 737 738 739 740 741 742 743 <li class="md-nav__item"> 744 <a href="ft2-parameter_tags.html" class="md-nav__link"> 745 Parameter Tags 746 </a> 747 </li> 748 749 750 751 752 753 754 755 <li class="md-nav__item"> 756 <a href="ft2-lcd_rendering.html" class="md-nav__link"> 757 Subpixel Rendering 758 </a> 759 </li> 760 761 762 763 </ul> 764 </nav> 765 </li> 766 767 768 769 770 771 772 773 774 775 776 777 <li class="md-nav__item md-nav__item--nested"> 778 779 780 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_7" type="checkbox" id="__nav_7" > 781 782 <label class="md-nav__link" for="__nav_7"> 783 Cache Sub-System 784 <span class="md-nav__icon md-icon"></span> 785 </label> 786 <nav class="md-nav" aria-label="Cache Sub-System" data-md-level="1"> 787 <label class="md-nav__title" for="__nav_7"> 788 <span class="md-nav__icon md-icon"></span> 789 Cache Sub-System 790 </label> 791 <ul class="md-nav__list" data-md-scrollfix> 792 793 794 795 796 797 <li class="md-nav__item"> 798 <a href="ft2-cache_subsystem.html" class="md-nav__link"> 799 Cache Sub-System 800 </a> 801 </li> 802 803 804 805 </ul> 806 </nav> 807 </li> 808 809 810 811 812 813 814 815 816 817 818 819 <li class="md-nav__item md-nav__item--nested"> 820 821 822 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_8" type="checkbox" id="__nav_8" > 823 824 <label class="md-nav__link" for="__nav_8"> 825 Support API 826 <span class="md-nav__icon md-icon"></span> 827 </label> 828 <nav class="md-nav" aria-label="Support API" data-md-level="1"> 829 <label class="md-nav__title" for="__nav_8"> 830 <span class="md-nav__icon md-icon"></span> 831 Support API 832 </label> 833 <ul class="md-nav__list" data-md-scrollfix> 834 835 836 837 838 839 <li class="md-nav__item"> 840 <a href="ft2-computations.html" class="md-nav__link"> 841 Computations 842 </a> 843 </li> 844 845 846 847 848 849 850 851 <li class="md-nav__item"> 852 <a href="ft2-list_processing.html" class="md-nav__link"> 853 List Processing 854 </a> 855 </li> 856 857 858 859 860 861 862 863 <li class="md-nav__item"> 864 <a href="ft2-outline_processing.html" class="md-nav__link"> 865 Outline Processing 866 </a> 867 </li> 868 869 870 871 872 873 874 875 <li class="md-nav__item"> 876 <a href="ft2-quick_advance.html" class="md-nav__link"> 877 Quick retrieval of advance values 878 </a> 879 </li> 880 881 882 883 884 885 886 887 <li class="md-nav__item"> 888 <a href="ft2-bitmap_handling.html" class="md-nav__link"> 889 Bitmap Handling 890 </a> 891 </li> 892 893 894 895 896 897 898 899 <li class="md-nav__item"> 900 <a href="ft2-raster.html" class="md-nav__link"> 901 Scanline Converter 902 </a> 903 </li> 904 905 906 907 908 909 910 911 <li class="md-nav__item"> 912 <a href="ft2-glyph_stroker.html" class="md-nav__link"> 913 Glyph Stroker 914 </a> 915 </li> 916 917 918 919 920 921 922 923 <li class="md-nav__item"> 924 <a href="ft2-system_interface.html" class="md-nav__link"> 925 System Interface 926 </a> 927 </li> 928 929 930 931 932 933 934 935 <li class="md-nav__item"> 936 <a href="ft2-module_management.html" class="md-nav__link"> 937 Module Management 938 </a> 939 </li> 940 941 942 943 944 945 946 947 <li class="md-nav__item"> 948 <a href="ft2-gzip.html" class="md-nav__link"> 949 GZIP Streams 950 </a> 951 </li> 952 953 954 955 956 957 958 959 <li class="md-nav__item"> 960 <a href="ft2-lzw.html" class="md-nav__link"> 961 LZW Streams 962 </a> 963 </li> 964 965 966 967 968 969 970 971 <li class="md-nav__item"> 972 <a href="ft2-bzip2.html" class="md-nav__link"> 973 BZIP2 Streams 974 </a> 975 </li> 976 977 978 979 980 981 982 983 <li class="md-nav__item"> 984 <a href="ft2-debugging_apis.html" class="md-nav__link"> 985 External Debugging APIs 986 </a> 987 </li> 988 989 990 991 </ul> 992 </nav> 993 </li> 994 995 996 997 998 999 1000 1001 1002 1003 1004 1005 <li class="md-nav__item md-nav__item--nested"> 1006 1007 1008 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_9" type="checkbox" id="__nav_9" > 1009 1010 <label class="md-nav__link" for="__nav_9"> 1011 Error Codes 1012 <span class="md-nav__icon md-icon"></span> 1013 </label> 1014 <nav class="md-nav" aria-label="Error Codes" data-md-level="1"> 1015 <label class="md-nav__title" for="__nav_9"> 1016 <span class="md-nav__icon md-icon"></span> 1017 Error Codes 1018 </label> 1019 <ul class="md-nav__list" data-md-scrollfix> 1020 1021 1022 1023 1024 1025 <li class="md-nav__item"> 1026 <a href="ft2-error_enumerations.html" class="md-nav__link"> 1027 Error Enumerations 1028 </a> 1029 </li> 1030 1031 1032 1033 1034 1035 1036 1037 <li class="md-nav__item"> 1038 <a href="ft2-error_code_values.html" class="md-nav__link"> 1039 Error Code Values 1040 </a> 1041 </li> 1042 1043 1044 1045 </ul> 1046 </nav> 1047 </li> 1048 1049 1050 1051 1052 1053 1054 1055 1056 1057 1058 1059 <li class="md-nav__item md-nav__item--nested"> 1060 1061 1062 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_10" type="checkbox" id="__nav_10" > 1063 1064 <label class="md-nav__link" for="__nav_10"> 1065 Miscellaneous 1066 <span class="md-nav__icon md-icon"></span> 1067 </label> 1068 <nav class="md-nav" aria-label="Miscellaneous" data-md-level="1"> 1069 <label class="md-nav__title" for="__nav_10"> 1070 <span class="md-nav__icon md-icon"></span> 1071 Miscellaneous 1072 </label> 1073 <ul class="md-nav__list" data-md-scrollfix> 1074 1075 1076 1077 1078 1079 <li class="md-nav__item"> 1080 <a href="ft2-gx_validation.html" class="md-nav__link"> 1081 TrueTypeGX/AAT Validation 1082 </a> 1083 </li> 1084 1085 1086 1087 1088 1089 1090 1091 <li class="md-nav__item"> 1092 <a href="ft2-incremental.html" class="md-nav__link"> 1093 Incremental Loading 1094 </a> 1095 </li> 1096 1097 1098 1099 1100 1101 1102 1103 <li class="md-nav__item"> 1104 <a href="ft2-truetype_engine.html" class="md-nav__link"> 1105 The TrueType Engine 1106 </a> 1107 </li> 1108 1109 1110 1111 1112 1113 1114 1115 <li class="md-nav__item"> 1116 <a href="ft2-ot_validation.html" class="md-nav__link"> 1117 OpenType Validation 1118 </a> 1119 </li> 1120 1121 1122 1123 </ul> 1124 </nav> 1125 </li> 1126 1127 1128 1129 </ul> 1130</nav> 1131 </div> 1132 </div> 1133 </div> 1134 1135 1136 1137 <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" > 1138 <div class="md-sidebar__scrollwrap"> 1139 <div class="md-sidebar__inner"> 1140 1141<nav class="md-nav md-nav--secondary" aria-label="Table of contents"> 1142 1143 1144 1145 1146 1147 1148 <label class="md-nav__title" for="__toc"> 1149 <span class="md-nav__icon md-icon"></span> 1150 Table of contents 1151 </label> 1152 <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix> 1153 1154 <li class="md-nav__item"> 1155 <a href="#synopsis" class="md-nav__link"> 1156 Synopsis 1157 </a> 1158 1159</li> 1160 1161 <li class="md-nav__item"> 1162 <a href="#ft_get_font_format" class="md-nav__link"> 1163 FT_Get_Font_Format 1164 </a> 1165 1166</li> 1167 1168 </ul> 1169 1170</nav> 1171 </div> 1172 </div> 1173 </div> 1174 1175 1176 <div class="md-content" data-md-component="content"> 1177 <article class="md-content__inner md-typeset"> 1178 1179 1180 1181 <p><a href="https://www.freetype.org">FreeType</a> » <a href="../">Docs</a> » <a href="index.html#format-specific-api">Format-Specific API</a> » Font Formats</p> 1182<hr /> 1183<h1 id="font-formats">Font Formats<a class="headerlink" href="#font-formats" title="Permanent link">¶</a></h1> 1184<h2 id="synopsis">Synopsis<a class="headerlink" href="#synopsis" title="Permanent link">¶</a></h2> 1185<p>The single function in this section can be used to get the font format. Note that this information is not needed normally; however, there are special cases (like in PDF devices) where it is important to differentiate, in spite of FreeType's uniform API.</p> 1186<h2 id="ft_get_font_format">FT_Get_Font_Format<a class="headerlink" href="#ft_get_font_format" title="Permanent link">¶</a></h2> 1187<p>Defined in FT_FONT_FORMATS_H (freetype/ftfntfmt.h).</p> 1188<div class = "codehilite"><pre><code> FT_EXPORT( <span class="keyword">const</span> <span class="keyword">char</span>* ) 1189 <b>FT_Get_Font_Format</b>( <a href="ft2-base_interface.html#ft_face">FT_Face</a> face ); 1190 1191 1192 /* deprecated */ 1193 FT_EXPORT( <span class="keyword">const</span> <span class="keyword">char</span>* ) 1194 FT_Get_X11_Font_Format( <a href="ft2-base_interface.html#ft_face">FT_Face</a> face ); 1195</code></pre></div> 1196 1197<p>Return a string describing the format of a given face. Possible values are ‘TrueType’, ‘Type 1’, ‘BDF’, ‘PCF’, ‘Type 42’, ‘CID Type 1’, ‘CFF’, ‘PFR’, and ‘Windows FNT’.</p> 1198<p>The return value is suitable to be used as an X11 FONT_PROPERTY.</p> 1199<h4>input</h4> 1200<table class="fields"> 1201<tr><td class="val" id="face">face</td><td class="desc"> 1202<p>Input face handle.</p> 1203</td></tr> 1204</table> 1205 1206<h4>return</h4> 1207 1208<p>Font format string. <code>NULL</code> in case of error.</p> 1209<h4>note</h4> 1210 1211<p>A deprecated name for the same function is <code>FT_Get_X11_Font_Format</code>.</p> 1212<hr> 1213 1214 1215 1216 1217 1218 1219 1220 </article> 1221 </div> 1222 </div> 1223 1224 </main> 1225 1226 1227<footer class="md-footer"> 1228 1229 <nav class="md-footer__inner md-grid" aria-label="Footer"> 1230 1231 1232 <a href="ft2-svg_fonts.html" class="md-footer__link md-footer__link--prev" aria-label="Previous: OpenType SVG Fonts" rel="prev"> 1233 <div class="md-footer__button md-icon"> 1234 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12z"/></svg> 1235 </div> 1236 <div class="md-footer__title"> 1237 <div class="md-ellipsis"> 1238 <span class="md-footer__direction"> 1239 Previous 1240 </span> 1241 OpenType SVG Fonts 1242 </div> 1243 </div> 1244 </a> 1245 1246 1247 1248 <a href="ft2-gasp_table.html" class="md-footer__link md-footer__link--next" aria-label="Next: Gasp Table" rel="next"> 1249 <div class="md-footer__title"> 1250 <div class="md-ellipsis"> 1251 <span class="md-footer__direction"> 1252 Next 1253 </span> 1254 Gasp Table 1255 </div> 1256 </div> 1257 <div class="md-footer__button md-icon"> 1258 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11H4z"/></svg> 1259 </div> 1260 </a> 1261 1262 </nav> 1263 1264 <div class="md-footer-meta md-typeset"> 1265 <div class="md-footer-meta__inner md-grid"> 1266 <div class="md-footer-copyright"> 1267 1268 <div class="md-footer-copyright__highlight"> 1269 Copyright 2022 <a href = "https://www.freetype.org/license.html">The FreeType Project</a>. 1270 </div> 1271 1272 Made with 1273 <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener"> 1274 Material for MkDocs 1275 </a> 1276 1277 </div> 1278 1279 </div> 1280 </div> 1281</footer> 1282 1283 </div> 1284 <div class="md-dialog" data-md-component="dialog"> 1285 <div class="md-dialog__inner md-typeset"></div> 1286 </div> 1287 <script id="__config" type="application/json">{"base": ".", "features": [], "translations": {"clipboard.copy": "Copy to clipboard", "clipboard.copied": "Copied to clipboard", "search.config.lang": "en", "search.config.pipeline": "trimmer, stopWordFilter", "search.config.separator": "[\\s\\-]+", "search.placeholder": "Search", "search.result.placeholder": "Type to start searching", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.term.missing": "Missing", "select.version.title": "Select version"}, "search": "assets/javascripts/workers/search.477d984a.min.js", "version": null}</script> 1288 1289 1290 <script src="assets/javascripts/bundle.82b56eb2.min.js"></script> 1291 1292 <script src="javascripts/extra.js"></script> 1293 1294 1295 </body> 1296</html>