docs/reference/site/ft2-font_formats.html

   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.1">
  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.0.4, mkdocs-material-4.0.2">
  40
  41
  42
  43         <title>Font Formats - FreeType-2.10.1 API Reference</title>
  44
  45
  46
  47       <link rel="stylesheet" href="assets/stylesheets/application.982221ab.css">
  48
  49         <link rel="stylesheet" href="assets/stylesheets/application-palette.224b79ff.css">
  50
  51
  52
  53
  54         <meta name="theme-color" content="#4caf50">
  55
  56
  57
  58       <script src="assets/javascripts/modernizr.1f0bcf2b.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|Roboto+Mono">
  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="#font-formats" tabindex="1" 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="index.html" title="FreeType-2.10.1 API Reference" class="md-header-nav__button md-logo">
 102
 103             <img 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.1 API Reference
 115             </span>
 116             <span class="md-header-nav__topic">
 117               Font Formats
 118             </span>
 119
 120         </div>
 121       </div>
 122       <div class="md-flex__cell md-flex__cell--shrink">
 123
 124           <label class="md-icon md-icon--search md-header-nav__button" for="__search"></label>
 125
 126 <div class="md-search" data-md-component="search" role="dialog">
 127   <label class="md-search__overlay" for="__search"></label>
 128   <div class="md-search__inner" role="search">
 129     <form class="md-search__form" name="search">
 130       <input type="text" class="md-search__input" name="query" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="query" data-md-state="active">
 131       <label class="md-icon md-search__icon" for="__search"></label>
 132       <button type="reset" class="md-icon md-search__icon" data-md-component="reset" tabindex="-1">
 133         &#xE5CD;
 134       </button>
 135     </form>
 136     <div class="md-search__output">
 137       <div class="md-search__scrollwrap" data-md-scrollfix>
 138         <div class="md-search-result" data-md-component="result">
 139           <div class="md-search-result__meta">
 140             Type to start searching
 141           </div>
 142           <ol class="md-search-result__list"></ol>
 143         </div>
 144       </div>
 145     </div>
 146   </div>
 147 </div>
 148
 149       </div>
 150
 151     </div>
 152   </nav>
 153 </header>
 154
 155     <div class="md-container">
 156
 157
 158
 159
 160       <main class="md-main">
 161         <div class="md-main__inner md-grid" data-md-component="container">
 162
 163
 164               <div class="md-sidebar md-sidebar--primary" data-md-component="navigation">
 165                 <div class="md-sidebar__scrollwrap">
 166                   <div class="md-sidebar__inner">
 167                     <nav class="md-nav md-nav--primary" data-md-level="0">
 168   <label class="md-nav__title md-nav__title--site" for="__drawer">
 169     <a href="index.html" title="FreeType-2.10.1 API Reference" class="md-nav__button md-logo">
 170
 171         <img src="images/favico.ico" width="48" height="48">
 172
 173     </a>
 174     FreeType-2.10.1 API Reference
 175   </label>
 176
 177   <ul class="md-nav__list" data-md-scrollfix>
 178
 179
 180
 181
 182
 183
 184   <li class="md-nav__item">
 185     <a href="index.html" title="TOC" class="md-nav__link">
 186       TOC
 187     </a>
 188   </li>
 189
 190
 191
 192
 193
 194
 195
 196   <li class="md-nav__item">
 197     <a href="ft2-index.html" title="Index" class="md-nav__link">
 198       Index
 199     </a>
 200   </li>
 201
 202
 203
 204
 205
 206
 207
 208   <li class="md-nav__item md-nav__item--nested">
 209
 210       <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3" type="checkbox" id="nav-3">
 211
 212     <label class="md-nav__link" for="nav-3">
 213       General Remarks
 214     </label>
 215     <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
 216       <label class="md-nav__title" for="nav-3">
 217         General Remarks
 218       </label>
 219       <ul class="md-nav__list" data-md-scrollfix>
 220
 221
 222
 223
 224
 225
 226
 227   <li class="md-nav__item">
 228     <a href="ft2-header_inclusion.html" title="FreeType's header inclusion scheme" class="md-nav__link">
 229       FreeType's header inclusion scheme
 230     </a>
 231   </li>
 232
 233
 234
 235
 236
 237
 238
 239   <li class="md-nav__item">
 240     <a href="ft2-user_allocation.html" title="User allocation" class="md-nav__link">
 241       User allocation
 242     </a>
 243   </li>
 244
 245
 246       </ul>
 247     </nav>
 248   </li>
 249
 250
 251
 252
 253
 254
 255
 256   <li class="md-nav__item md-nav__item--nested">
 257
 258       <input class="md-toggle md-nav__toggle" data-md-toggle="nav-4" type="checkbox" id="nav-4">
 259
 260     <label class="md-nav__link" for="nav-4">
 261       Core API
 262     </label>
 263     <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
 264       <label class="md-nav__title" for="nav-4">
 265         Core API
 266       </label>
 267       <ul class="md-nav__list" data-md-scrollfix>
 268
 269
 270
 271
 272
 273
 274
 275   <li class="md-nav__item">
 276     <a href="ft2-version.html" title="FreeType Version" class="md-nav__link">
 277       FreeType Version
 278     </a>
 279   </li>
 280
 281
 282
 283
 284
 285
 286
 287   <li class="md-nav__item">
 288     <a href="ft2-basic_types.html" title="Basic Data Types" class="md-nav__link">
 289       Basic Data Types
 290     </a>
 291   </li>
 292
 293
 294
 295
 296
 297
 298
 299   <li class="md-nav__item">
 300     <a href="ft2-base_interface.html" title="Base Interface" class="md-nav__link">
 301       Base Interface
 302     </a>
 303   </li>
 304
 305
 306
 307
 308
 309
 310
 311   <li class="md-nav__item">
 312     <a href="ft2-glyph_variants.html" title="Unicode Variation Sequences" class="md-nav__link">
 313       Unicode Variation Sequences
 314     </a>
 315   </li>
 316
 317
 318
 319
 320
 321
 322
 323   <li class="md-nav__item">
 324     <a href="ft2-color_management.html" title="Glyph Color Management" class="md-nav__link">
 325       Glyph Color Management
 326     </a>
 327   </li>
 328
 329
 330
 331
 332
 333
 334
 335   <li class="md-nav__item">
 336     <a href="ft2-layer_management.html" title="Glyph Layer Management" class="md-nav__link">
 337       Glyph Layer Management
 338     </a>
 339   </li>
 340
 341
 342
 343
 344
 345
 346
 347   <li class="md-nav__item">
 348     <a href="ft2-glyph_management.html" title="Glyph Management" class="md-nav__link">
 349       Glyph Management
 350     </a>
 351   </li>
 352
 353
 354
 355
 356
 357
 358
 359   <li class="md-nav__item">
 360     <a href="ft2-mac_specific.html" title="Mac Specific Interface" class="md-nav__link">
 361       Mac Specific Interface
 362     </a>
 363   </li>
 364
 365
 366
 367
 368
 369
 370
 371   <li class="md-nav__item">
 372     <a href="ft2-sizes_management.html" title="Size Management" class="md-nav__link">
 373       Size Management
 374     </a>
 375   </li>
 376
 377
 378
 379
 380
 381
 382
 383   <li class="md-nav__item">
 384     <a href="ft2-header_file_macros.html" title="Header File Macros" class="md-nav__link">
 385       Header File Macros
 386     </a>
 387   </li>
 388
 389
 390       </ul>
 391     </nav>
 392   </li>
 393
 394
 395
 396
 397
 398
 399
 400
 401
 402   <li class="md-nav__item md-nav__item--active md-nav__item--nested">
 403
 404       <input class="md-toggle md-nav__toggle" data-md-toggle="nav-5" type="checkbox" id="nav-5" checked>
 405
 406     <label class="md-nav__link" for="nav-5">
 407       Format-Specific API
 408     </label>
 409     <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
 410       <label class="md-nav__title" for="nav-5">
 411         Format-Specific API
 412       </label>
 413       <ul class="md-nav__list" data-md-scrollfix>
 414
 415
 416
 417
 418
 419
 420
 421   <li class="md-nav__item">
 422     <a href="ft2-multiple_masters.html" title="Multiple Masters" class="md-nav__link">
 423       Multiple Masters
 424     </a>
 425   </li>
 426
 427
 428
 429
 430
 431
 432
 433   <li class="md-nav__item">
 434     <a href="ft2-truetype_tables.html" title="TrueType Tables" class="md-nav__link">
 435       TrueType Tables
 436     </a>
 437   </li>
 438
 439
 440
 441
 442
 443
 444
 445   <li class="md-nav__item">
 446     <a href="ft2-type1_tables.html" title="Type 1 Tables" class="md-nav__link">
 447       Type 1 Tables
 448     </a>
 449   </li>
 450
 451
 452
 453
 454
 455
 456
 457   <li class="md-nav__item">
 458     <a href="ft2-sfnt_names.html" title="SFNT Names" class="md-nav__link">
 459       SFNT Names
 460     </a>
 461   </li>
 462
 463
 464
 465
 466
 467
 468
 469   <li class="md-nav__item">
 470     <a href="ft2-bdf_fonts.html" title="BDF and PCF Files" class="md-nav__link">
 471       BDF and PCF Files
 472     </a>
 473   </li>
 474
 475
 476
 477
 478
 479
 480
 481   <li class="md-nav__item">
 482     <a href="ft2-cid_fonts.html" title="CID Fonts" class="md-nav__link">
 483       CID Fonts
 484     </a>
 485   </li>
 486
 487
 488
 489
 490
 491
 492
 493   <li class="md-nav__item">
 494     <a href="ft2-pfr_fonts.html" title="PFR Fonts" class="md-nav__link">
 495       PFR Fonts
 496     </a>
 497   </li>
 498
 499
 500
 501
 502
 503
 504
 505   <li class="md-nav__item">
 506     <a href="ft2-winfnt_fonts.html" title="Window FNT Files" class="md-nav__link">
 507       Window FNT Files
 508     </a>
 509   </li>
 510
 511
 512
 513
 514
 515
 516
 517
 518
 519   <li class="md-nav__item md-nav__item--active">
 520
 521     <input class="md-toggle md-nav__toggle" data-md-toggle="toc" type="checkbox" id="__toc">
 522
 523
 524
 525
 526       <label class="md-nav__link md-nav__link--active" for="__toc">
 527         Font Formats
 528       </label>
 529
 530     <a href="ft2-font_formats.html" title="Font Formats" class="md-nav__link md-nav__link--active">
 531       Font Formats
 532     </a>
 533
 534
 535 <nav class="md-nav md-nav--secondary">
 536
 537
 538
 539
 540
 541     <label class="md-nav__title" for="__toc">Table of contents</label>
 542     <ul class="md-nav__list" data-md-scrollfix>
 543
 544         <li class="md-nav__item">
 545   <a href="#synopsis" title="Synopsis" class="md-nav__link">
 546     Synopsis
 547   </a>
 548
 549 </li>
 550
 551         <li class="md-nav__item">
 552   <a href="#ft_get_font_format" title="FT_Get_Font_Format" class="md-nav__link">
 553     FT_Get_Font_Format
 554   </a>
 555
 556 </li>
 557
 558
 559
 560
 561
 562     </ul>
 563
 564 </nav>
 565
 566   </li>
 567
 568
 569
 570
 571
 572
 573
 574   <li class="md-nav__item">
 575     <a href="ft2-gasp_table.html" title="Gasp Table" class="md-nav__link">
 576       Gasp Table
 577     </a>
 578   </li>
 579
 580
 581       </ul>
 582     </nav>
 583   </li>
 584
 585
 586
 587
 588
 589
 590
 591   <li class="md-nav__item md-nav__item--nested">
 592
 593       <input class="md-toggle md-nav__toggle" data-md-toggle="nav-6" type="checkbox" id="nav-6">
 594
 595     <label class="md-nav__link" for="nav-6">
 596       Controlling FreeType Modules
 597     </label>
 598     <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
 599       <label class="md-nav__title" for="nav-6">
 600         Controlling FreeType Modules
 601       </label>
 602       <ul class="md-nav__list" data-md-scrollfix>
 603
 604
 605
 606
 607
 608
 609
 610   <li class="md-nav__item">
 611     <a href="ft2-auto_hinter.html" title="The auto-hinter" class="md-nav__link">
 612       The auto-hinter
 613     </a>
 614   </li>
 615
 616
 617
 618
 619
 620
 621
 622   <li class="md-nav__item">
 623     <a href="ft2-cff_driver.html" title="The CFF driver" class="md-nav__link">
 624       The CFF driver
 625     </a>
 626   </li>
 627
 628
 629
 630
 631
 632
 633
 634   <li class="md-nav__item">
 635     <a href="ft2-t1_cid_driver.html" title="The Type 1 and CID drivers" class="md-nav__link">
 636       The Type 1 and CID drivers
 637     </a>
 638   </li>
 639
 640
 641
 642
 643
 644
 645
 646   <li class="md-nav__item">
 647     <a href="ft2-tt_driver.html" title="The TrueType driver" class="md-nav__link">
 648       The TrueType driver
 649     </a>
 650   </li>
 651
 652
 653
 654
 655
 656
 657
 658   <li class="md-nav__item">
 659     <a href="ft2-pcf_driver.html" title="The PCF driver" class="md-nav__link">
 660       The PCF driver
 661     </a>
 662   </li>
 663
 664
 665
 666
 667
 668
 669
 670   <li class="md-nav__item">
 671     <a href="ft2-properties.html" title="Driver properties" class="md-nav__link">
 672       Driver properties
 673     </a>
 674   </li>
 675
 676
 677
 678
 679
 680
 681
 682   <li class="md-nav__item">
 683     <a href="ft2-parameter_tags.html" title="Parameter Tags" class="md-nav__link">
 684       Parameter Tags
 685     </a>
 686   </li>
 687
 688
 689
 690
 691
 692
 693
 694   <li class="md-nav__item">
 695     <a href="ft2-lcd_rendering.html" title="Subpixel Rendering" class="md-nav__link">
 696       Subpixel Rendering
 697     </a>
 698   </li>
 699
 700
 701       </ul>
 702     </nav>
 703   </li>
 704
 705
 706
 707
 708
 709
 710
 711   <li class="md-nav__item md-nav__item--nested">
 712
 713       <input class="md-toggle md-nav__toggle" data-md-toggle="nav-7" type="checkbox" id="nav-7">
 714
 715     <label class="md-nav__link" for="nav-7">
 716       Cache Sub-System
 717     </label>
 718     <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
 719       <label class="md-nav__title" for="nav-7">
 720         Cache Sub-System
 721       </label>
 722       <ul class="md-nav__list" data-md-scrollfix>
 723
 724
 725
 726
 727
 728
 729
 730   <li class="md-nav__item">
 731     <a href="ft2-cache_subsystem.html" title="Cache Sub-System" class="md-nav__link">
 732       Cache Sub-System
 733     </a>
 734   </li>
 735
 736
 737       </ul>
 738     </nav>
 739   </li>
 740
 741
 742
 743
 744
 745
 746
 747   <li class="md-nav__item md-nav__item--nested">
 748
 749       <input class="md-toggle md-nav__toggle" data-md-toggle="nav-8" type="checkbox" id="nav-8">
 750
 751     <label class="md-nav__link" for="nav-8">
 752       Support API
 753     </label>
 754     <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
 755       <label class="md-nav__title" for="nav-8">
 756         Support API
 757       </label>
 758       <ul class="md-nav__list" data-md-scrollfix>
 759
 760
 761
 762
 763
 764
 765
 766   <li class="md-nav__item">
 767     <a href="ft2-computations.html" title="Computations" class="md-nav__link">
 768       Computations
 769     </a>
 770   </li>
 771
 772
 773
 774
 775
 776
 777
 778   <li class="md-nav__item">
 779     <a href="ft2-list_processing.html" title="List Processing" class="md-nav__link">
 780       List Processing
 781     </a>
 782   </li>
 783
 784
 785
 786
 787
 788
 789
 790   <li class="md-nav__item">
 791     <a href="ft2-outline_processing.html" title="Outline Processing" class="md-nav__link">
 792       Outline Processing
 793     </a>
 794   </li>
 795
 796
 797
 798
 799
 800
 801
 802   <li class="md-nav__item">
 803     <a href="ft2-quick_advance.html" title="Quick retrieval of advance values" class="md-nav__link">
 804       Quick retrieval of advance values
 805     </a>
 806   </li>
 807
 808
 809
 810
 811
 812
 813
 814   <li class="md-nav__item">
 815     <a href="ft2-bitmap_handling.html" title="Bitmap Handling" class="md-nav__link">
 816       Bitmap Handling
 817     </a>
 818   </li>
 819
 820
 821
 822
 823
 824
 825
 826   <li class="md-nav__item">
 827     <a href="ft2-raster.html" title="Scanline Converter" class="md-nav__link">
 828       Scanline Converter
 829     </a>
 830   </li>
 831
 832
 833
 834
 835
 836
 837
 838   <li class="md-nav__item">
 839     <a href="ft2-glyph_stroker.html" title="Glyph Stroker" class="md-nav__link">
 840       Glyph Stroker
 841     </a>
 842   </li>
 843
 844
 845
 846
 847
 848
 849
 850   <li class="md-nav__item">
 851     <a href="ft2-system_interface.html" title="System Interface" class="md-nav__link">
 852       System Interface
 853     </a>
 854   </li>
 855
 856
 857
 858
 859
 860
 861
 862   <li class="md-nav__item">
 863     <a href="ft2-module_management.html" title="Module Management" class="md-nav__link">
 864       Module Management
 865     </a>
 866   </li>
 867
 868
 869
 870
 871
 872
 873
 874   <li class="md-nav__item">
 875     <a href="ft2-gzip.html" title="GZIP Streams" class="md-nav__link">
 876       GZIP Streams
 877     </a>
 878   </li>
 879
 880
 881
 882
 883
 884
 885
 886   <li class="md-nav__item">
 887     <a href="ft2-lzw.html" title="LZW Streams" class="md-nav__link">
 888       LZW Streams
 889     </a>
 890   </li>
 891
 892
 893
 894
 895
 896
 897
 898   <li class="md-nav__item">
 899     <a href="ft2-bzip2.html" title="BZIP2 Streams" class="md-nav__link">
 900       BZIP2 Streams
 901     </a>
 902   </li>
 903
 904
 905       </ul>
 906     </nav>
 907   </li>
 908
 909
 910
 911
 912
 913
 914
 915   <li class="md-nav__item md-nav__item--nested">
 916
 917       <input class="md-toggle md-nav__toggle" data-md-toggle="nav-9" type="checkbox" id="nav-9">
 918
 919     <label class="md-nav__link" for="nav-9">
 920       Error Codes
 921     </label>
 922     <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
 923       <label class="md-nav__title" for="nav-9">
 924         Error Codes
 925       </label>
 926       <ul class="md-nav__list" data-md-scrollfix>
 927
 928
 929
 930
 931
 932
 933
 934   <li class="md-nav__item">
 935     <a href="ft2-error_enumerations.html" title="Error Enumerations" class="md-nav__link">
 936       Error Enumerations
 937     </a>
 938   </li>
 939
 940
 941
 942
 943
 944
 945
 946   <li class="md-nav__item">
 947     <a href="ft2-error_code_values.html" title="Error Code Values" class="md-nav__link">
 948       Error Code Values
 949     </a>
 950   </li>
 951
 952
 953       </ul>
 954     </nav>
 955   </li>
 956
 957
 958
 959
 960
 961
 962
 963   <li class="md-nav__item md-nav__item--nested">
 964
 965       <input class="md-toggle md-nav__toggle" data-md-toggle="nav-10" type="checkbox" id="nav-10">
 966
 967     <label class="md-nav__link" for="nav-10">
 968       Miscellaneous
 969     </label>
 970     <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
 971       <label class="md-nav__title" for="nav-10">
 972         Miscellaneous
 973       </label>
 974       <ul class="md-nav__list" data-md-scrollfix>
 975
 976
 977
 978
 979
 980
 981
 982   <li class="md-nav__item">
 983     <a href="ft2-ot_validation.html" title="OpenType Validation" class="md-nav__link">
 984       OpenType Validation
 985     </a>
 986   </li>
 987
 988
 989
 990
 991
 992
 993
 994   <li class="md-nav__item">
 995     <a href="ft2-incremental.html" title="Incremental Loading" class="md-nav__link">
 996       Incremental Loading
 997     </a>
 998   </li>
 999
1000
1001
1002
1003
1004
1005
1006   <li class="md-nav__item">
1007     <a href="ft2-truetype_engine.html" title="The TrueType Engine" class="md-nav__link">
1008       The TrueType Engine
1009     </a>
1010   </li>
1011
1012
1013
1014
1015
1016
1017
1018   <li class="md-nav__item">
1019     <a href="ft2-gx_validation.html" title="TrueTypeGX/AAT Validation" class="md-nav__link">
1020       TrueTypeGX/AAT Validation
1021     </a>
1022   </li>
1023
1024
1025       </ul>
1026     </nav>
1027   </li>
1028
1029
1030   </ul>
1031 </nav>
1032                   </div>
1033                 </div>
1034               </div>
1035
1036
1037               <div class="md-sidebar md-sidebar--secondary" data-md-component="toc">
1038                 <div class="md-sidebar__scrollwrap">
1039                   <div class="md-sidebar__inner">
1040
1041 <nav class="md-nav md-nav--secondary">
1042
1043
1044
1045
1046
1047     <label class="md-nav__title" for="__toc">Table of contents</label>
1048     <ul class="md-nav__list" data-md-scrollfix>
1049
1050         <li class="md-nav__item">
1051   <a href="#synopsis" title="Synopsis" class="md-nav__link">
1052     Synopsis
1053   </a>
1054
1055 </li>
1056
1057         <li class="md-nav__item">
1058   <a href="#ft_get_font_format" title="FT_Get_Font_Format" class="md-nav__link">
1059     FT_Get_Font_Format
1060   </a>
1061
1062 </li>
1063
1064
1065
1066
1067
1068     </ul>
1069
1070 </nav>
1071                   </div>
1072                 </div>
1073               </div>
1074
1075
1076           <div class="md-content">
1077             <article class="md-content__inner md-typeset">
1078
1079
1080
1081                 <p><a href="https://www.freetype.org">FreeType</a> &raquo; <a href="../">Docs</a> &raquo; <a href="index.html#format-specific-api">Format-Specific API</a> &raquo; Font Formats</p>
1082 <hr />
1083 <h1 id="font-formats">Font Formats<a class="headerlink" href="#font-formats" title="Permanent link">&para;</a></h1>
1084 <h2 id="synopsis">Synopsis<a class="headerlink" href="#synopsis" title="Permanent link">&para;</a></h2>
1085 <p>The single function in this section can be used to get the font format. Note that this information is not needed normally; however, there are special cases (like in PDF devices) where it is important to differentiate, in spite of FreeType's uniform API.</p>
1086 <h2 id="ft_get_font_format">FT_Get_Font_Format<a class="headerlink" href="#ft_get_font_format" title="Permanent link">&para;</a></h2>
1087 <p>Defined in FT_FONT_FORMATS_H (freetype/ftfntfmt.h).</p>
1088 <div class = "codehilite">
1089 <pre>
1090   FT_EXPORT( <span class="keyword">const</span> <span class="keyword">char</span>* )
1091   <b>FT_Get_Font_Format</b>( <a href="ft2-base_interface.html#ft_face">FT_Face</a>  face );
1092
1093   /* deprecated */
1094   FT_EXPORT( <span class="keyword">const</span> <span class="keyword">char</span>* )
1095   FT_Get_X11_Font_Format( <a href="ft2-base_interface.html#ft_face">FT_Face</a>  face );
1096 </pre>
1097 </div>
1098
1099 <p>Return a string describing the format of a given face. Possible values are &lsquo;TrueType&rsquo;, &lsquo;Type&nbsp;1&rsquo;, &lsquo;BDF&rsquo;, &lsquo;PCF&rsquo;, &lsquo;Type&nbsp;42&rsquo;, &lsquo;CID&nbsp;Type&nbsp;1&rsquo;, &lsquo;CFF&rsquo;, &lsquo;PFR&rsquo;, and &lsquo;Windows&nbsp;FNT&rsquo;.</p>
1100 <p>The return value is suitable to be used as an X11 FONT_PROPERTY.</p>
1101 <h4>input</h4>
1102
1103 <table class="fields">
1104 <tr><td class="val" id="face">face</td><td class="desc">
1105 <p>Input face handle.</p>
1106 </td></tr>
1107 </table>
1108
1109 <h4>return</h4>
1110
1111 <p>Font format string. <code>NULL</code> in case of error.</p>
1112 <h4>note</h4>
1113
1114 <p>A deprecated name for the same function is <code>FT_Get_X11_Font_Format</code>.</p>
1115 <hr>
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125             </article>
1126           </div>
1127         </div>
1128       </main>
1129
1130
1131 <footer class="md-footer">
1132
1133     <div class="md-footer-nav">
1134       <nav class="md-footer-nav__inner md-grid">
1135
1136           <a href="ft2-winfnt_fonts.html" title="Window FNT Files" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
1137             <div class="md-flex__cell md-flex__cell--shrink">
1138               <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
1139             </div>
1140             <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
1141               <span class="md-flex__ellipsis">
1142                 <span class="md-footer-nav__direction">
1143                   Previous
1144                 </span>
1145                 Window FNT Files
1146               </span>
1147             </div>
1148           </a>
1149
1150
1151           <a href="ft2-gasp_table.html" title="Gasp Table" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
1152             <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
1153               <span class="md-flex__ellipsis">
1154                 <span class="md-footer-nav__direction">
1155                   Next
1156                 </span>
1157                 Gasp Table
1158               </span>
1159             </div>
1160             <div class="md-flex__cell md-flex__cell--shrink">
1161               <i class="md-icon md-icon--arrow-forward md-footer-nav__button"></i>
1162             </div>
1163           </a>
1164
1165       </nav>
1166     </div>
1167
1168   <div class="md-footer-meta md-typeset">
1169     <div class="md-footer-meta__inner md-grid">
1170       <div class="md-footer-copyright">
1171
1172           <div class="md-footer-copyright__highlight">
1173             Copyright 2019 <a href = "https://www.freetype.org/license.html">The FreeType Project</a>.
1174           </div>
1175
1176         powered by
1177         <a href="https://www.mkdocs.org">MkDocs</a>
1178         and
1179         <a href="https://squidfunk.github.io/mkdocs-material/">
1180           Material for MkDocs</a>
1181       </div>
1182
1183     </div>
1184   </div>
1185 </footer>
1186
1187     </div>
1188
1189       <script src="assets/javascripts/application.d9aa80ab.js"></script>
1190
1191       <script>app.initialize({version:"1.0.4",url:{base:"."}})</script>
1192
1193         <script src="javascripts/extra.js"></script>
1194
1195
1196   </body>
1197 </html>