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