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>Mac Specific Interface - 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="#mac-specific-interface" 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 Mac Specific Interface 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 <li class="md-nav__item"> 301 <a href="ft2-version.html" class="md-nav__link"> 302 FreeType Version 303 </a> 304 </li> 305 306 307 308 309 310 311 312 <li class="md-nav__item"> 313 <a href="ft2-basic_types.html" class="md-nav__link"> 314 Basic Data Types 315 </a> 316 </li> 317 318 319 320 321 322 323 324 <li class="md-nav__item"> 325 <a href="ft2-base_interface.html" class="md-nav__link"> 326 Base Interface 327 </a> 328 </li> 329 330 331 332 333 334 335 336 <li class="md-nav__item"> 337 <a href="ft2-glyph_variants.html" class="md-nav__link"> 338 Unicode Variation Sequences 339 </a> 340 </li> 341 342 343 344 345 346 347 348 <li class="md-nav__item"> 349 <a href="ft2-color_management.html" class="md-nav__link"> 350 Glyph Color Management 351 </a> 352 </li> 353 354 355 356 357 358 359 360 <li class="md-nav__item"> 361 <a href="ft2-layer_management.html" class="md-nav__link"> 362 Glyph Layer Management 363 </a> 364 </li> 365 366 367 368 369 370 371 372 <li class="md-nav__item"> 373 <a href="ft2-glyph_management.html" class="md-nav__link"> 374 Glyph Management 375 </a> 376 </li> 377 378 379 380 381 382 383 384 385 386 <li class="md-nav__item md-nav__item--active"> 387 388 <input class="md-nav__toggle md-toggle" data-md-toggle="toc" type="checkbox" id="__toc"> 389 390 391 392 393 394 <label class="md-nav__link md-nav__link--active" for="__toc"> 395 Mac Specific Interface 396 <span class="md-nav__icon md-icon"></span> 397 </label> 398 399 <a href="ft2-mac_specific.html" class="md-nav__link md-nav__link--active"> 400 Mac Specific Interface 401 </a> 402 403 404<nav class="md-nav md-nav--secondary" aria-label="Table of contents"> 405 406 407 408 409 410 411 <label class="md-nav__title" for="__toc"> 412 <span class="md-nav__icon md-icon"></span> 413 Table of contents 414 </label> 415 <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix> 416 417 <li class="md-nav__item"> 418 <a href="#synopsis" class="md-nav__link"> 419 Synopsis 420 </a> 421 422</li> 423 424 <li class="md-nav__item"> 425 <a href="#ft_new_face_from_fond" class="md-nav__link"> 426 FT_New_Face_From_FOND 427 </a> 428 429</li> 430 431 <li class="md-nav__item"> 432 <a href="#ft_getfile_from_mac_name" class="md-nav__link"> 433 FT_GetFile_From_Mac_Name 434 </a> 435 436</li> 437 438 <li class="md-nav__item"> 439 <a href="#ft_getfile_from_mac_ats_name" class="md-nav__link"> 440 FT_GetFile_From_Mac_ATS_Name 441 </a> 442 443</li> 444 445 <li class="md-nav__item"> 446 <a href="#ft_getfilepath_from_mac_ats_name" class="md-nav__link"> 447 FT_GetFilePath_From_Mac_ATS_Name 448 </a> 449 450</li> 451 452 <li class="md-nav__item"> 453 <a href="#ft_new_face_from_fsspec" class="md-nav__link"> 454 FT_New_Face_From_FSSpec 455 </a> 456 457</li> 458 459 <li class="md-nav__item"> 460 <a href="#ft_new_face_from_fsref" class="md-nav__link"> 461 FT_New_Face_From_FSRef 462 </a> 463 464</li> 465 466 </ul> 467 468</nav> 469 470 </li> 471 472 473 474 475 476 477 478 <li class="md-nav__item"> 479 <a href="ft2-sizes_management.html" class="md-nav__link"> 480 Size Management 481 </a> 482 </li> 483 484 485 486 487 488 489 490 <li class="md-nav__item"> 491 <a href="ft2-header_file_macros.html" class="md-nav__link"> 492 Header File Macros 493 </a> 494 </li> 495 496 497 498 </ul> 499 </nav> 500 </li> 501 502 503 504 505 506 507 508 509 510 511 512 <li class="md-nav__item md-nav__item--nested"> 513 514 515 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_5" type="checkbox" id="__nav_5" > 516 517 <label class="md-nav__link" for="__nav_5"> 518 Format-Specific API 519 <span class="md-nav__icon md-icon"></span> 520 </label> 521 <nav class="md-nav" aria-label="Format-Specific API" data-md-level="1"> 522 <label class="md-nav__title" for="__nav_5"> 523 <span class="md-nav__icon md-icon"></span> 524 Format-Specific API 525 </label> 526 <ul class="md-nav__list" data-md-scrollfix> 527 528 529 530 531 532 <li class="md-nav__item"> 533 <a href="ft2-multiple_masters.html" class="md-nav__link"> 534 Multiple Masters 535 </a> 536 </li> 537 538 539 540 541 542 543 544 <li class="md-nav__item"> 545 <a href="ft2-truetype_tables.html" class="md-nav__link"> 546 TrueType Tables 547 </a> 548 </li> 549 550 551 552 553 554 555 556 <li class="md-nav__item"> 557 <a href="ft2-type1_tables.html" class="md-nav__link"> 558 Type 1 Tables 559 </a> 560 </li> 561 562 563 564 565 566 567 568 <li class="md-nav__item"> 569 <a href="ft2-sfnt_names.html" class="md-nav__link"> 570 SFNT Names 571 </a> 572 </li> 573 574 575 576 577 578 579 580 <li class="md-nav__item"> 581 <a href="ft2-bdf_fonts.html" class="md-nav__link"> 582 BDF and PCF Files 583 </a> 584 </li> 585 586 587 588 589 590 591 592 <li class="md-nav__item"> 593 <a href="ft2-cid_fonts.html" class="md-nav__link"> 594 CID Fonts 595 </a> 596 </li> 597 598 599 600 601 602 603 604 <li class="md-nav__item"> 605 <a href="ft2-pfr_fonts.html" class="md-nav__link"> 606 PFR Fonts 607 </a> 608 </li> 609 610 611 612 613 614 615 616 <li class="md-nav__item"> 617 <a href="ft2-winfnt_fonts.html" class="md-nav__link"> 618 Window FNT Files 619 </a> 620 </li> 621 622 623 624 625 626 627 628 <li class="md-nav__item"> 629 <a href="ft2-svg_fonts.html" class="md-nav__link"> 630 OpenType SVG Fonts 631 </a> 632 </li> 633 634 635 636 637 638 639 640 <li class="md-nav__item"> 641 <a href="ft2-font_formats.html" class="md-nav__link"> 642 Font Formats 643 </a> 644 </li> 645 646 647 648 649 650 651 652 <li class="md-nav__item"> 653 <a href="ft2-gasp_table.html" class="md-nav__link"> 654 Gasp Table 655 </a> 656 </li> 657 658 659 660 </ul> 661 </nav> 662 </li> 663 664 665 666 667 668 669 670 671 672 673 674 <li class="md-nav__item md-nav__item--nested"> 675 676 677 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_6" type="checkbox" id="__nav_6" > 678 679 <label class="md-nav__link" for="__nav_6"> 680 Controlling FreeType Modules 681 <span class="md-nav__icon md-icon"></span> 682 </label> 683 <nav class="md-nav" aria-label="Controlling FreeType Modules" data-md-level="1"> 684 <label class="md-nav__title" for="__nav_6"> 685 <span class="md-nav__icon md-icon"></span> 686 Controlling FreeType Modules 687 </label> 688 <ul class="md-nav__list" data-md-scrollfix> 689 690 691 692 693 694 <li class="md-nav__item"> 695 <a href="ft2-auto_hinter.html" class="md-nav__link"> 696 The auto-hinter 697 </a> 698 </li> 699 700 701 702 703 704 705 706 <li class="md-nav__item"> 707 <a href="ft2-cff_driver.html" class="md-nav__link"> 708 The CFF driver 709 </a> 710 </li> 711 712 713 714 715 716 717 718 <li class="md-nav__item"> 719 <a href="ft2-t1_cid_driver.html" class="md-nav__link"> 720 The Type 1 and CID drivers 721 </a> 722 </li> 723 724 725 726 727 728 729 730 <li class="md-nav__item"> 731 <a href="ft2-tt_driver.html" class="md-nav__link"> 732 The TrueType driver 733 </a> 734 </li> 735 736 737 738 739 740 741 742 <li class="md-nav__item"> 743 <a href="ft2-pcf_driver.html" class="md-nav__link"> 744 The PCF driver 745 </a> 746 </li> 747 748 749 750 751 752 753 754 <li class="md-nav__item"> 755 <a href="ft2-ot_svg_driver.html" class="md-nav__link"> 756 The SVG driver 757 </a> 758 </li> 759 760 761 762 763 764 765 766 <li class="md-nav__item"> 767 <a href="ft2-properties.html" class="md-nav__link"> 768 Driver properties 769 </a> 770 </li> 771 772 773 774 775 776 777 778 <li class="md-nav__item"> 779 <a href="ft2-parameter_tags.html" class="md-nav__link"> 780 Parameter Tags 781 </a> 782 </li> 783 784 785 786 787 788 789 790 <li class="md-nav__item"> 791 <a href="ft2-lcd_rendering.html" class="md-nav__link"> 792 Subpixel Rendering 793 </a> 794 </li> 795 796 797 798 </ul> 799 </nav> 800 </li> 801 802 803 804 805 806 807 808 809 810 811 812 <li class="md-nav__item md-nav__item--nested"> 813 814 815 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_7" type="checkbox" id="__nav_7" > 816 817 <label class="md-nav__link" for="__nav_7"> 818 Cache Sub-System 819 <span class="md-nav__icon md-icon"></span> 820 </label> 821 <nav class="md-nav" aria-label="Cache Sub-System" data-md-level="1"> 822 <label class="md-nav__title" for="__nav_7"> 823 <span class="md-nav__icon md-icon"></span> 824 Cache Sub-System 825 </label> 826 <ul class="md-nav__list" data-md-scrollfix> 827 828 829 830 831 832 <li class="md-nav__item"> 833 <a href="ft2-cache_subsystem.html" class="md-nav__link"> 834 Cache Sub-System 835 </a> 836 </li> 837 838 839 840 </ul> 841 </nav> 842 </li> 843 844 845 846 847 848 849 850 851 852 853 854 <li class="md-nav__item md-nav__item--nested"> 855 856 857 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_8" type="checkbox" id="__nav_8" > 858 859 <label class="md-nav__link" for="__nav_8"> 860 Support API 861 <span class="md-nav__icon md-icon"></span> 862 </label> 863 <nav class="md-nav" aria-label="Support API" data-md-level="1"> 864 <label class="md-nav__title" for="__nav_8"> 865 <span class="md-nav__icon md-icon"></span> 866 Support API 867 </label> 868 <ul class="md-nav__list" data-md-scrollfix> 869 870 871 872 873 874 <li class="md-nav__item"> 875 <a href="ft2-computations.html" class="md-nav__link"> 876 Computations 877 </a> 878 </li> 879 880 881 882 883 884 885 886 <li class="md-nav__item"> 887 <a href="ft2-list_processing.html" class="md-nav__link"> 888 List Processing 889 </a> 890 </li> 891 892 893 894 895 896 897 898 <li class="md-nav__item"> 899 <a href="ft2-outline_processing.html" class="md-nav__link"> 900 Outline Processing 901 </a> 902 </li> 903 904 905 906 907 908 909 910 <li class="md-nav__item"> 911 <a href="ft2-quick_advance.html" class="md-nav__link"> 912 Quick retrieval of advance values 913 </a> 914 </li> 915 916 917 918 919 920 921 922 <li class="md-nav__item"> 923 <a href="ft2-bitmap_handling.html" class="md-nav__link"> 924 Bitmap Handling 925 </a> 926 </li> 927 928 929 930 931 932 933 934 <li class="md-nav__item"> 935 <a href="ft2-raster.html" class="md-nav__link"> 936 Scanline Converter 937 </a> 938 </li> 939 940 941 942 943 944 945 946 <li class="md-nav__item"> 947 <a href="ft2-glyph_stroker.html" class="md-nav__link"> 948 Glyph Stroker 949 </a> 950 </li> 951 952 953 954 955 956 957 958 <li class="md-nav__item"> 959 <a href="ft2-system_interface.html" class="md-nav__link"> 960 System Interface 961 </a> 962 </li> 963 964 965 966 967 968 969 970 <li class="md-nav__item"> 971 <a href="ft2-module_management.html" class="md-nav__link"> 972 Module Management 973 </a> 974 </li> 975 976 977 978 979 980 981 982 <li class="md-nav__item"> 983 <a href="ft2-gzip.html" class="md-nav__link"> 984 GZIP Streams 985 </a> 986 </li> 987 988 989 990 991 992 993 994 <li class="md-nav__item"> 995 <a href="ft2-lzw.html" class="md-nav__link"> 996 LZW Streams 997 </a> 998 </li> 999 1000 1001 1002 1003 1004 1005 1006 <li class="md-nav__item"> 1007 <a href="ft2-bzip2.html" class="md-nav__link"> 1008 BZIP2 Streams 1009 </a> 1010 </li> 1011 1012 1013 1014 1015 1016 1017 1018 <li class="md-nav__item"> 1019 <a href="ft2-debugging_apis.html" class="md-nav__link"> 1020 External Debugging APIs 1021 </a> 1022 </li> 1023 1024 1025 1026 </ul> 1027 </nav> 1028 </li> 1029 1030 1031 1032 1033 1034 1035 1036 1037 1038 1039 1040 <li class="md-nav__item md-nav__item--nested"> 1041 1042 1043 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_9" type="checkbox" id="__nav_9" > 1044 1045 <label class="md-nav__link" for="__nav_9"> 1046 Error Codes 1047 <span class="md-nav__icon md-icon"></span> 1048 </label> 1049 <nav class="md-nav" aria-label="Error Codes" data-md-level="1"> 1050 <label class="md-nav__title" for="__nav_9"> 1051 <span class="md-nav__icon md-icon"></span> 1052 Error Codes 1053 </label> 1054 <ul class="md-nav__list" data-md-scrollfix> 1055 1056 1057 1058 1059 1060 <li class="md-nav__item"> 1061 <a href="ft2-error_enumerations.html" class="md-nav__link"> 1062 Error Enumerations 1063 </a> 1064 </li> 1065 1066 1067 1068 1069 1070 1071 1072 <li class="md-nav__item"> 1073 <a href="ft2-error_code_values.html" class="md-nav__link"> 1074 Error Code Values 1075 </a> 1076 </li> 1077 1078 1079 1080 </ul> 1081 </nav> 1082 </li> 1083 1084 1085 1086 1087 1088 1089 1090 1091 1092 1093 1094 <li class="md-nav__item md-nav__item--nested"> 1095 1096 1097 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_10" type="checkbox" id="__nav_10" > 1098 1099 <label class="md-nav__link" for="__nav_10"> 1100 Miscellaneous 1101 <span class="md-nav__icon md-icon"></span> 1102 </label> 1103 <nav class="md-nav" aria-label="Miscellaneous" data-md-level="1"> 1104 <label class="md-nav__title" for="__nav_10"> 1105 <span class="md-nav__icon md-icon"></span> 1106 Miscellaneous 1107 </label> 1108 <ul class="md-nav__list" data-md-scrollfix> 1109 1110 1111 1112 1113 1114 <li class="md-nav__item"> 1115 <a href="ft2-gx_validation.html" class="md-nav__link"> 1116 TrueTypeGX/AAT Validation 1117 </a> 1118 </li> 1119 1120 1121 1122 1123 1124 1125 1126 <li class="md-nav__item"> 1127 <a href="ft2-incremental.html" class="md-nav__link"> 1128 Incremental Loading 1129 </a> 1130 </li> 1131 1132 1133 1134 1135 1136 1137 1138 <li class="md-nav__item"> 1139 <a href="ft2-truetype_engine.html" class="md-nav__link"> 1140 The TrueType Engine 1141 </a> 1142 </li> 1143 1144 1145 1146 1147 1148 1149 1150 <li class="md-nav__item"> 1151 <a href="ft2-ot_validation.html" class="md-nav__link"> 1152 OpenType Validation 1153 </a> 1154 </li> 1155 1156 1157 1158 </ul> 1159 </nav> 1160 </li> 1161 1162 1163 1164 </ul> 1165</nav> 1166 </div> 1167 </div> 1168 </div> 1169 1170 1171 1172 <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" > 1173 <div class="md-sidebar__scrollwrap"> 1174 <div class="md-sidebar__inner"> 1175 1176<nav class="md-nav md-nav--secondary" aria-label="Table of contents"> 1177 1178 1179 1180 1181 1182 1183 <label class="md-nav__title" for="__toc"> 1184 <span class="md-nav__icon md-icon"></span> 1185 Table of contents 1186 </label> 1187 <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix> 1188 1189 <li class="md-nav__item"> 1190 <a href="#synopsis" class="md-nav__link"> 1191 Synopsis 1192 </a> 1193 1194</li> 1195 1196 <li class="md-nav__item"> 1197 <a href="#ft_new_face_from_fond" class="md-nav__link"> 1198 FT_New_Face_From_FOND 1199 </a> 1200 1201</li> 1202 1203 <li class="md-nav__item"> 1204 <a href="#ft_getfile_from_mac_name" class="md-nav__link"> 1205 FT_GetFile_From_Mac_Name 1206 </a> 1207 1208</li> 1209 1210 <li class="md-nav__item"> 1211 <a href="#ft_getfile_from_mac_ats_name" class="md-nav__link"> 1212 FT_GetFile_From_Mac_ATS_Name 1213 </a> 1214 1215</li> 1216 1217 <li class="md-nav__item"> 1218 <a href="#ft_getfilepath_from_mac_ats_name" class="md-nav__link"> 1219 FT_GetFilePath_From_Mac_ATS_Name 1220 </a> 1221 1222</li> 1223 1224 <li class="md-nav__item"> 1225 <a href="#ft_new_face_from_fsspec" class="md-nav__link"> 1226 FT_New_Face_From_FSSpec 1227 </a> 1228 1229</li> 1230 1231 <li class="md-nav__item"> 1232 <a href="#ft_new_face_from_fsref" class="md-nav__link"> 1233 FT_New_Face_From_FSRef 1234 </a> 1235 1236</li> 1237 1238 </ul> 1239 1240</nav> 1241 </div> 1242 </div> 1243 </div> 1244 1245 1246 <div class="md-content" data-md-component="content"> 1247 <article class="md-content__inner md-typeset"> 1248 1249 1250 1251 <p><a href="https://www.freetype.org">FreeType</a> » <a href="../">Docs</a> » <a href="index.html#core-api">Core API</a> » Mac Specific Interface</p> 1252<hr /> 1253<h1 id="mac-specific-interface">Mac Specific Interface<a class="headerlink" href="#mac-specific-interface" title="Permanent link">¶</a></h1> 1254<h2 id="synopsis">Synopsis<a class="headerlink" href="#synopsis" title="Permanent link">¶</a></h2> 1255<p>The following definitions are only available if FreeType is compiled on a Macintosh.</p> 1256<h2 id="ft_new_face_from_fond">FT_New_Face_From_FOND<a class="headerlink" href="#ft_new_face_from_fond" title="Permanent link">¶</a></h2> 1257<p>Defined in FT_MAC_H (freetype/ftmac.h).</p> 1258<div class = "codehilite"><pre><code> FT_EXPORT( <a href="ft2-basic_types.html#ft_error">FT_Error</a> ) 1259 <b>FT_New_Face_From_FOND</b>( <a href="ft2-base_interface.html#ft_library">FT_Library</a> library, 1260 Handle fond, 1261 <a href="ft2-basic_types.html#ft_long">FT_Long</a> face_index, 1262 <a href="ft2-base_interface.html#ft_face">FT_Face</a> *aface ) 1263 FT_DEPRECATED_ATTRIBUTE; 1264</code></pre></div> 1265 1266<p>Create a new face object from a FOND resource.</p> 1267<h4>inout</h4> 1268<table class="fields"> 1269<tr><td class="val" id="library">library</td><td class="desc"> 1270<p>A handle to the library resource.</p> 1271</td></tr> 1272</table> 1273 1274<h4>input</h4> 1275<table class="fields"> 1276<tr><td class="val" id="fond">fond</td><td class="desc"> 1277<p>A FOND resource.</p> 1278</td></tr> 1279<tr><td class="val" id="face_index">face_index</td><td class="desc"> 1280<p>Only supported for the -1 ‘sanity check’ special case.</p> 1281</td></tr> 1282</table> 1283 1284<h4>output</h4> 1285<table class="fields"> 1286<tr><td class="val" id="aface">aface</td><td class="desc"> 1287<p>A handle to a new face object.</p> 1288</td></tr> 1289</table> 1290 1291<h4>return</h4> 1292 1293<p>FreeType error code. 0 means success.</p> 1294<h4>example</h4> 1295 1296<p>This function can be used to create <code><a href="ft2-base_interface.html#ft_face">FT_Face</a></code> objects from fonts that are installed in the system as follows. 1297<div class="highlight"><pre><span></span><code> fond = GetResource( 'FOND', fontName ); 1298 error = FT_New_Face_From_FOND( library, fond, 0, &face ); 1299</code></pre></div></p> 1300<hr> 1301 1302<h2 id="ft_getfile_from_mac_name">FT_GetFile_From_Mac_Name<a class="headerlink" href="#ft_getfile_from_mac_name" title="Permanent link">¶</a></h2> 1303<p>Defined in FT_MAC_H (freetype/ftmac.h).</p> 1304<div class = "codehilite"><pre><code> FT_EXPORT( <a href="ft2-basic_types.html#ft_error">FT_Error</a> ) 1305 <b>FT_GetFile_From_Mac_Name</b>( <span class="keyword">const</span> <span class="keyword">char</span>* fontName, 1306 FSSpec* pathSpec, 1307 <a href="ft2-basic_types.html#ft_long">FT_Long</a>* face_index ) 1308 FT_DEPRECATED_ATTRIBUTE; 1309</code></pre></div> 1310 1311<p>Return an FSSpec for the disk file containing the named font.</p> 1312<h4>input</h4> 1313<table class="fields"> 1314<tr><td class="val" id="fontname">fontName</td><td class="desc"> 1315<p>Mac OS name of the font (e.g., Times New Roman Bold).</p> 1316</td></tr> 1317</table> 1318 1319<h4>output</h4> 1320<table class="fields"> 1321<tr><td class="val" id="pathspec">pathSpec</td><td class="desc"> 1322<p>FSSpec to the file. For passing to <code><a href="ft2-mac_specific.html#ft_new_face_from_fsspec">FT_New_Face_From_FSSpec</a></code>.</p> 1323</td></tr> 1324<tr><td class="val" id="face_index">face_index</td><td class="desc"> 1325<p>Index of the face. For passing to <code><a href="ft2-mac_specific.html#ft_new_face_from_fsspec">FT_New_Face_From_FSSpec</a></code>.</p> 1326</td></tr> 1327</table> 1328 1329<h4>return</h4> 1330 1331<p>FreeType error code. 0 means success.</p> 1332<hr> 1333 1334<h2 id="ft_getfile_from_mac_ats_name">FT_GetFile_From_Mac_ATS_Name<a class="headerlink" href="#ft_getfile_from_mac_ats_name" title="Permanent link">¶</a></h2> 1335<p>Defined in FT_MAC_H (freetype/ftmac.h).</p> 1336<div class = "codehilite"><pre><code> FT_EXPORT( <a href="ft2-basic_types.html#ft_error">FT_Error</a> ) 1337 <b>FT_GetFile_From_Mac_ATS_Name</b>( <span class="keyword">const</span> <span class="keyword">char</span>* fontName, 1338 FSSpec* pathSpec, 1339 <a href="ft2-basic_types.html#ft_long">FT_Long</a>* face_index ) 1340 FT_DEPRECATED_ATTRIBUTE; 1341</code></pre></div> 1342 1343<p>Return an FSSpec for the disk file containing the named font.</p> 1344<h4>input</h4> 1345<table class="fields"> 1346<tr><td class="val" id="fontname">fontName</td><td class="desc"> 1347<p>Mac OS name of the font in ATS framework.</p> 1348</td></tr> 1349</table> 1350 1351<h4>output</h4> 1352<table class="fields"> 1353<tr><td class="val" id="pathspec">pathSpec</td><td class="desc"> 1354<p>FSSpec to the file. For passing to <code><a href="ft2-mac_specific.html#ft_new_face_from_fsspec">FT_New_Face_From_FSSpec</a></code>.</p> 1355</td></tr> 1356<tr><td class="val" id="face_index">face_index</td><td class="desc"> 1357<p>Index of the face. For passing to <code><a href="ft2-mac_specific.html#ft_new_face_from_fsspec">FT_New_Face_From_FSSpec</a></code>.</p> 1358</td></tr> 1359</table> 1360 1361<h4>return</h4> 1362 1363<p>FreeType error code. 0 means success.</p> 1364<hr> 1365 1366<h2 id="ft_getfilepath_from_mac_ats_name">FT_GetFilePath_From_Mac_ATS_Name<a class="headerlink" href="#ft_getfilepath_from_mac_ats_name" title="Permanent link">¶</a></h2> 1367<p>Defined in FT_MAC_H (freetype/ftmac.h).</p> 1368<div class = "codehilite"><pre><code> FT_EXPORT( <a href="ft2-basic_types.html#ft_error">FT_Error</a> ) 1369 <b>FT_GetFilePath_From_Mac_ATS_Name</b>( <span class="keyword">const</span> <span class="keyword">char</span>* fontName, 1370 UInt8* path, 1371 UInt32 maxPathSize, 1372 <a href="ft2-basic_types.html#ft_long">FT_Long</a>* face_index ) 1373 FT_DEPRECATED_ATTRIBUTE; 1374</code></pre></div> 1375 1376<p>Return a pathname of the disk file and face index for given font name that is handled by ATS framework.</p> 1377<h4>input</h4> 1378<table class="fields"> 1379<tr><td class="val" id="fontname">fontName</td><td class="desc"> 1380<p>Mac OS name of the font in ATS framework.</p> 1381</td></tr> 1382</table> 1383 1384<h4>output</h4> 1385<table class="fields"> 1386<tr><td class="val" id="path">path</td><td class="desc"> 1387<p>Buffer to store pathname of the file. For passing to <code><a href="ft2-base_interface.html#ft_new_face">FT_New_Face</a></code>. The client must allocate this buffer before calling this function.</p> 1388</td></tr> 1389<tr><td class="val" id="maxpathsize">maxPathSize</td><td class="desc"> 1390<p>Lengths of the buffer <code>path</code> that client allocated.</p> 1391</td></tr> 1392<tr><td class="val" id="face_index">face_index</td><td class="desc"> 1393<p>Index of the face. For passing to <code><a href="ft2-base_interface.html#ft_new_face">FT_New_Face</a></code>.</p> 1394</td></tr> 1395</table> 1396 1397<h4>return</h4> 1398 1399<p>FreeType error code. 0 means success.</p> 1400<hr> 1401 1402<h2 id="ft_new_face_from_fsspec">FT_New_Face_From_FSSpec<a class="headerlink" href="#ft_new_face_from_fsspec" title="Permanent link">¶</a></h2> 1403<p>Defined in FT_MAC_H (freetype/ftmac.h).</p> 1404<div class = "codehilite"><pre><code> FT_EXPORT( <a href="ft2-basic_types.html#ft_error">FT_Error</a> ) 1405 <b>FT_New_Face_From_FSSpec</b>( <a href="ft2-base_interface.html#ft_library">FT_Library</a> library, 1406 <span class="keyword">const</span> FSSpec *spec, 1407 <a href="ft2-basic_types.html#ft_long">FT_Long</a> face_index, 1408 <a href="ft2-base_interface.html#ft_face">FT_Face</a> *aface ) 1409 FT_DEPRECATED_ATTRIBUTE; 1410</code></pre></div> 1411 1412<p>Create a new face object from a given resource and typeface index using an FSSpec to the font file.</p> 1413<h4>inout</h4> 1414<table class="fields"> 1415<tr><td class="val" id="library">library</td><td class="desc"> 1416<p>A handle to the library resource.</p> 1417</td></tr> 1418</table> 1419 1420<h4>input</h4> 1421<table class="fields"> 1422<tr><td class="val" id="spec">spec</td><td class="desc"> 1423<p>FSSpec to the font file.</p> 1424</td></tr> 1425<tr><td class="val" id="face_index">face_index</td><td class="desc"> 1426<p>The index of the face within the resource. The first face has index 0.</p> 1427</td></tr> 1428</table> 1429 1430<h4>output</h4> 1431<table class="fields"> 1432<tr><td class="val" id="aface">aface</td><td class="desc"> 1433<p>A handle to a new face object.</p> 1434</td></tr> 1435</table> 1436 1437<h4>return</h4> 1438 1439<p>FreeType error code. 0 means success.</p> 1440<h4>note</h4> 1441 1442<p><code><a href="ft2-mac_specific.html#ft_new_face_from_fsspec">FT_New_Face_From_FSSpec</a></code> is identical to <code><a href="ft2-base_interface.html#ft_new_face">FT_New_Face</a></code> except it accepts an FSSpec instead of a path.</p> 1443<hr> 1444 1445<h2 id="ft_new_face_from_fsref">FT_New_Face_From_FSRef<a class="headerlink" href="#ft_new_face_from_fsref" title="Permanent link">¶</a></h2> 1446<p>Defined in FT_MAC_H (freetype/ftmac.h).</p> 1447<div class = "codehilite"><pre><code> FT_EXPORT( <a href="ft2-basic_types.html#ft_error">FT_Error</a> ) 1448 <b>FT_New_Face_From_FSRef</b>( <a href="ft2-base_interface.html#ft_library">FT_Library</a> library, 1449 <span class="keyword">const</span> FSRef *ref, 1450 <a href="ft2-basic_types.html#ft_long">FT_Long</a> face_index, 1451 <a href="ft2-base_interface.html#ft_face">FT_Face</a> *aface ) 1452 FT_DEPRECATED_ATTRIBUTE; 1453</code></pre></div> 1454 1455<p>Create a new face object from a given resource and typeface index using an FSRef to the font file.</p> 1456<h4>inout</h4> 1457<table class="fields"> 1458<tr><td class="val" id="library">library</td><td class="desc"> 1459<p>A handle to the library resource.</p> 1460</td></tr> 1461</table> 1462 1463<h4>input</h4> 1464<table class="fields"> 1465<tr><td class="val" id="spec">spec</td><td class="desc"> 1466<p>FSRef to the font file.</p> 1467</td></tr> 1468<tr><td class="val" id="face_index">face_index</td><td class="desc"> 1469<p>The index of the face within the resource. The first face has index 0.</p> 1470</td></tr> 1471</table> 1472 1473<h4>output</h4> 1474<table class="fields"> 1475<tr><td class="val" id="aface">aface</td><td class="desc"> 1476<p>A handle to a new face object.</p> 1477</td></tr> 1478</table> 1479 1480<h4>return</h4> 1481 1482<p>FreeType error code. 0 means success.</p> 1483<h4>note</h4> 1484 1485<p><code><a href="ft2-mac_specific.html#ft_new_face_from_fsref">FT_New_Face_From_FSRef</a></code> is identical to <code><a href="ft2-base_interface.html#ft_new_face">FT_New_Face</a></code> except it accepts an FSRef instead of a path.</p> 1486<hr> 1487 1488 1489 1490 1491 1492 1493 1494 </article> 1495 </div> 1496 </div> 1497 1498 </main> 1499 1500 1501<footer class="md-footer"> 1502 1503 <nav class="md-footer__inner md-grid" aria-label="Footer"> 1504 1505 1506 <a href="ft2-glyph_management.html" class="md-footer__link md-footer__link--prev" aria-label="Previous: Glyph Management" rel="prev"> 1507 <div class="md-footer__button md-icon"> 1508 <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> 1509 </div> 1510 <div class="md-footer__title"> 1511 <div class="md-ellipsis"> 1512 <span class="md-footer__direction"> 1513 Previous 1514 </span> 1515 Glyph Management 1516 </div> 1517 </div> 1518 </a> 1519 1520 1521 1522 <a href="ft2-sizes_management.html" class="md-footer__link md-footer__link--next" aria-label="Next: Size Management" rel="next"> 1523 <div class="md-footer__title"> 1524 <div class="md-ellipsis"> 1525 <span class="md-footer__direction"> 1526 Next 1527 </span> 1528 Size Management 1529 </div> 1530 </div> 1531 <div class="md-footer__button md-icon"> 1532 <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> 1533 </div> 1534 </a> 1535 1536 </nav> 1537 1538 <div class="md-footer-meta md-typeset"> 1539 <div class="md-footer-meta__inner md-grid"> 1540 <div class="md-footer-copyright"> 1541 1542 <div class="md-footer-copyright__highlight"> 1543 Copyright 2022 <a href = "https://www.freetype.org/license.html">The FreeType Project</a>. 1544 </div> 1545 1546 Made with 1547 <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener"> 1548 Material for MkDocs 1549 </a> 1550 1551 </div> 1552 1553 </div> 1554 </div> 1555</footer> 1556 1557 </div> 1558 <div class="md-dialog" data-md-component="dialog"> 1559 <div class="md-dialog__inner md-typeset"></div> 1560 </div> 1561 <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> 1562 1563 1564 <script src="assets/javascripts/bundle.82b56eb2.min.js"></script> 1565 1566 <script src="javascripts/extra.js"></script> 1567 1568 1569 </body> 1570</html>