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>FreeType Version - 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="#freetype-version" 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 FreeType Version 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 279 280 <li class="md-nav__item md-nav__item--active md-nav__item--nested"> 281 282 283 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_4" type="checkbox" id="__nav_4" checked> 284 285 <label class="md-nav__link" for="__nav_4"> 286 Core API 287 <span class="md-nav__icon md-icon"></span> 288 </label> 289 <nav class="md-nav" aria-label="Core API" data-md-level="1"> 290 <label class="md-nav__title" for="__nav_4"> 291 <span class="md-nav__icon md-icon"></span> 292 Core API 293 </label> 294 <ul class="md-nav__list" data-md-scrollfix> 295 296 297 298 299 300 301 302 <li class="md-nav__item md-nav__item--active"> 303 304 <input class="md-nav__toggle md-toggle" data-md-toggle="toc" type="checkbox" id="__toc"> 305 306 307 308 309 310 <label class="md-nav__link md-nav__link--active" for="__toc"> 311 FreeType Version 312 <span class="md-nav__icon md-icon"></span> 313 </label> 314 315 <a href="ft2-version.html" class="md-nav__link md-nav__link--active"> 316 FreeType Version 317 </a> 318 319 320<nav class="md-nav md-nav--secondary" aria-label="Table of contents"> 321 322 323 324 325 326 327 <label class="md-nav__title" for="__toc"> 328 <span class="md-nav__icon md-icon"></span> 329 Table of contents 330 </label> 331 <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix> 332 333 <li class="md-nav__item"> 334 <a href="#synopsis" class="md-nav__link"> 335 Synopsis 336 </a> 337 338</li> 339 340 <li class="md-nav__item"> 341 <a href="#ft_library_version" class="md-nav__link"> 342 FT_Library_Version 343 </a> 344 345</li> 346 347 <li class="md-nav__item"> 348 <a href="#ft_face_checktruetypepatents" class="md-nav__link"> 349 FT_Face_CheckTrueTypePatents 350 </a> 351 352</li> 353 354 <li class="md-nav__item"> 355 <a href="#ft_face_setunpatentedhinting" class="md-nav__link"> 356 FT_Face_SetUnpatentedHinting 357 </a> 358 359</li> 360 361 <li class="md-nav__item"> 362 <a href="#freetype_xxx" class="md-nav__link"> 363 FREETYPE_XXX 364 </a> 365 366</li> 367 368 </ul> 369 370</nav> 371 372 </li> 373 374 375 376 377 378 379 380 <li class="md-nav__item"> 381 <a href="ft2-basic_types.html" class="md-nav__link"> 382 Basic Data Types 383 </a> 384 </li> 385 386 387 388 389 390 391 392 <li class="md-nav__item"> 393 <a href="ft2-base_interface.html" class="md-nav__link"> 394 Base Interface 395 </a> 396 </li> 397 398 399 400 401 402 403 404 <li class="md-nav__item"> 405 <a href="ft2-glyph_variants.html" class="md-nav__link"> 406 Unicode Variation Sequences 407 </a> 408 </li> 409 410 411 412 413 414 415 416 <li class="md-nav__item"> 417 <a href="ft2-color_management.html" class="md-nav__link"> 418 Glyph Color Management 419 </a> 420 </li> 421 422 423 424 425 426 427 428 <li class="md-nav__item"> 429 <a href="ft2-layer_management.html" class="md-nav__link"> 430 Glyph Layer Management 431 </a> 432 </li> 433 434 435 436 437 438 439 440 <li class="md-nav__item"> 441 <a href="ft2-glyph_management.html" class="md-nav__link"> 442 Glyph Management 443 </a> 444 </li> 445 446 447 448 449 450 451 452 <li class="md-nav__item"> 453 <a href="ft2-mac_specific.html" class="md-nav__link"> 454 Mac Specific Interface 455 </a> 456 </li> 457 458 459 460 461 462 463 464 <li class="md-nav__item"> 465 <a href="ft2-sizes_management.html" class="md-nav__link"> 466 Size Management 467 </a> 468 </li> 469 470 471 472 473 474 475 476 <li class="md-nav__item"> 477 <a href="ft2-header_file_macros.html" class="md-nav__link"> 478 Header File Macros 479 </a> 480 </li> 481 482 483 484 </ul> 485 </nav> 486 </li> 487 488 489 490 491 492 493 494 495 496 497 498 <li class="md-nav__item md-nav__item--nested"> 499 500 501 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_5" type="checkbox" id="__nav_5" > 502 503 <label class="md-nav__link" for="__nav_5"> 504 Format-Specific API 505 <span class="md-nav__icon md-icon"></span> 506 </label> 507 <nav class="md-nav" aria-label="Format-Specific API" data-md-level="1"> 508 <label class="md-nav__title" for="__nav_5"> 509 <span class="md-nav__icon md-icon"></span> 510 Format-Specific API 511 </label> 512 <ul class="md-nav__list" data-md-scrollfix> 513 514 515 516 517 518 <li class="md-nav__item"> 519 <a href="ft2-multiple_masters.html" class="md-nav__link"> 520 Multiple Masters 521 </a> 522 </li> 523 524 525 526 527 528 529 530 <li class="md-nav__item"> 531 <a href="ft2-truetype_tables.html" class="md-nav__link"> 532 TrueType Tables 533 </a> 534 </li> 535 536 537 538 539 540 541 542 <li class="md-nav__item"> 543 <a href="ft2-type1_tables.html" class="md-nav__link"> 544 Type 1 Tables 545 </a> 546 </li> 547 548 549 550 551 552 553 554 <li class="md-nav__item"> 555 <a href="ft2-sfnt_names.html" class="md-nav__link"> 556 SFNT Names 557 </a> 558 </li> 559 560 561 562 563 564 565 566 <li class="md-nav__item"> 567 <a href="ft2-bdf_fonts.html" class="md-nav__link"> 568 BDF and PCF Files 569 </a> 570 </li> 571 572 573 574 575 576 577 578 <li class="md-nav__item"> 579 <a href="ft2-cid_fonts.html" class="md-nav__link"> 580 CID Fonts 581 </a> 582 </li> 583 584 585 586 587 588 589 590 <li class="md-nav__item"> 591 <a href="ft2-pfr_fonts.html" class="md-nav__link"> 592 PFR Fonts 593 </a> 594 </li> 595 596 597 598 599 600 601 602 <li class="md-nav__item"> 603 <a href="ft2-winfnt_fonts.html" class="md-nav__link"> 604 Window FNT Files 605 </a> 606 </li> 607 608 609 610 611 612 613 614 <li class="md-nav__item"> 615 <a href="ft2-svg_fonts.html" class="md-nav__link"> 616 OpenType SVG Fonts 617 </a> 618 </li> 619 620 621 622 623 624 625 626 <li class="md-nav__item"> 627 <a href="ft2-font_formats.html" class="md-nav__link"> 628 Font Formats 629 </a> 630 </li> 631 632 633 634 635 636 637 638 <li class="md-nav__item"> 639 <a href="ft2-gasp_table.html" class="md-nav__link"> 640 Gasp Table 641 </a> 642 </li> 643 644 645 646 </ul> 647 </nav> 648 </li> 649 650 651 652 653 654 655 656 657 658 659 660 <li class="md-nav__item md-nav__item--nested"> 661 662 663 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_6" type="checkbox" id="__nav_6" > 664 665 <label class="md-nav__link" for="__nav_6"> 666 Controlling FreeType Modules 667 <span class="md-nav__icon md-icon"></span> 668 </label> 669 <nav class="md-nav" aria-label="Controlling FreeType Modules" data-md-level="1"> 670 <label class="md-nav__title" for="__nav_6"> 671 <span class="md-nav__icon md-icon"></span> 672 Controlling FreeType Modules 673 </label> 674 <ul class="md-nav__list" data-md-scrollfix> 675 676 677 678 679 680 <li class="md-nav__item"> 681 <a href="ft2-auto_hinter.html" class="md-nav__link"> 682 The auto-hinter 683 </a> 684 </li> 685 686 687 688 689 690 691 692 <li class="md-nav__item"> 693 <a href="ft2-cff_driver.html" class="md-nav__link"> 694 The CFF driver 695 </a> 696 </li> 697 698 699 700 701 702 703 704 <li class="md-nav__item"> 705 <a href="ft2-t1_cid_driver.html" class="md-nav__link"> 706 The Type 1 and CID drivers 707 </a> 708 </li> 709 710 711 712 713 714 715 716 <li class="md-nav__item"> 717 <a href="ft2-tt_driver.html" class="md-nav__link"> 718 The TrueType driver 719 </a> 720 </li> 721 722 723 724 725 726 727 728 <li class="md-nav__item"> 729 <a href="ft2-pcf_driver.html" class="md-nav__link"> 730 The PCF driver 731 </a> 732 </li> 733 734 735 736 737 738 739 740 <li class="md-nav__item"> 741 <a href="ft2-ot_svg_driver.html" class="md-nav__link"> 742 The SVG driver 743 </a> 744 </li> 745 746 747 748 749 750 751 752 <li class="md-nav__item"> 753 <a href="ft2-properties.html" class="md-nav__link"> 754 Driver properties 755 </a> 756 </li> 757 758 759 760 761 762 763 764 <li class="md-nav__item"> 765 <a href="ft2-parameter_tags.html" class="md-nav__link"> 766 Parameter Tags 767 </a> 768 </li> 769 770 771 772 773 774 775 776 <li class="md-nav__item"> 777 <a href="ft2-lcd_rendering.html" class="md-nav__link"> 778 Subpixel Rendering 779 </a> 780 </li> 781 782 783 784 </ul> 785 </nav> 786 </li> 787 788 789 790 791 792 793 794 795 796 797 798 <li class="md-nav__item md-nav__item--nested"> 799 800 801 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_7" type="checkbox" id="__nav_7" > 802 803 <label class="md-nav__link" for="__nav_7"> 804 Cache Sub-System 805 <span class="md-nav__icon md-icon"></span> 806 </label> 807 <nav class="md-nav" aria-label="Cache Sub-System" data-md-level="1"> 808 <label class="md-nav__title" for="__nav_7"> 809 <span class="md-nav__icon md-icon"></span> 810 Cache Sub-System 811 </label> 812 <ul class="md-nav__list" data-md-scrollfix> 813 814 815 816 817 818 <li class="md-nav__item"> 819 <a href="ft2-cache_subsystem.html" class="md-nav__link"> 820 Cache Sub-System 821 </a> 822 </li> 823 824 825 826 </ul> 827 </nav> 828 </li> 829 830 831 832 833 834 835 836 837 838 839 840 <li class="md-nav__item md-nav__item--nested"> 841 842 843 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_8" type="checkbox" id="__nav_8" > 844 845 <label class="md-nav__link" for="__nav_8"> 846 Support API 847 <span class="md-nav__icon md-icon"></span> 848 </label> 849 <nav class="md-nav" aria-label="Support API" data-md-level="1"> 850 <label class="md-nav__title" for="__nav_8"> 851 <span class="md-nav__icon md-icon"></span> 852 Support API 853 </label> 854 <ul class="md-nav__list" data-md-scrollfix> 855 856 857 858 859 860 <li class="md-nav__item"> 861 <a href="ft2-computations.html" class="md-nav__link"> 862 Computations 863 </a> 864 </li> 865 866 867 868 869 870 871 872 <li class="md-nav__item"> 873 <a href="ft2-list_processing.html" class="md-nav__link"> 874 List Processing 875 </a> 876 </li> 877 878 879 880 881 882 883 884 <li class="md-nav__item"> 885 <a href="ft2-outline_processing.html" class="md-nav__link"> 886 Outline Processing 887 </a> 888 </li> 889 890 891 892 893 894 895 896 <li class="md-nav__item"> 897 <a href="ft2-quick_advance.html" class="md-nav__link"> 898 Quick retrieval of advance values 899 </a> 900 </li> 901 902 903 904 905 906 907 908 <li class="md-nav__item"> 909 <a href="ft2-bitmap_handling.html" class="md-nav__link"> 910 Bitmap Handling 911 </a> 912 </li> 913 914 915 916 917 918 919 920 <li class="md-nav__item"> 921 <a href="ft2-raster.html" class="md-nav__link"> 922 Scanline Converter 923 </a> 924 </li> 925 926 927 928 929 930 931 932 <li class="md-nav__item"> 933 <a href="ft2-glyph_stroker.html" class="md-nav__link"> 934 Glyph Stroker 935 </a> 936 </li> 937 938 939 940 941 942 943 944 <li class="md-nav__item"> 945 <a href="ft2-system_interface.html" class="md-nav__link"> 946 System Interface 947 </a> 948 </li> 949 950 951 952 953 954 955 956 <li class="md-nav__item"> 957 <a href="ft2-module_management.html" class="md-nav__link"> 958 Module Management 959 </a> 960 </li> 961 962 963 964 965 966 967 968 <li class="md-nav__item"> 969 <a href="ft2-gzip.html" class="md-nav__link"> 970 GZIP Streams 971 </a> 972 </li> 973 974 975 976 977 978 979 980 <li class="md-nav__item"> 981 <a href="ft2-lzw.html" class="md-nav__link"> 982 LZW Streams 983 </a> 984 </li> 985 986 987 988 989 990 991 992 <li class="md-nav__item"> 993 <a href="ft2-bzip2.html" class="md-nav__link"> 994 BZIP2 Streams 995 </a> 996 </li> 997 998 999 1000 1001 1002 1003 1004 <li class="md-nav__item"> 1005 <a href="ft2-debugging_apis.html" class="md-nav__link"> 1006 External Debugging APIs 1007 </a> 1008 </li> 1009 1010 1011 1012 </ul> 1013 </nav> 1014 </li> 1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025 1026 <li class="md-nav__item md-nav__item--nested"> 1027 1028 1029 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_9" type="checkbox" id="__nav_9" > 1030 1031 <label class="md-nav__link" for="__nav_9"> 1032 Error Codes 1033 <span class="md-nav__icon md-icon"></span> 1034 </label> 1035 <nav class="md-nav" aria-label="Error Codes" data-md-level="1"> 1036 <label class="md-nav__title" for="__nav_9"> 1037 <span class="md-nav__icon md-icon"></span> 1038 Error Codes 1039 </label> 1040 <ul class="md-nav__list" data-md-scrollfix> 1041 1042 1043 1044 1045 1046 <li class="md-nav__item"> 1047 <a href="ft2-error_enumerations.html" class="md-nav__link"> 1048 Error Enumerations 1049 </a> 1050 </li> 1051 1052 1053 1054 1055 1056 1057 1058 <li class="md-nav__item"> 1059 <a href="ft2-error_code_values.html" class="md-nav__link"> 1060 Error Code Values 1061 </a> 1062 </li> 1063 1064 1065 1066 </ul> 1067 </nav> 1068 </li> 1069 1070 1071 1072 1073 1074 1075 1076 1077 1078 1079 1080 <li class="md-nav__item md-nav__item--nested"> 1081 1082 1083 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_10" type="checkbox" id="__nav_10" > 1084 1085 <label class="md-nav__link" for="__nav_10"> 1086 Miscellaneous 1087 <span class="md-nav__icon md-icon"></span> 1088 </label> 1089 <nav class="md-nav" aria-label="Miscellaneous" data-md-level="1"> 1090 <label class="md-nav__title" for="__nav_10"> 1091 <span class="md-nav__icon md-icon"></span> 1092 Miscellaneous 1093 </label> 1094 <ul class="md-nav__list" data-md-scrollfix> 1095 1096 1097 1098 1099 1100 <li class="md-nav__item"> 1101 <a href="ft2-gx_validation.html" class="md-nav__link"> 1102 TrueTypeGX/AAT Validation 1103 </a> 1104 </li> 1105 1106 1107 1108 1109 1110 1111 1112 <li class="md-nav__item"> 1113 <a href="ft2-incremental.html" class="md-nav__link"> 1114 Incremental Loading 1115 </a> 1116 </li> 1117 1118 1119 1120 1121 1122 1123 1124 <li class="md-nav__item"> 1125 <a href="ft2-truetype_engine.html" class="md-nav__link"> 1126 The TrueType Engine 1127 </a> 1128 </li> 1129 1130 1131 1132 1133 1134 1135 1136 <li class="md-nav__item"> 1137 <a href="ft2-ot_validation.html" class="md-nav__link"> 1138 OpenType Validation 1139 </a> 1140 </li> 1141 1142 1143 1144 </ul> 1145 </nav> 1146 </li> 1147 1148 1149 1150 </ul> 1151</nav> 1152 </div> 1153 </div> 1154 </div> 1155 1156 1157 1158 <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" > 1159 <div class="md-sidebar__scrollwrap"> 1160 <div class="md-sidebar__inner"> 1161 1162<nav class="md-nav md-nav--secondary" aria-label="Table of contents"> 1163 1164 1165 1166 1167 1168 1169 <label class="md-nav__title" for="__toc"> 1170 <span class="md-nav__icon md-icon"></span> 1171 Table of contents 1172 </label> 1173 <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix> 1174 1175 <li class="md-nav__item"> 1176 <a href="#synopsis" class="md-nav__link"> 1177 Synopsis 1178 </a> 1179 1180</li> 1181 1182 <li class="md-nav__item"> 1183 <a href="#ft_library_version" class="md-nav__link"> 1184 FT_Library_Version 1185 </a> 1186 1187</li> 1188 1189 <li class="md-nav__item"> 1190 <a href="#ft_face_checktruetypepatents" class="md-nav__link"> 1191 FT_Face_CheckTrueTypePatents 1192 </a> 1193 1194</li> 1195 1196 <li class="md-nav__item"> 1197 <a href="#ft_face_setunpatentedhinting" class="md-nav__link"> 1198 FT_Face_SetUnpatentedHinting 1199 </a> 1200 1201</li> 1202 1203 <li class="md-nav__item"> 1204 <a href="#freetype_xxx" class="md-nav__link"> 1205 FREETYPE_XXX 1206 </a> 1207 1208</li> 1209 1210 </ul> 1211 1212</nav> 1213 </div> 1214 </div> 1215 </div> 1216 1217 1218 <div class="md-content" data-md-component="content"> 1219 <article class="md-content__inner md-typeset"> 1220 1221 1222 1223 <p><a href="https://www.freetype.org">FreeType</a> » <a href="../">Docs</a> » <a href="index.html#core-api">Core API</a> » FreeType Version</p> 1224<hr /> 1225<h1 id="freetype-version">FreeType Version<a class="headerlink" href="#freetype-version" title="Permanent link">¶</a></h1> 1226<h2 id="synopsis">Synopsis<a class="headerlink" href="#synopsis" title="Permanent link">¶</a></h2> 1227<p>Note that those functions and macros are of limited use because even a new release of FreeType with only documentation changes increases the version number.</p> 1228<h2 id="ft_library_version">FT_Library_Version<a class="headerlink" href="#ft_library_version" title="Permanent link">¶</a></h2> 1229<p>Defined in FT_FREETYPE_H (freetype/freetype.h).</p> 1230<div class = "codehilite"><pre><code> FT_EXPORT( <span class="keyword">void</span> ) 1231 <b>FT_Library_Version</b>( <a href="ft2-base_interface.html#ft_library">FT_Library</a> library, 1232 <a href="ft2-basic_types.html#ft_int">FT_Int</a> *amajor, 1233 <a href="ft2-basic_types.html#ft_int">FT_Int</a> *aminor, 1234 <a href="ft2-basic_types.html#ft_int">FT_Int</a> *apatch ); 1235</code></pre></div> 1236 1237<p>Return the version of the FreeType library being used. This is useful when dynamically linking to the library, since one cannot use the macros <code><a href="ft2-version.html#freetype_xxx">FREETYPE_MAJOR</a></code>, <code><a href="ft2-version.html#freetype_xxx">FREETYPE_MINOR</a></code>, and <code><a href="ft2-version.html#freetype_xxx">FREETYPE_PATCH</a></code>.</p> 1238<h4>input</h4> 1239<table class="fields"> 1240<tr><td class="val" id="library">library</td><td class="desc"> 1241<p>A source library handle.</p> 1242</td></tr> 1243</table> 1244 1245<h4>output</h4> 1246<table class="fields"> 1247<tr><td class="val" id="amajor">amajor</td><td class="desc"> 1248<p>The major version number.</p> 1249</td></tr> 1250<tr><td class="val" id="aminor">aminor</td><td class="desc"> 1251<p>The minor version number.</p> 1252</td></tr> 1253<tr><td class="val" id="apatch">apatch</td><td class="desc"> 1254<p>The patch version number.</p> 1255</td></tr> 1256</table> 1257 1258<h4>note</h4> 1259 1260<p>The reason why this function takes a <code>library</code> argument is because certain programs implement library initialization in a custom way that doesn't use <code><a href="ft2-base_interface.html#ft_init_freetype">FT_Init_FreeType</a></code>.</p> 1261<p>In such cases, the library version might not be available before the library object has been created.</p> 1262<hr> 1263 1264<h2 id="ft_face_checktruetypepatents">FT_Face_CheckTrueTypePatents<a class="headerlink" href="#ft_face_checktruetypepatents" title="Permanent link">¶</a></h2> 1265<p>Defined in FT_FREETYPE_H (freetype/freetype.h).</p> 1266<div class = "codehilite"><pre><code> FT_EXPORT( <a href="ft2-basic_types.html#ft_bool">FT_Bool</a> ) 1267 <b>FT_Face_CheckTrueTypePatents</b>( <a href="ft2-base_interface.html#ft_face">FT_Face</a> face ); 1268</code></pre></div> 1269 1270<p>Deprecated, does nothing.</p> 1271<h4>input</h4> 1272<table class="fields"> 1273<tr><td class="val" id="face">face</td><td class="desc"> 1274<p>A face handle.</p> 1275</td></tr> 1276</table> 1277 1278<h4>return</h4> 1279 1280<p>Always returns false.</p> 1281<h4>note</h4> 1282 1283<p>Since May 2010, TrueType hinting is no longer patented.</p> 1284<h4>since</h4> 1285 1286<p>2.3.5</p> 1287<hr> 1288 1289<h2 id="ft_face_setunpatentedhinting">FT_Face_SetUnpatentedHinting<a class="headerlink" href="#ft_face_setunpatentedhinting" title="Permanent link">¶</a></h2> 1290<p>Defined in FT_FREETYPE_H (freetype/freetype.h).</p> 1291<div class = "codehilite"><pre><code> FT_EXPORT( <a href="ft2-basic_types.html#ft_bool">FT_Bool</a> ) 1292 <b>FT_Face_SetUnpatentedHinting</b>( <a href="ft2-base_interface.html#ft_face">FT_Face</a> face, 1293 <a href="ft2-basic_types.html#ft_bool">FT_Bool</a> value ); 1294</code></pre></div> 1295 1296<p>Deprecated, does nothing.</p> 1297<h4>input</h4> 1298<table class="fields"> 1299<tr><td class="val" id="face">face</td><td class="desc"> 1300<p>A face handle.</p> 1301</td></tr> 1302<tr><td class="val" id="value">value</td><td class="desc"> 1303<p>New boolean setting.</p> 1304</td></tr> 1305</table> 1306 1307<h4>return</h4> 1308 1309<p>Always returns false.</p> 1310<h4>note</h4> 1311 1312<p>Since May 2010, TrueType hinting is no longer patented.</p> 1313<h4>since</h4> 1314 1315<p>2.3.5</p> 1316<hr> 1317 1318<h2 id="freetype_xxx">FREETYPE_XXX<a class="headerlink" href="#freetype_xxx" title="Permanent link">¶</a></h2> 1319<p>Defined in FT_FREETYPE_H (freetype/freetype.h).</p> 1320<div class = "codehilite"><pre><code>#<span class="keyword">define</span> <a href="ft2-version.html#freetype_major">FREETYPE_MAJOR</a> 2 1321#<span class="keyword">define</span> <a href="ft2-version.html#freetype_minor">FREETYPE_MINOR</a> 12 1322#<span class="keyword">define</span> <a href="ft2-version.html#freetype_patch">FREETYPE_PATCH</a> 1 1323</code></pre></div> 1324 1325<p>These three macros identify the FreeType source code version. Use <code><a href="ft2-version.html#ft_library_version">FT_Library_Version</a></code> to access them at runtime.</p> 1326<h4>values</h4> 1327<table class="fields"> 1328<tr><td class="val" id="freetype_major">FREETYPE_MAJOR</td><td class="desc"> 1329<p>The major version number.</p> 1330</td></tr> 1331<tr><td class="val" id="freetype_minor">FREETYPE_MINOR</td><td class="desc"> 1332<p>The minor version number.</p> 1333</td></tr> 1334<tr><td class="val" id="freetype_patch">FREETYPE_PATCH</td><td class="desc"> 1335<p>The patch level.</p> 1336</td></tr> 1337</table> 1338 1339<h4>note</h4> 1340 1341<p>The version number of FreeType if built as a dynamic link library with the ‘libtool’ package is <em>not</em> controlled by these three macros.</p> 1342<hr> 1343 1344 1345 1346 1347 1348 1349 1350 </article> 1351 </div> 1352 </div> 1353 1354 </main> 1355 1356 1357<footer class="md-footer"> 1358 1359 <nav class="md-footer__inner md-grid" aria-label="Footer"> 1360 1361 1362 <a href="ft2-user_allocation.html" class="md-footer__link md-footer__link--prev" aria-label="Previous: User allocation" rel="prev"> 1363 <div class="md-footer__button md-icon"> 1364 <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> 1365 </div> 1366 <div class="md-footer__title"> 1367 <div class="md-ellipsis"> 1368 <span class="md-footer__direction"> 1369 Previous 1370 </span> 1371 User allocation 1372 </div> 1373 </div> 1374 </a> 1375 1376 1377 1378 <a href="ft2-basic_types.html" class="md-footer__link md-footer__link--next" aria-label="Next: Basic Data Types" rel="next"> 1379 <div class="md-footer__title"> 1380 <div class="md-ellipsis"> 1381 <span class="md-footer__direction"> 1382 Next 1383 </span> 1384 Basic Data Types 1385 </div> 1386 </div> 1387 <div class="md-footer__button md-icon"> 1388 <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> 1389 </div> 1390 </a> 1391 1392 </nav> 1393 1394 <div class="md-footer-meta md-typeset"> 1395 <div class="md-footer-meta__inner md-grid"> 1396 <div class="md-footer-copyright"> 1397 1398 <div class="md-footer-copyright__highlight"> 1399 Copyright 2022 <a href = "https://www.freetype.org/license.html">The FreeType Project</a>. 1400 </div> 1401 1402 Made with 1403 <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener"> 1404 Material for MkDocs 1405 </a> 1406 1407 </div> 1408 1409 </div> 1410 </div> 1411</footer> 1412 1413 </div> 1414 <div class="md-dialog" data-md-component="dialog"> 1415 <div class="md-dialog__inner md-typeset"></div> 1416 </div> 1417 <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> 1418 1419 1420 <script src="assets/javascripts/bundle.82b56eb2.min.js"></script> 1421 1422 <script src="javascripts/extra.js"></script> 1423 1424 1425 </body> 1426</html>