docs/reference/ft2-mac_specific.html

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