docs/reference/ft2-truetype_tables.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>TrueType Tables - 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="#truetype-tables" 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               TrueType Tables
 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     <li class="md-nav__item md-nav__item--nested">
 417
 418
 419         <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_5" type="checkbox" id="__nav_5" >
 420
 421       <label class="md-nav__link" for="__nav_5">
 422         Extended API
 423         <span class="md-nav__icon md-icon"></span>
 424       </label>
 425       <nav class="md-nav" aria-label="Extended API" data-md-level="1">
 426         <label class="md-nav__title" for="__nav_5">
 427           <span class="md-nav__icon md-icon"></span>
 428           Extended API
 429         </label>
 430         <ul class="md-nav__list" data-md-scrollfix>
 431
 432
 433
 434
 435
 436     <li class="md-nav__item">
 437       <a href="ft2-glyph_variants.html" class="md-nav__link">
 438         Unicode Variation Sequences
 439       </a>
 440     </li>
 441
 442
 443
 444
 445
 446
 447
 448     <li class="md-nav__item">
 449       <a href="ft2-color_management.html" class="md-nav__link">
 450         Glyph Color Management
 451       </a>
 452     </li>
 453
 454
 455
 456
 457
 458
 459
 460     <li class="md-nav__item">
 461       <a href="ft2-layer_management.html" class="md-nav__link">
 462         Glyph Layer Management
 463       </a>
 464     </li>
 465
 466
 467
 468
 469
 470
 471
 472     <li class="md-nav__item">
 473       <a href="ft2-glyph_management.html" class="md-nav__link">
 474         Glyph Management
 475       </a>
 476     </li>
 477
 478
 479
 480
 481
 482
 483
 484     <li class="md-nav__item">
 485       <a href="ft2-mac_specific.html" class="md-nav__link">
 486         Mac Specific Interface
 487       </a>
 488     </li>
 489
 490
 491
 492
 493
 494
 495
 496     <li class="md-nav__item">
 497       <a href="ft2-sizes_management.html" class="md-nav__link">
 498         Size Management
 499       </a>
 500     </li>
 501
 502
 503
 504
 505
 506
 507
 508     <li class="md-nav__item">
 509       <a href="ft2-header_file_macros.html" class="md-nav__link">
 510         Header File Macros
 511       </a>
 512     </li>
 513
 514
 515
 516         </ul>
 517       </nav>
 518     </li>
 519
 520
 521
 522
 523
 524
 525
 526
 527
 528
 529
 530
 531
 532     <li class="md-nav__item md-nav__item--active md-nav__item--nested">
 533
 534
 535         <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_6" type="checkbox" id="__nav_6" checked>
 536
 537       <label class="md-nav__link" for="__nav_6">
 538         Format-Specific API
 539         <span class="md-nav__icon md-icon"></span>
 540       </label>
 541       <nav class="md-nav" aria-label="Format-Specific API" data-md-level="1">
 542         <label class="md-nav__title" for="__nav_6">
 543           <span class="md-nav__icon md-icon"></span>
 544           Format-Specific API
 545         </label>
 546         <ul class="md-nav__list" data-md-scrollfix>
 547
 548
 549
 550
 551
 552     <li class="md-nav__item">
 553       <a href="ft2-multiple_masters.html" class="md-nav__link">
 554         Multiple Masters
 555       </a>
 556     </li>
 557
 558
 559
 560
 561
 562
 563
 564
 565
 566     <li class="md-nav__item md-nav__item--active">
 567
 568       <input class="md-nav__toggle md-toggle" data-md-toggle="toc" type="checkbox" id="__toc">
 569
 570
 571
 572
 573
 574         <label class="md-nav__link md-nav__link--active" for="__toc">
 575           TrueType Tables
 576           <span class="md-nav__icon md-icon"></span>
 577         </label>
 578
 579       <a href="ft2-truetype_tables.html" class="md-nav__link md-nav__link--active">
 580         TrueType Tables
 581       </a>
 582
 583
 584 <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
 585
 586
 587
 588
 589
 590
 591     <label class="md-nav__title" for="__toc">
 592       <span class="md-nav__icon md-icon"></span>
 593       Table of contents
 594     </label>
 595     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
 596
 597         <li class="md-nav__item">
 598   <a href="#synopsis" class="md-nav__link">
 599     Synopsis
 600   </a>
 601
 602 </li>
 603
 604         <li class="md-nav__item">
 605   <a href="#tt_header" class="md-nav__link">
 606     TT_Header
 607   </a>
 608
 609 </li>
 610
 611         <li class="md-nav__item">
 612   <a href="#tt_horiheader" class="md-nav__link">
 613     TT_HoriHeader
 614   </a>
 615
 616 </li>
 617
 618         <li class="md-nav__item">
 619   <a href="#tt_vertheader" class="md-nav__link">
 620     TT_VertHeader
 621   </a>
 622
 623 </li>
 624
 625         <li class="md-nav__item">
 626   <a href="#tt_os2" class="md-nav__link">
 627     TT_OS2
 628   </a>
 629
 630 </li>
 631
 632         <li class="md-nav__item">
 633   <a href="#tt_postscript" class="md-nav__link">
 634     TT_Postscript
 635   </a>
 636
 637 </li>
 638
 639         <li class="md-nav__item">
 640   <a href="#tt_pclt" class="md-nav__link">
 641     TT_PCLT
 642   </a>
 643
 644 </li>
 645
 646         <li class="md-nav__item">
 647   <a href="#tt_maxprofile" class="md-nav__link">
 648     TT_MaxProfile
 649   </a>
 650
 651 </li>
 652
 653         <li class="md-nav__item">
 654   <a href="#ft_sfnt_tag" class="md-nav__link">
 655     FT_Sfnt_Tag
 656   </a>
 657
 658 </li>
 659
 660         <li class="md-nav__item">
 661   <a href="#ft_get_sfnt_table" class="md-nav__link">
 662     FT_Get_Sfnt_Table
 663   </a>
 664
 665 </li>
 666
 667         <li class="md-nav__item">
 668   <a href="#ft_load_sfnt_table" class="md-nav__link">
 669     FT_Load_Sfnt_Table
 670   </a>
 671
 672 </li>
 673
 674         <li class="md-nav__item">
 675   <a href="#ft_sfnt_table_info" class="md-nav__link">
 676     FT_Sfnt_Table_Info
 677   </a>
 678
 679 </li>
 680
 681         <li class="md-nav__item">
 682   <a href="#ft_get_cmap_language_id" class="md-nav__link">
 683     FT_Get_CMap_Language_ID
 684   </a>
 685
 686 </li>
 687
 688         <li class="md-nav__item">
 689   <a href="#ft_get_cmap_format" class="md-nav__link">
 690     FT_Get_CMap_Format
 691   </a>
 692
 693 </li>
 694
 695         <li class="md-nav__item">
 696   <a href="#ft_param_tag_unpatented_hinting" class="md-nav__link">
 697     FT_PARAM_TAG_UNPATENTED_HINTING
 698   </a>
 699
 700 </li>
 701
 702         <li class="md-nav__item">
 703   <a href="#tt_platform_xxx" class="md-nav__link">
 704     TT_PLATFORM_XXX
 705   </a>
 706
 707 </li>
 708
 709         <li class="md-nav__item">
 710   <a href="#tt_apple_id_xxx" class="md-nav__link">
 711     TT_APPLE_ID_XXX
 712   </a>
 713
 714 </li>
 715
 716         <li class="md-nav__item">
 717   <a href="#tt_mac_id_xxx" class="md-nav__link">
 718     TT_MAC_ID_XXX
 719   </a>
 720
 721 </li>
 722
 723         <li class="md-nav__item">
 724   <a href="#tt_iso_id_xxx" class="md-nav__link">
 725     TT_ISO_ID_XXX
 726   </a>
 727
 728 </li>
 729
 730         <li class="md-nav__item">
 731   <a href="#tt_ms_id_xxx" class="md-nav__link">
 732     TT_MS_ID_XXX
 733   </a>
 734
 735 </li>
 736
 737         <li class="md-nav__item">
 738   <a href="#tt_adobe_id_xxx" class="md-nav__link">
 739     TT_ADOBE_ID_XXX
 740   </a>
 741
 742 </li>
 743
 744         <li class="md-nav__item">
 745   <a href="#tt_mac_langid_xxx" class="md-nav__link">
 746     TT_MAC_LANGID_XXX
 747   </a>
 748
 749 </li>
 750
 751         <li class="md-nav__item">
 752   <a href="#tt_ms_langid_xxx" class="md-nav__link">
 753     TT_MS_LANGID_XXX
 754   </a>
 755
 756 </li>
 757
 758         <li class="md-nav__item">
 759   <a href="#tt_name_id_xxx" class="md-nav__link">
 760     TT_NAME_ID_XXX
 761   </a>
 762
 763 </li>
 764
 765         <li class="md-nav__item">
 766   <a href="#tt_ucr_xxx" class="md-nav__link">
 767     TT_UCR_XXX
 768   </a>
 769
 770 </li>
 771
 772     </ul>
 773
 774 </nav>
 775
 776     </li>
 777
 778
 779
 780
 781
 782
 783
 784     <li class="md-nav__item">
 785       <a href="ft2-type1_tables.html" class="md-nav__link">
 786         Type 1 Tables
 787       </a>
 788     </li>
 789
 790
 791
 792
 793
 794
 795
 796     <li class="md-nav__item">
 797       <a href="ft2-sfnt_names.html" class="md-nav__link">
 798         SFNT Names
 799       </a>
 800     </li>
 801
 802
 803
 804
 805
 806
 807
 808     <li class="md-nav__item">
 809       <a href="ft2-bdf_fonts.html" class="md-nav__link">
 810         BDF and PCF Files
 811       </a>
 812     </li>
 813
 814
 815
 816
 817
 818
 819
 820     <li class="md-nav__item">
 821       <a href="ft2-cid_fonts.html" class="md-nav__link">
 822         CID Fonts
 823       </a>
 824     </li>
 825
 826
 827
 828
 829
 830
 831
 832     <li class="md-nav__item">
 833       <a href="ft2-pfr_fonts.html" class="md-nav__link">
 834         PFR Fonts
 835       </a>
 836     </li>
 837
 838
 839
 840
 841
 842
 843
 844     <li class="md-nav__item">
 845       <a href="ft2-winfnt_fonts.html" class="md-nav__link">
 846         Window FNT Files
 847       </a>
 848     </li>
 849
 850
 851
 852
 853
 854
 855
 856     <li class="md-nav__item">
 857       <a href="ft2-svg_fonts.html" class="md-nav__link">
 858         OpenType SVG Fonts
 859       </a>
 860     </li>
 861
 862
 863
 864
 865
 866
 867
 868     <li class="md-nav__item">
 869       <a href="ft2-font_formats.html" class="md-nav__link">
 870         Font Formats
 871       </a>
 872     </li>
 873
 874
 875
 876
 877
 878
 879
 880     <li class="md-nav__item">
 881       <a href="ft2-gasp_table.html" class="md-nav__link">
 882         Gasp Table
 883       </a>
 884     </li>
 885
 886
 887
 888         </ul>
 889       </nav>
 890     </li>
 891
 892
 893
 894
 895
 896
 897
 898
 899
 900
 901
 902     <li class="md-nav__item md-nav__item--nested">
 903
 904
 905         <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_7" type="checkbox" id="__nav_7" >
 906
 907       <label class="md-nav__link" for="__nav_7">
 908         Controlling FreeType Modules
 909         <span class="md-nav__icon md-icon"></span>
 910       </label>
 911       <nav class="md-nav" aria-label="Controlling FreeType Modules" data-md-level="1">
 912         <label class="md-nav__title" for="__nav_7">
 913           <span class="md-nav__icon md-icon"></span>
 914           Controlling FreeType Modules
 915         </label>
 916         <ul class="md-nav__list" data-md-scrollfix>
 917
 918
 919
 920
 921
 922     <li class="md-nav__item">
 923       <a href="ft2-auto_hinter.html" class="md-nav__link">
 924         The auto-hinter
 925       </a>
 926     </li>
 927
 928
 929
 930
 931
 932
 933
 934     <li class="md-nav__item">
 935       <a href="ft2-cff_driver.html" class="md-nav__link">
 936         The CFF driver
 937       </a>
 938     </li>
 939
 940
 941
 942
 943
 944
 945
 946     <li class="md-nav__item">
 947       <a href="ft2-t1_cid_driver.html" class="md-nav__link">
 948         The Type 1 and CID drivers
 949       </a>
 950     </li>
 951
 952
 953
 954
 955
 956
 957
 958     <li class="md-nav__item">
 959       <a href="ft2-tt_driver.html" class="md-nav__link">
 960         The TrueType driver
 961       </a>
 962     </li>
 963
 964
 965
 966
 967
 968
 969
 970     <li class="md-nav__item">
 971       <a href="ft2-pcf_driver.html" class="md-nav__link">
 972         The PCF driver
 973       </a>
 974     </li>
 975
 976
 977
 978
 979
 980
 981
 982     <li class="md-nav__item">
 983       <a href="ft2-ot_svg_driver.html" class="md-nav__link">
 984         The SVG driver
 985       </a>
 986     </li>
 987
 988
 989
 990
 991
 992
 993
 994     <li class="md-nav__item">
 995       <a href="ft2-properties.html" class="md-nav__link">
 996         Driver properties
 997       </a>
 998     </li>
 999
1000
1001
1002
1003
1004
1005
1006     <li class="md-nav__item">
1007       <a href="ft2-parameter_tags.html" class="md-nav__link">
1008         Parameter Tags
1009       </a>
1010     </li>
1011
1012
1013
1014
1015
1016
1017
1018     <li class="md-nav__item">
1019       <a href="ft2-lcd_rendering.html" class="md-nav__link">
1020         Subpixel Rendering
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_8" type="checkbox" id="__nav_8" >
1044
1045       <label class="md-nav__link" for="__nav_8">
1046         Cache Sub-System
1047         <span class="md-nav__icon md-icon"></span>
1048       </label>
1049       <nav class="md-nav" aria-label="Cache Sub-System" data-md-level="1">
1050         <label class="md-nav__title" for="__nav_8">
1051           <span class="md-nav__icon md-icon"></span>
1052           Cache Sub-System
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-cache_subsystem.html" class="md-nav__link">
1062         Cache Sub-System
1063       </a>
1064     </li>
1065
1066
1067
1068         </ul>
1069       </nav>
1070     </li>
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082     <li class="md-nav__item md-nav__item--nested">
1083
1084
1085         <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_9" type="checkbox" id="__nav_9" >
1086
1087       <label class="md-nav__link" for="__nav_9">
1088         Support API
1089         <span class="md-nav__icon md-icon"></span>
1090       </label>
1091       <nav class="md-nav" aria-label="Support API" data-md-level="1">
1092         <label class="md-nav__title" for="__nav_9">
1093           <span class="md-nav__icon md-icon"></span>
1094           Support API
1095         </label>
1096         <ul class="md-nav__list" data-md-scrollfix>
1097
1098
1099
1100
1101
1102     <li class="md-nav__item">
1103       <a href="ft2-computations.html" class="md-nav__link">
1104         Computations
1105       </a>
1106     </li>
1107
1108
1109
1110
1111
1112
1113
1114     <li class="md-nav__item">
1115       <a href="ft2-list_processing.html" class="md-nav__link">
1116         List Processing
1117       </a>
1118     </li>
1119
1120
1121
1122
1123
1124
1125
1126     <li class="md-nav__item">
1127       <a href="ft2-outline_processing.html" class="md-nav__link">
1128         Outline Processing
1129       </a>
1130     </li>
1131
1132
1133
1134
1135
1136
1137
1138     <li class="md-nav__item">
1139       <a href="ft2-quick_advance.html" class="md-nav__link">
1140         Quick retrieval of advance values
1141       </a>
1142     </li>
1143
1144
1145
1146
1147
1148
1149
1150     <li class="md-nav__item">
1151       <a href="ft2-bitmap_handling.html" class="md-nav__link">
1152         Bitmap Handling
1153       </a>
1154     </li>
1155
1156
1157
1158
1159
1160
1161
1162     <li class="md-nav__item">
1163       <a href="ft2-raster.html" class="md-nav__link">
1164         Scanline Converter
1165       </a>
1166     </li>
1167
1168
1169
1170
1171
1172
1173
1174     <li class="md-nav__item">
1175       <a href="ft2-glyph_stroker.html" class="md-nav__link">
1176         Glyph Stroker
1177       </a>
1178     </li>
1179
1180
1181
1182
1183
1184
1185
1186     <li class="md-nav__item">
1187       <a href="ft2-system_interface.html" class="md-nav__link">
1188         System Interface
1189       </a>
1190     </li>
1191
1192
1193
1194
1195
1196
1197
1198     <li class="md-nav__item">
1199       <a href="ft2-module_management.html" class="md-nav__link">
1200         Module Management
1201       </a>
1202     </li>
1203
1204
1205
1206
1207
1208
1209
1210     <li class="md-nav__item">
1211       <a href="ft2-gzip.html" class="md-nav__link">
1212         GZIP Streams
1213       </a>
1214     </li>
1215
1216
1217
1218
1219
1220
1221
1222     <li class="md-nav__item">
1223       <a href="ft2-lzw.html" class="md-nav__link">
1224         LZW Streams
1225       </a>
1226     </li>
1227
1228
1229
1230
1231
1232
1233
1234     <li class="md-nav__item">
1235       <a href="ft2-bzip2.html" class="md-nav__link">
1236         BZIP2 Streams
1237       </a>
1238     </li>
1239
1240
1241
1242
1243
1244
1245
1246     <li class="md-nav__item">
1247       <a href="ft2-debugging_apis.html" class="md-nav__link">
1248         External Debugging APIs
1249       </a>
1250     </li>
1251
1252
1253
1254         </ul>
1255       </nav>
1256     </li>
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268     <li class="md-nav__item md-nav__item--nested">
1269
1270
1271         <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_10" type="checkbox" id="__nav_10" >
1272
1273       <label class="md-nav__link" for="__nav_10">
1274         Error Codes
1275         <span class="md-nav__icon md-icon"></span>
1276       </label>
1277       <nav class="md-nav" aria-label="Error Codes" data-md-level="1">
1278         <label class="md-nav__title" for="__nav_10">
1279           <span class="md-nav__icon md-icon"></span>
1280           Error Codes
1281         </label>
1282         <ul class="md-nav__list" data-md-scrollfix>
1283
1284
1285
1286
1287
1288     <li class="md-nav__item">
1289       <a href="ft2-error_enumerations.html" class="md-nav__link">
1290         Error Enumerations
1291       </a>
1292     </li>
1293
1294
1295
1296
1297
1298
1299
1300     <li class="md-nav__item">
1301       <a href="ft2-error_code_values.html" class="md-nav__link">
1302         Error Code Values
1303       </a>
1304     </li>
1305
1306
1307
1308         </ul>
1309       </nav>
1310     </li>
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322     <li class="md-nav__item md-nav__item--nested">
1323
1324
1325         <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_11" type="checkbox" id="__nav_11" >
1326
1327       <label class="md-nav__link" for="__nav_11">
1328         Miscellaneous
1329         <span class="md-nav__icon md-icon"></span>
1330       </label>
1331       <nav class="md-nav" aria-label="Miscellaneous" data-md-level="1">
1332         <label class="md-nav__title" for="__nav_11">
1333           <span class="md-nav__icon md-icon"></span>
1334           Miscellaneous
1335         </label>
1336         <ul class="md-nav__list" data-md-scrollfix>
1337
1338
1339
1340
1341
1342     <li class="md-nav__item">
1343       <a href="ft2-gx_validation.html" class="md-nav__link">
1344         TrueTypeGX/AAT Validation
1345       </a>
1346     </li>
1347
1348
1349
1350
1351
1352
1353
1354     <li class="md-nav__item">
1355       <a href="ft2-incremental.html" class="md-nav__link">
1356         Incremental Loading
1357       </a>
1358     </li>
1359
1360
1361
1362
1363
1364
1365
1366     <li class="md-nav__item">
1367       <a href="ft2-truetype_engine.html" class="md-nav__link">
1368         The TrueType Engine
1369       </a>
1370     </li>
1371
1372
1373
1374
1375
1376
1377
1378     <li class="md-nav__item">
1379       <a href="ft2-ot_validation.html" class="md-nav__link">
1380         OpenType Validation
1381       </a>
1382     </li>
1383
1384
1385
1386         </ul>
1387       </nav>
1388     </li>
1389
1390
1391
1392   </ul>
1393 </nav>
1394                   </div>
1395                 </div>
1396               </div>
1397
1398
1399
1400               <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
1401                 <div class="md-sidebar__scrollwrap">
1402                   <div class="md-sidebar__inner">
1403
1404 <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
1405
1406
1407
1408
1409
1410
1411     <label class="md-nav__title" for="__toc">
1412       <span class="md-nav__icon md-icon"></span>
1413       Table of contents
1414     </label>
1415     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
1416
1417         <li class="md-nav__item">
1418   <a href="#synopsis" class="md-nav__link">
1419     Synopsis
1420   </a>
1421
1422 </li>
1423
1424         <li class="md-nav__item">
1425   <a href="#tt_header" class="md-nav__link">
1426     TT_Header
1427   </a>
1428
1429 </li>
1430
1431         <li class="md-nav__item">
1432   <a href="#tt_horiheader" class="md-nav__link">
1433     TT_HoriHeader
1434   </a>
1435
1436 </li>
1437
1438         <li class="md-nav__item">
1439   <a href="#tt_vertheader" class="md-nav__link">
1440     TT_VertHeader
1441   </a>
1442
1443 </li>
1444
1445         <li class="md-nav__item">
1446   <a href="#tt_os2" class="md-nav__link">
1447     TT_OS2
1448   </a>
1449
1450 </li>
1451
1452         <li class="md-nav__item">
1453   <a href="#tt_postscript" class="md-nav__link">
1454     TT_Postscript
1455   </a>
1456
1457 </li>
1458
1459         <li class="md-nav__item">
1460   <a href="#tt_pclt" class="md-nav__link">
1461     TT_PCLT
1462   </a>
1463
1464 </li>
1465
1466         <li class="md-nav__item">
1467   <a href="#tt_maxprofile" class="md-nav__link">
1468     TT_MaxProfile
1469   </a>
1470
1471 </li>
1472
1473         <li class="md-nav__item">
1474   <a href="#ft_sfnt_tag" class="md-nav__link">
1475     FT_Sfnt_Tag
1476   </a>
1477
1478 </li>
1479
1480         <li class="md-nav__item">
1481   <a href="#ft_get_sfnt_table" class="md-nav__link">
1482     FT_Get_Sfnt_Table
1483   </a>
1484
1485 </li>
1486
1487         <li class="md-nav__item">
1488   <a href="#ft_load_sfnt_table" class="md-nav__link">
1489     FT_Load_Sfnt_Table
1490   </a>
1491
1492 </li>
1493
1494         <li class="md-nav__item">
1495   <a href="#ft_sfnt_table_info" class="md-nav__link">
1496     FT_Sfnt_Table_Info
1497   </a>
1498
1499 </li>
1500
1501         <li class="md-nav__item">
1502   <a href="#ft_get_cmap_language_id" class="md-nav__link">
1503     FT_Get_CMap_Language_ID
1504   </a>
1505
1506 </li>
1507
1508         <li class="md-nav__item">
1509   <a href="#ft_get_cmap_format" class="md-nav__link">
1510     FT_Get_CMap_Format
1511   </a>
1512
1513 </li>
1514
1515         <li class="md-nav__item">
1516   <a href="#ft_param_tag_unpatented_hinting" class="md-nav__link">
1517     FT_PARAM_TAG_UNPATENTED_HINTING
1518   </a>
1519
1520 </li>
1521
1522         <li class="md-nav__item">
1523   <a href="#tt_platform_xxx" class="md-nav__link">
1524     TT_PLATFORM_XXX
1525   </a>
1526
1527 </li>
1528
1529         <li class="md-nav__item">
1530   <a href="#tt_apple_id_xxx" class="md-nav__link">
1531     TT_APPLE_ID_XXX
1532   </a>
1533
1534 </li>
1535
1536         <li class="md-nav__item">
1537   <a href="#tt_mac_id_xxx" class="md-nav__link">
1538     TT_MAC_ID_XXX
1539   </a>
1540
1541 </li>
1542
1543         <li class="md-nav__item">
1544   <a href="#tt_iso_id_xxx" class="md-nav__link">
1545     TT_ISO_ID_XXX
1546   </a>
1547
1548 </li>
1549
1550         <li class="md-nav__item">
1551   <a href="#tt_ms_id_xxx" class="md-nav__link">
1552     TT_MS_ID_XXX
1553   </a>
1554
1555 </li>
1556
1557         <li class="md-nav__item">
1558   <a href="#tt_adobe_id_xxx" class="md-nav__link">
1559     TT_ADOBE_ID_XXX
1560   </a>
1561
1562 </li>
1563
1564         <li class="md-nav__item">
1565   <a href="#tt_mac_langid_xxx" class="md-nav__link">
1566     TT_MAC_LANGID_XXX
1567   </a>
1568
1569 </li>
1570
1571         <li class="md-nav__item">
1572   <a href="#tt_ms_langid_xxx" class="md-nav__link">
1573     TT_MS_LANGID_XXX
1574   </a>
1575
1576 </li>
1577
1578         <li class="md-nav__item">
1579   <a href="#tt_name_id_xxx" class="md-nav__link">
1580     TT_NAME_ID_XXX
1581   </a>
1582
1583 </li>
1584
1585         <li class="md-nav__item">
1586   <a href="#tt_ucr_xxx" class="md-nav__link">
1587     TT_UCR_XXX
1588   </a>
1589
1590 </li>
1591
1592     </ul>
1593
1594 </nav>
1595                   </div>
1596                 </div>
1597               </div>
1598
1599
1600           <div class="md-content" data-md-component="content">
1601             <article class="md-content__inner md-typeset">
1602
1603
1604
1605                 <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; TrueType Tables</p>
1606 <hr />
1607 <h1 id="truetype-tables">TrueType Tables<a class="headerlink" href="#truetype-tables" title="Permanent link">&para;</a></h1>
1608 <h2 id="synopsis">Synopsis<a class="headerlink" href="#synopsis" title="Permanent link">&para;</a></h2>
1609 <p>This section contains definitions of some basic tables specific to TrueType and OpenType as well as some routines used to access and process them.</p>
1610 <h2 id="tt_header">TT_Header<a class="headerlink" href="#tt_header" title="Permanent link">&para;</a></h2>
1611 <p>Defined in FT_TRUETYPE_TABLES_H (freetype/tttables.h).</p>
1612 <div class = "codehilite"><pre><code>  <span class="keyword">typedef</span> <span class="keyword">struct</span>  TT_Header_
1613   {
1614     <a href="ft2-basic_types.html#ft_fixed">FT_Fixed</a>   Table_Version;
1615     <a href="ft2-basic_types.html#ft_fixed">FT_Fixed</a>   Font_Revision;
1616
1617     <a href="ft2-basic_types.html#ft_long">FT_Long</a>    CheckSum_Adjust;
1618     <a href="ft2-basic_types.html#ft_long">FT_Long</a>    Magic_Number;
1619
1620     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  Flags;
1621     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  Units_Per_EM;
1622
1623     <a href="ft2-basic_types.html#ft_ulong">FT_ULong</a>   Created [2];
1624     <a href="ft2-basic_types.html#ft_ulong">FT_ULong</a>   Modified[2];
1625
1626     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   xMin;
1627     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   yMin;
1628     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   xMax;
1629     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   yMax;
1630
1631     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  Mac_Style;
1632     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  Lowest_Rec_PPEM;
1633
1634     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   Font_Direction;
1635     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   Index_To_Loc_Format;
1636     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   Glyph_Data_Format;
1637
1638   } <b>TT_Header</b>;
1639 </code></pre></div>
1640
1641 <p>A structure to model a TrueType font header table. All fields follow the OpenType specification. The 64-bit timestamps are stored in two-element arrays <code>Created</code> and <code>Modified</code>, first the upper then the lower 32&nbsp;bits.</p>
1642 <hr>
1643
1644 <h2 id="tt_horiheader">TT_HoriHeader<a class="headerlink" href="#tt_horiheader" title="Permanent link">&para;</a></h2>
1645 <p>Defined in FT_TRUETYPE_TABLES_H (freetype/tttables.h).</p>
1646 <div class = "codehilite"><pre><code>  <span class="keyword">typedef</span> <span class="keyword">struct</span>  TT_HoriHeader_
1647   {
1648     <a href="ft2-basic_types.html#ft_fixed">FT_Fixed</a>   Version;
1649     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   Ascender;
1650     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   Descender;
1651     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   Line_Gap;
1652
1653     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  advance_Width_Max;      /* advance width maximum */
1654
1655     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   min_Left_Side_Bearing;  /* minimum left-sb       */
1656     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   min_Right_Side_Bearing; /* minimum right-sb      */
1657     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   xMax_Extent;            /* xmax extents          */
1658     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   caret_Slope_Rise;
1659     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   caret_Slope_Run;
1660     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   caret_Offset;
1661
1662     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   Reserved[4];
1663
1664     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   metric_Data_Format;
1665     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  number_Of_HMetrics;
1666
1667     /* The following fields are not defined by the OpenType specification */
1668     /* but they are used to connect the metrics header to the relevant    */
1669     /* 'hmtx' table.                                                      */
1670
1671     <span class="keyword">void</span>*      long_metrics;
1672     <span class="keyword">void</span>*      short_metrics;
1673
1674   } <b>TT_HoriHeader</b>;
1675 </code></pre></div>
1676
1677 <p>A structure to model a TrueType horizontal header, the &lsquo;hhea&rsquo; table, as well as the corresponding horizontal metrics table, &lsquo;hmtx&rsquo;.</p>
1678 <h4>fields</h4>
1679 <table class="fields">
1680 <tr><td class="val" id="version">Version</td><td class="desc">
1681 <p>The table version.</p>
1682 </td></tr>
1683 <tr><td class="val" id="ascender">Ascender</td><td class="desc">
1684 <p>The font's ascender, i.e., the distance from the baseline to the top-most of all glyph points found in the font.</p>
1685 <p>This value is invalid in many fonts, as it is usually set by the font designer, and often reflects only a portion of the glyphs found in the font (maybe ASCII).</p>
1686 <p>You should use the <code>sTypoAscender</code> field of the &lsquo;OS/2&rsquo; table instead if you want the correct one.</p>
1687 </td></tr>
1688 <tr><td class="val" id="descender">Descender</td><td class="desc">
1689 <p>The font's descender, i.e., the distance from the baseline to the bottom-most of all glyph points found in the font. It is negative.</p>
1690 <p>This value is invalid in many fonts, as it is usually set by the font designer, and often reflects only a portion of the glyphs found in the font (maybe ASCII).</p>
1691 <p>You should use the <code>sTypoDescender</code> field of the &lsquo;OS/2&rsquo; table instead if you want the correct one.</p>
1692 </td></tr>
1693 <tr><td class="val" id="line_gap">Line_Gap</td><td class="desc">
1694 <p>The font's line gap, i.e., the distance to add to the ascender and descender to get the BTB, i.e., the baseline-to-baseline distance for the font.</p>
1695 </td></tr>
1696 <tr><td class="val" id="advance_width_max">advance_Width_Max</td><td class="desc">
1697 <p>This field is the maximum of all advance widths found in the font. It can be used to compute the maximum width of an arbitrary string of text.</p>
1698 </td></tr>
1699 <tr><td class="val" id="min_left_side_bearing">min_Left_Side_Bearing</td><td class="desc">
1700 <p>The minimum left side bearing of all glyphs within the font.</p>
1701 </td></tr>
1702 <tr><td class="val" id="min_right_side_bearing">min_Right_Side_Bearing</td><td class="desc">
1703 <p>The minimum right side bearing of all glyphs within the font.</p>
1704 </td></tr>
1705 <tr><td class="val" id="xmax_extent">xMax_Extent</td><td class="desc">
1706 <p>The maximum horizontal extent (i.e., the &lsquo;width&rsquo; of a glyph's bounding box) for all glyphs in the font.</p>
1707 </td></tr>
1708 <tr><td class="val" id="caret_slope_rise">caret_Slope_Rise</td><td class="desc">
1709 <p>The rise coefficient of the cursor's slope of the cursor (slope=rise/run).</p>
1710 </td></tr>
1711 <tr><td class="val" id="caret_slope_run">caret_Slope_Run</td><td class="desc">
1712 <p>The run coefficient of the cursor's slope.</p>
1713 </td></tr>
1714 <tr><td class="val" id="caret_offset">caret_Offset</td><td class="desc">
1715 <p>The cursor's offset for slanted fonts.</p>
1716 </td></tr>
1717 <tr><td class="val" id="reserved">Reserved</td><td class="desc">
1718 <p>8&nbsp;reserved bytes.</p>
1719 </td></tr>
1720 <tr><td class="val" id="metric_data_format">metric_Data_Format</td><td class="desc">
1721 <p>Always&nbsp;0.</p>
1722 </td></tr>
1723 <tr><td class="val" id="number_of_hmetrics">number_Of_HMetrics</td><td class="desc">
1724 <p>Number of HMetrics entries in the &lsquo;hmtx&rsquo; table &ndash; this value can be smaller than the total number of glyphs in the font.</p>
1725 </td></tr>
1726 <tr><td class="val" id="long_metrics">long_metrics</td><td class="desc">
1727 <p>A pointer into the &lsquo;hmtx&rsquo; table.</p>
1728 </td></tr>
1729 <tr><td class="val" id="short_metrics">short_metrics</td><td class="desc">
1730 <p>A pointer into the &lsquo;hmtx&rsquo; table.</p>
1731 </td></tr>
1732 </table>
1733
1734 <h4>note</h4>
1735
1736 <p>For an OpenType variation font, the values of the following fields can change after a call to <code><a href="ft2-multiple_masters.html#ft_set_var_design_coordinates">FT_Set_Var_Design_Coordinates</a></code> (and friends) if the font contains an &lsquo;MVAR&rsquo; table: <code>caret_Slope_Rise</code>, <code>caret_Slope_Run</code>, and <code>caret_Offset</code>.</p>
1737 <hr>
1738
1739 <h2 id="tt_vertheader">TT_VertHeader<a class="headerlink" href="#tt_vertheader" title="Permanent link">&para;</a></h2>
1740 <p>Defined in FT_TRUETYPE_TABLES_H (freetype/tttables.h).</p>
1741 <div class = "codehilite"><pre><code>  <span class="keyword">typedef</span> <span class="keyword">struct</span>  TT_VertHeader_
1742   {
1743     <a href="ft2-basic_types.html#ft_fixed">FT_Fixed</a>   Version;
1744     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   Ascender;
1745     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   Descender;
1746     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   Line_Gap;
1747
1748     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  advance_Height_Max;      /* advance height maximum */
1749
1750     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   min_Top_Side_Bearing;    /* minimum top-sb          */
1751     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   min_Bottom_Side_Bearing; /* minimum bottom-sb       */
1752     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   yMax_Extent;             /* ymax extents            */
1753     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   caret_Slope_Rise;
1754     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   caret_Slope_Run;
1755     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   caret_Offset;
1756
1757     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   Reserved[4];
1758
1759     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   metric_Data_Format;
1760     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  number_Of_VMetrics;
1761
1762     /* The following fields are not defined by the OpenType specification */
1763     /* but they are used to connect the metrics header to the relevant    */
1764     /* 'vmtx' table.                                                      */
1765
1766     <span class="keyword">void</span>*      long_metrics;
1767     <span class="keyword">void</span>*      short_metrics;
1768
1769   } <b>TT_VertHeader</b>;
1770 </code></pre></div>
1771
1772 <p>A structure used to model a TrueType vertical header, the &lsquo;vhea&rsquo; table, as well as the corresponding vertical metrics table, &lsquo;vmtx&rsquo;.</p>
1773 <h4>fields</h4>
1774 <table class="fields">
1775 <tr><td class="val" id="version">Version</td><td class="desc">
1776 <p>The table version.</p>
1777 </td></tr>
1778 <tr><td class="val" id="ascender">Ascender</td><td class="desc">
1779 <p>The font's ascender, i.e., the distance from the baseline to the top-most of all glyph points found in the font.</p>
1780 <p>This value is invalid in many fonts, as it is usually set by the font designer, and often reflects only a portion of the glyphs found in the font (maybe ASCII).</p>
1781 <p>You should use the <code>sTypoAscender</code> field of the &lsquo;OS/2&rsquo; table instead if you want the correct one.</p>
1782 </td></tr>
1783 <tr><td class="val" id="descender">Descender</td><td class="desc">
1784 <p>The font's descender, i.e., the distance from the baseline to the bottom-most of all glyph points found in the font. It is negative.</p>
1785 <p>This value is invalid in many fonts, as it is usually set by the font designer, and often reflects only a portion of the glyphs found in the font (maybe ASCII).</p>
1786 <p>You should use the <code>sTypoDescender</code> field of the &lsquo;OS/2&rsquo; table instead if you want the correct one.</p>
1787 </td></tr>
1788 <tr><td class="val" id="line_gap">Line_Gap</td><td class="desc">
1789 <p>The font's line gap, i.e., the distance to add to the ascender and descender to get the BTB, i.e., the baseline-to-baseline distance for the font.</p>
1790 </td></tr>
1791 <tr><td class="val" id="advance_height_max">advance_Height_Max</td><td class="desc">
1792 <p>This field is the maximum of all advance heights found in the font. It can be used to compute the maximum height of an arbitrary string of text.</p>
1793 </td></tr>
1794 <tr><td class="val" id="min_top_side_bearing">min_Top_Side_Bearing</td><td class="desc">
1795 <p>The minimum top side bearing of all glyphs within the font.</p>
1796 </td></tr>
1797 <tr><td class="val" id="min_bottom_side_bearing">min_Bottom_Side_Bearing</td><td class="desc">
1798 <p>The minimum bottom side bearing of all glyphs within the font.</p>
1799 </td></tr>
1800 <tr><td class="val" id="ymax_extent">yMax_Extent</td><td class="desc">
1801 <p>The maximum vertical extent (i.e., the &lsquo;height&rsquo; of a glyph's bounding box) for all glyphs in the font.</p>
1802 </td></tr>
1803 <tr><td class="val" id="caret_slope_rise">caret_Slope_Rise</td><td class="desc">
1804 <p>The rise coefficient of the cursor's slope of the cursor (slope=rise/run).</p>
1805 </td></tr>
1806 <tr><td class="val" id="caret_slope_run">caret_Slope_Run</td><td class="desc">
1807 <p>The run coefficient of the cursor's slope.</p>
1808 </td></tr>
1809 <tr><td class="val" id="caret_offset">caret_Offset</td><td class="desc">
1810 <p>The cursor's offset for slanted fonts.</p>
1811 </td></tr>
1812 <tr><td class="val" id="reserved">Reserved</td><td class="desc">
1813 <p>8&nbsp;reserved bytes.</p>
1814 </td></tr>
1815 <tr><td class="val" id="metric_data_format">metric_Data_Format</td><td class="desc">
1816 <p>Always&nbsp;0.</p>
1817 </td></tr>
1818 <tr><td class="val" id="number_of_vmetrics">number_Of_VMetrics</td><td class="desc">
1819 <p>Number of VMetrics entries in the &lsquo;vmtx&rsquo; table &ndash; this value can be smaller than the total number of glyphs in the font.</p>
1820 </td></tr>
1821 <tr><td class="val" id="long_metrics">long_metrics</td><td class="desc">
1822 <p>A pointer into the &lsquo;vmtx&rsquo; table.</p>
1823 </td></tr>
1824 <tr><td class="val" id="short_metrics">short_metrics</td><td class="desc">
1825 <p>A pointer into the &lsquo;vmtx&rsquo; table.</p>
1826 </td></tr>
1827 </table>
1828
1829 <h4>note</h4>
1830
1831 <p>For an OpenType variation font, the values of the following fields can change after a call to <code><a href="ft2-multiple_masters.html#ft_set_var_design_coordinates">FT_Set_Var_Design_Coordinates</a></code> (and friends) if the font contains an &lsquo;MVAR&rsquo; table: <code>Ascender</code>, <code>Descender</code>, <code>Line_Gap</code>, <code>caret_Slope_Rise</code>, <code>caret_Slope_Run</code>, and <code>caret_Offset</code>.</p>
1832 <hr>
1833
1834 <h2 id="tt_os2">TT_OS2<a class="headerlink" href="#tt_os2" title="Permanent link">&para;</a></h2>
1835 <p>Defined in FT_TRUETYPE_TABLES_H (freetype/tttables.h).</p>
1836 <div class = "codehilite"><pre><code>  <span class="keyword">typedef</span> <span class="keyword">struct</span>  TT_OS2_
1837   {
1838     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  version;                /* 0x0001 - more or 0xFFFF */
1839     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   xAvgCharWidth;
1840     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  usWeightClass;
1841     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  usWidthClass;
1842     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  fsType;
1843     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   ySubscriptXSize;
1844     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   ySubscriptYSize;
1845     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   ySubscriptXOffset;
1846     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   ySubscriptYOffset;
1847     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   ySuperscriptXSize;
1848     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   ySuperscriptYSize;
1849     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   ySuperscriptXOffset;
1850     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   ySuperscriptYOffset;
1851     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   yStrikeoutSize;
1852     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   yStrikeoutPosition;
1853     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   sFamilyClass;
1854
1855     <a href="ft2-basic_types.html#ft_byte">FT_Byte</a>    panose[10];
1856
1857     <a href="ft2-basic_types.html#ft_ulong">FT_ULong</a>   ulUnicodeRange1;        /* Bits 0-31   */
1858     <a href="ft2-basic_types.html#ft_ulong">FT_ULong</a>   ulUnicodeRange2;        /* Bits 32-63  */
1859     <a href="ft2-basic_types.html#ft_ulong">FT_ULong</a>   ulUnicodeRange3;        /* Bits 64-95  */
1860     <a href="ft2-basic_types.html#ft_ulong">FT_ULong</a>   ulUnicodeRange4;        /* Bits 96-127 */
1861
1862     <a href="ft2-basic_types.html#ft_char">FT_Char</a>    achVendID[4];
1863
1864     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  fsSelection;
1865     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  usFirstCharIndex;
1866     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  usLastCharIndex;
1867     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   sTypoAscender;
1868     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   sTypoDescender;
1869     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   sTypoLineGap;
1870     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  usWinAscent;
1871     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  usWinDescent;
1872
1873     /* only version 1 and higher: */
1874
1875     <a href="ft2-basic_types.html#ft_ulong">FT_ULong</a>   ulCodePageRange1;       /* Bits 0-31   */
1876     <a href="ft2-basic_types.html#ft_ulong">FT_ULong</a>   ulCodePageRange2;       /* Bits 32-63  */
1877
1878     /* only version 2 and higher: */
1879
1880     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   sxHeight;
1881     <a href="ft2-basic_types.html#ft_short">FT_Short</a>   sCapHeight;
1882     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  usDefaultChar;
1883     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  usBreakChar;
1884     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  usMaxContext;
1885
1886     /* only version 5 and higher: */
1887
1888     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  usLowerOpticalPointSize;       /* in twips (1/20 points) */
1889     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  usUpperOpticalPointSize;       /* in twips (1/20 points) */
1890
1891   } <b>TT_OS2</b>;
1892 </code></pre></div>
1893
1894 <p>A structure to model a TrueType &lsquo;OS/2&rsquo; table. All fields comply to the OpenType specification.</p>
1895 <p>Note that we now support old Mac fonts that do not include an &lsquo;OS/2&rsquo; table. In this case, the <code>version</code> field is always set to 0xFFFF.</p>
1896 <h4>note</h4>
1897
1898 <p>For an OpenType variation font, the values of the following fields can change after a call to <code><a href="ft2-multiple_masters.html#ft_set_var_design_coordinates">FT_Set_Var_Design_Coordinates</a></code> (and friends) if the font contains an &lsquo;MVAR&rsquo; table: <code>sCapHeight</code>, <code>sTypoAscender</code>, <code>sTypoDescender</code>, <code>sTypoLineGap</code>, <code>sxHeight</code>, <code>usWinAscent</code>, <code>usWinDescent</code>, <code>yStrikeoutPosition</code>, <code>yStrikeoutSize</code>, <code>ySubscriptXOffset</code>, <code>ySubScriptXSize</code>, <code>ySubscriptYOffset</code>, <code>ySubscriptYSize</code>, <code>ySuperscriptXOffset</code>, <code>ySuperscriptXSize</code>, <code>ySuperscriptYOffset</code>, and <code>ySuperscriptYSize</code>.</p>
1899 <p>Possible values for bits in the <code>ulUnicodeRangeX</code> fields are given by the <code><a href="ft2-truetype_tables.html#tt_ucr_xxx">TT_UCR_XXX</a></code> macros.</p>
1900 <hr>
1901
1902 <h2 id="tt_postscript">TT_Postscript<a class="headerlink" href="#tt_postscript" title="Permanent link">&para;</a></h2>
1903 <p>Defined in FT_TRUETYPE_TABLES_H (freetype/tttables.h).</p>
1904 <div class = "codehilite"><pre><code>  <span class="keyword">typedef</span> <span class="keyword">struct</span>  TT_Postscript_
1905   {
1906     <a href="ft2-basic_types.html#ft_fixed">FT_Fixed</a>  FormatType;
1907     <a href="ft2-basic_types.html#ft_fixed">FT_Fixed</a>  italicAngle;
1908     <a href="ft2-basic_types.html#ft_short">FT_Short</a>  underlinePosition;
1909     <a href="ft2-basic_types.html#ft_short">FT_Short</a>  underlineThickness;
1910     <a href="ft2-basic_types.html#ft_ulong">FT_ULong</a>  isFixedPitch;
1911     <a href="ft2-basic_types.html#ft_ulong">FT_ULong</a>  minMemType42;
1912     <a href="ft2-basic_types.html#ft_ulong">FT_ULong</a>  maxMemType42;
1913     <a href="ft2-basic_types.html#ft_ulong">FT_ULong</a>  minMemType1;
1914     <a href="ft2-basic_types.html#ft_ulong">FT_ULong</a>  maxMemType1;
1915
1916     /* Glyph names follow in the 'post' table, but we don't */
1917     /* load them by default.                                */
1918
1919   } <b>TT_Postscript</b>;
1920 </code></pre></div>
1921
1922 <p>A structure to model a TrueType &lsquo;post&rsquo; table. All fields comply to the OpenType specification. This structure does not reference a font's PostScript glyph names; use <code><a href="ft2-information_retrieval.html#ft_get_glyph_name">FT_Get_Glyph_Name</a></code> to retrieve them.</p>
1923 <h4>note</h4>
1924
1925 <p>For an OpenType variation font, the values of the following fields can change after a call to <code><a href="ft2-multiple_masters.html#ft_set_var_design_coordinates">FT_Set_Var_Design_Coordinates</a></code> (and friends) if the font contains an &lsquo;MVAR&rsquo; table: <code>underlinePosition</code> and <code>underlineThickness</code>.</p>
1926 <hr>
1927
1928 <h2 id="tt_pclt">TT_PCLT<a class="headerlink" href="#tt_pclt" title="Permanent link">&para;</a></h2>
1929 <p>Defined in FT_TRUETYPE_TABLES_H (freetype/tttables.h).</p>
1930 <div class = "codehilite"><pre><code>  <span class="keyword">typedef</span> <span class="keyword">struct</span>  TT_PCLT_
1931   {
1932     <a href="ft2-basic_types.html#ft_fixed">FT_Fixed</a>   Version;
1933     <a href="ft2-basic_types.html#ft_ulong">FT_ULong</a>   FontNumber;
1934     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  Pitch;
1935     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  xHeight;
1936     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  Style;
1937     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  TypeFamily;
1938     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  CapHeight;
1939     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  SymbolSet;
1940     <a href="ft2-basic_types.html#ft_char">FT_Char</a>    TypeFace[16];
1941     <a href="ft2-basic_types.html#ft_char">FT_Char</a>    CharacterComplement[8];
1942     <a href="ft2-basic_types.html#ft_char">FT_Char</a>    FileName[6];
1943     <a href="ft2-basic_types.html#ft_char">FT_Char</a>    StrokeWeight;
1944     <a href="ft2-basic_types.html#ft_char">FT_Char</a>    WidthType;
1945     <a href="ft2-basic_types.html#ft_byte">FT_Byte</a>    SerifStyle;
1946     <a href="ft2-basic_types.html#ft_byte">FT_Byte</a>    Reserved;
1947
1948   } <b>TT_PCLT</b>;
1949 </code></pre></div>
1950
1951 <p>A structure to model a TrueType &lsquo;PCLT&rsquo; table. All fields comply to the OpenType specification.</p>
1952 <hr>
1953
1954 <h2 id="tt_maxprofile">TT_MaxProfile<a class="headerlink" href="#tt_maxprofile" title="Permanent link">&para;</a></h2>
1955 <p>Defined in FT_TRUETYPE_TABLES_H (freetype/tttables.h).</p>
1956 <div class = "codehilite"><pre><code>  <span class="keyword">typedef</span> <span class="keyword">struct</span>  TT_MaxProfile_
1957   {
1958     <a href="ft2-basic_types.html#ft_fixed">FT_Fixed</a>   version;
1959     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  numGlyphs;
1960     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  maxPoints;
1961     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  maxContours;
1962     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  maxCompositePoints;
1963     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  maxCompositeContours;
1964     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  maxZones;
1965     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  maxTwilightPoints;
1966     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  maxStorage;
1967     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  maxFunctionDefs;
1968     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  maxInstructionDefs;
1969     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  maxStackElements;
1970     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  maxSizeOfInstructions;
1971     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  maxComponentElements;
1972     <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a>  maxComponentDepth;
1973
1974   } <b>TT_MaxProfile</b>;
1975 </code></pre></div>
1976
1977 <p>The maximum profile (&lsquo;maxp&rsquo;) table contains many max values, which can be used to pre-allocate arrays for speeding up glyph loading and hinting.</p>
1978 <h4>fields</h4>
1979 <table class="fields">
1980 <tr><td class="val" id="version">version</td><td class="desc">
1981 <p>The version number.</p>
1982 </td></tr>
1983 <tr><td class="val" id="numglyphs">numGlyphs</td><td class="desc">
1984 <p>The number of glyphs in this TrueType font.</p>
1985 </td></tr>
1986 <tr><td class="val" id="maxpoints">maxPoints</td><td class="desc">
1987 <p>The maximum number of points in a non-composite TrueType glyph. See also <code>maxCompositePoints</code>.</p>
1988 </td></tr>
1989 <tr><td class="val" id="maxcontours">maxContours</td><td class="desc">
1990 <p>The maximum number of contours in a non-composite TrueType glyph. See also <code>maxCompositeContours</code>.</p>
1991 </td></tr>
1992 <tr><td class="val" id="maxcompositepoints">maxCompositePoints</td><td class="desc">
1993 <p>The maximum number of points in a composite TrueType glyph. See also <code>maxPoints</code>.</p>
1994 </td></tr>
1995 <tr><td class="val" id="maxcompositecontours">maxCompositeContours</td><td class="desc">
1996 <p>The maximum number of contours in a composite TrueType glyph. See also <code>maxContours</code>.</p>
1997 </td></tr>
1998 <tr><td class="val" id="maxzones">maxZones</td><td class="desc">
1999 <p>The maximum number of zones used for glyph hinting.</p>
2000 </td></tr>
2001 <tr><td class="val" id="maxtwilightpoints">maxTwilightPoints</td><td class="desc">
2002 <p>The maximum number of points in the twilight zone used for glyph hinting.</p>
2003 </td></tr>
2004 <tr><td class="val" id="maxstorage">maxStorage</td><td class="desc">
2005 <p>The maximum number of elements in the storage area used for glyph hinting.</p>
2006 </td></tr>
2007 <tr><td class="val" id="maxfunctiondefs">maxFunctionDefs</td><td class="desc">
2008 <p>The maximum number of function definitions in the TrueType bytecode for this font.</p>
2009 </td></tr>
2010 <tr><td class="val" id="maxinstructiondefs">maxInstructionDefs</td><td class="desc">
2011 <p>The maximum number of instruction definitions in the TrueType bytecode for this font.</p>
2012 </td></tr>
2013 <tr><td class="val" id="maxstackelements">maxStackElements</td><td class="desc">
2014 <p>The maximum number of stack elements used during bytecode interpretation.</p>
2015 </td></tr>
2016 <tr><td class="val" id="maxsizeofinstructions">maxSizeOfInstructions</td><td class="desc">
2017 <p>The maximum number of TrueType opcodes used for glyph hinting.</p>
2018 </td></tr>
2019 <tr><td class="val" id="maxcomponentelements">maxComponentElements</td><td class="desc">
2020 <p>The maximum number of simple (i.e., non-composite) glyphs in a composite glyph.</p>
2021 </td></tr>
2022 <tr><td class="val" id="maxcomponentdepth">maxComponentDepth</td><td class="desc">
2023 <p>The maximum nesting depth of composite glyphs.</p>
2024 </td></tr>
2025 </table>
2026
2027 <h4>note</h4>
2028
2029 <p>This structure is only used during font loading.</p>
2030 <hr>
2031
2032 <h2 id="ft_sfnt_tag">FT_Sfnt_Tag<a class="headerlink" href="#ft_sfnt_tag" title="Permanent link">&para;</a></h2>
2033 <p>Defined in FT_TRUETYPE_TABLES_H (freetype/tttables.h).</p>
2034 <div class = "codehilite"><pre><code>  <span class="keyword">typedef</span> <span class="keyword">enum</span>  FT_Sfnt_Tag_
2035   {
2036     <a href="ft2-truetype_tables.html#ft_sfnt_head">FT_SFNT_HEAD</a>,
2037     <a href="ft2-truetype_tables.html#ft_sfnt_maxp">FT_SFNT_MAXP</a>,
2038     <a href="ft2-truetype_tables.html#ft_sfnt_os2">FT_SFNT_OS2</a>,
2039     <a href="ft2-truetype_tables.html#ft_sfnt_hhea">FT_SFNT_HHEA</a>,
2040     <a href="ft2-truetype_tables.html#ft_sfnt_vhea">FT_SFNT_VHEA</a>,
2041     <a href="ft2-truetype_tables.html#ft_sfnt_post">FT_SFNT_POST</a>,
2042     <a href="ft2-truetype_tables.html#ft_sfnt_pclt">FT_SFNT_PCLT</a>,
2043
2044     FT_SFNT_MAX
2045
2046   } <b>FT_Sfnt_Tag</b>;
2047
2048   /* these constants are deprecated; use the corresponding `<b>FT_Sfnt_Tag</b>` */
2049   /* values instead                                                      */
2050 #<span class="keyword">define</span> ft_sfnt_head  <a href="ft2-truetype_tables.html#ft_sfnt_head">FT_SFNT_HEAD</a>
2051 #<span class="keyword">define</span> ft_sfnt_maxp  <a href="ft2-truetype_tables.html#ft_sfnt_maxp">FT_SFNT_MAXP</a>
2052 #<span class="keyword">define</span> ft_sfnt_os2   <a href="ft2-truetype_tables.html#ft_sfnt_os2">FT_SFNT_OS2</a>
2053 #<span class="keyword">define</span> ft_sfnt_hhea  <a href="ft2-truetype_tables.html#ft_sfnt_hhea">FT_SFNT_HHEA</a>
2054 #<span class="keyword">define</span> ft_sfnt_vhea  <a href="ft2-truetype_tables.html#ft_sfnt_vhea">FT_SFNT_VHEA</a>
2055 #<span class="keyword">define</span> ft_sfnt_post  <a href="ft2-truetype_tables.html#ft_sfnt_post">FT_SFNT_POST</a>
2056 #<span class="keyword">define</span> ft_sfnt_pclt  <a href="ft2-truetype_tables.html#ft_sfnt_pclt">FT_SFNT_PCLT</a>
2057 </code></pre></div>
2058
2059 <p>An enumeration to specify indices of SFNT tables loaded and parsed by FreeType during initialization of an SFNT font. Used in the <code><a href="ft2-truetype_tables.html#ft_get_sfnt_table">FT_Get_Sfnt_Table</a></code> API function.</p>
2060 <h4>values</h4>
2061 <table class="fields">
2062 <tr><td class="val" id="ft_sfnt_head">FT_SFNT_HEAD</td><td class="desc">
2063 <p>To access the font's <code><a href="ft2-truetype_tables.html#tt_header">TT_Header</a></code> structure.</p>
2064 </td></tr>
2065 <tr><td class="val" id="ft_sfnt_maxp">FT_SFNT_MAXP</td><td class="desc">
2066 <p>To access the font's <code><a href="ft2-truetype_tables.html#tt_maxprofile">TT_MaxProfile</a></code> structure.</p>
2067 </td></tr>
2068 <tr><td class="val" id="ft_sfnt_os2">FT_SFNT_OS2</td><td class="desc">
2069 <p>To access the font's <code><a href="ft2-truetype_tables.html#tt_os2">TT_OS2</a></code> structure.</p>
2070 </td></tr>
2071 <tr><td class="val" id="ft_sfnt_hhea">FT_SFNT_HHEA</td><td class="desc">
2072 <p>To access the font's <code><a href="ft2-truetype_tables.html#tt_horiheader">TT_HoriHeader</a></code> structure.</p>
2073 </td></tr>
2074 <tr><td class="val" id="ft_sfnt_vhea">FT_SFNT_VHEA</td><td class="desc">
2075 <p>To access the font's <code><a href="ft2-truetype_tables.html#tt_vertheader">TT_VertHeader</a></code> structure.</p>
2076 </td></tr>
2077 <tr><td class="val" id="ft_sfnt_post">FT_SFNT_POST</td><td class="desc">
2078 <p>To access the font's <code><a href="ft2-truetype_tables.html#tt_postscript">TT_Postscript</a></code> structure.</p>
2079 </td></tr>
2080 <tr><td class="val" id="ft_sfnt_pclt">FT_SFNT_PCLT</td><td class="desc">
2081 <p>To access the font's <code><a href="ft2-truetype_tables.html#tt_pclt">TT_PCLT</a></code> structure.</p>
2082 </td></tr>
2083 </table>
2084
2085 <hr>
2086
2087 <h2 id="ft_get_sfnt_table">FT_Get_Sfnt_Table<a class="headerlink" href="#ft_get_sfnt_table" title="Permanent link">&para;</a></h2>
2088 <p>Defined in FT_TRUETYPE_TABLES_H (freetype/tttables.h).</p>
2089 <div class = "codehilite"><pre><code>  FT_EXPORT( <span class="keyword">void</span>* )
2090   <b>FT_Get_Sfnt_Table</b>( <a href="ft2-face_creation.html#ft_face">FT_Face</a>      face,
2091                      <a href="ft2-truetype_tables.html#ft_sfnt_tag">FT_Sfnt_Tag</a>  tag );
2092 </code></pre></div>
2093
2094 <p>Return a pointer to a given SFNT table stored within a face.</p>
2095 <h4>input</h4>
2096 <table class="fields">
2097 <tr><td class="val" id="face">face</td><td class="desc">
2098 <p>A handle to the source.</p>
2099 </td></tr>
2100 <tr><td class="val" id="tag">tag</td><td class="desc">
2101 <p>The index of the SFNT table.</p>
2102 </td></tr>
2103 </table>
2104
2105 <h4>return</h4>
2106
2107 <p>A type-less pointer to the table. This will be <code>NULL</code> in case of error, or if the corresponding table was not found <strong>OR</strong> loaded from the file.</p>
2108 <p>Use a typecast according to <code>tag</code> to access the structure elements.</p>
2109 <h4>note</h4>
2110
2111 <p>The table is owned by the face object and disappears with it.</p>
2112 <p>This function is only useful to access SFNT tables that are loaded by the sfnt, truetype, and opentype drivers. See <code><a href="ft2-truetype_tables.html#ft_sfnt_tag">FT_Sfnt_Tag</a></code> for a list.</p>
2113 <h4>example</h4>
2114
2115 <p>Here is an example demonstrating access to the &lsquo;vhea&rsquo; table.
2116 <div class="highlight"><pre><span></span><code>  TT_VertHeader*  vert_header;
2117
2118
2119   vert_header =
2120     (TT_VertHeader*)FT_Get_Sfnt_Table( face, FT_SFNT_VHEA );
2121 </code></pre></div></p>
2122 <hr>
2123
2124 <h2 id="ft_load_sfnt_table">FT_Load_Sfnt_Table<a class="headerlink" href="#ft_load_sfnt_table" title="Permanent link">&para;</a></h2>
2125 <p>Defined in FT_TRUETYPE_TABLES_H (freetype/tttables.h).</p>
2126 <div class = "codehilite"><pre><code>  FT_EXPORT( <a href="ft2-basic_types.html#ft_error">FT_Error</a> )
2127   <b>FT_Load_Sfnt_Table</b>( <a href="ft2-face_creation.html#ft_face">FT_Face</a>    face,
2128                       <a href="ft2-basic_types.html#ft_ulong">FT_ULong</a>   tag,
2129                       <a href="ft2-basic_types.html#ft_long">FT_Long</a>    offset,
2130                       <a href="ft2-basic_types.html#ft_byte">FT_Byte</a>*   buffer,
2131                       <a href="ft2-basic_types.html#ft_ulong">FT_ULong</a>*  length );
2132 </code></pre></div>
2133
2134 <p>Load any SFNT font table into client memory.</p>
2135 <h4>input</h4>
2136 <table class="fields">
2137 <tr><td class="val" id="face">face</td><td class="desc">
2138 <p>A handle to the source face.</p>
2139 </td></tr>
2140 <tr><td class="val" id="tag">tag</td><td class="desc">
2141 <p>The four-byte tag of the table to load. Use value&nbsp;0 if you want to access the whole font file. Otherwise, you can use one of the definitions found in the <code><a href="ft2-header_file_macros.html#ft_truetype_tags_h">FT_TRUETYPE_TAGS_H</a></code> file, or forge a new one with <code><a href="ft2-basic_types.html#ft_make_tag">FT_MAKE_TAG</a></code>.</p>
2142 </td></tr>
2143 <tr><td class="val" id="offset">offset</td><td class="desc">
2144 <p>The starting offset in the table (or file if tag&nbsp;==&nbsp;0).</p>
2145 </td></tr>
2146 </table>
2147
2148 <h4>output</h4>
2149 <table class="fields">
2150 <tr><td class="val" id="buffer">buffer</td><td class="desc">
2151 <p>The target buffer address. The client must ensure that the memory array is big enough to hold the data.</p>
2152 </td></tr>
2153 </table>
2154
2155 <h4>inout</h4>
2156 <table class="fields">
2157 <tr><td class="val" id="length">length</td><td class="desc">
2158 <p>If the <code>length</code> parameter is <code>NULL</code>, try to load the whole table. Return an error code if it fails.</p>
2159 <p>Else, if <code>*length</code> is&nbsp;0, exit immediately while returning the table's (or file) full size in it.</p>
2160 <p>Else the number of bytes to read from the table or file, from the starting offset.</p>
2161 </td></tr>
2162 </table>
2163
2164 <h4>return</h4>
2165
2166 <p>FreeType error code. 0&nbsp;means success.</p>
2167 <h4>note</h4>
2168
2169 <p>If you need to determine the table's length you should first call this function with <code>*length</code> set to&nbsp;0, as in the following example:
2170 <div class="highlight"><pre><span></span><code>  FT_ULong  length = 0;
2171
2172
2173   error = FT_Load_Sfnt_Table( face, tag, 0, NULL, &amp;length );
2174   if ( error ) { ... table does not exist ... }
2175
2176   buffer = malloc( length );
2177   if ( buffer == NULL ) { ... not enough memory ... }
2178
2179   error = FT_Load_Sfnt_Table( face, tag, 0, buffer, &amp;length );
2180   if ( error ) { ... could not load table ... }
2181 </code></pre></div></p>
2182 <p>Note that structures like <code><a href="ft2-truetype_tables.html#tt_header">TT_Header</a></code> or <code><a href="ft2-truetype_tables.html#tt_os2">TT_OS2</a></code> can't be used with this function; they are limited to <code><a href="ft2-truetype_tables.html#ft_get_sfnt_table">FT_Get_Sfnt_Table</a></code>. Reason is that those structures depend on the processor architecture, with varying size (e.g. 32bit vs. 64bit) or order (big endian vs. little endian).</p>
2183 <hr>
2184
2185 <h2 id="ft_sfnt_table_info">FT_Sfnt_Table_Info<a class="headerlink" href="#ft_sfnt_table_info" title="Permanent link">&para;</a></h2>
2186 <p>Defined in FT_TRUETYPE_TABLES_H (freetype/tttables.h).</p>
2187 <div class = "codehilite"><pre><code>  FT_EXPORT( <a href="ft2-basic_types.html#ft_error">FT_Error</a> )
2188   <b>FT_Sfnt_Table_Info</b>( <a href="ft2-face_creation.html#ft_face">FT_Face</a>    face,
2189                       <a href="ft2-basic_types.html#ft_uint">FT_UInt</a>    table_index,
2190                       <a href="ft2-basic_types.html#ft_ulong">FT_ULong</a>  *tag,
2191                       <a href="ft2-basic_types.html#ft_ulong">FT_ULong</a>  *length );
2192 </code></pre></div>
2193
2194 <p>Return information on an SFNT table.</p>
2195 <h4>input</h4>
2196 <table class="fields">
2197 <tr><td class="val" id="face">face</td><td class="desc">
2198 <p>A handle to the source face.</p>
2199 </td></tr>
2200 <tr><td class="val" id="table_index">table_index</td><td class="desc">
2201 <p>The index of an SFNT table. The function returns FT_Err_Table_Missing for an invalid value.</p>
2202 </td></tr>
2203 </table>
2204
2205 <h4>inout</h4>
2206 <table class="fields">
2207 <tr><td class="val" id="tag">tag</td><td class="desc">
2208 <p>The name tag of the SFNT table. If the value is <code>NULL</code>, <code>table_index</code> is ignored, and <code>length</code> returns the number of SFNT tables in the font.</p>
2209 </td></tr>
2210 </table>
2211
2212 <h4>output</h4>
2213 <table class="fields">
2214 <tr><td class="val" id="length">length</td><td class="desc">
2215 <p>The length of the SFNT table (or the number of SFNT tables, depending on <code>tag</code>).</p>
2216 </td></tr>
2217 </table>
2218
2219 <h4>return</h4>
2220
2221 <p>FreeType error code. 0&nbsp;means success.</p>
2222 <h4>note</h4>
2223
2224 <p>While parsing fonts, FreeType handles SFNT tables with length zero as missing.</p>
2225 <hr>
2226
2227 <h2 id="ft_get_cmap_language_id">FT_Get_CMap_Language_ID<a class="headerlink" href="#ft_get_cmap_language_id" title="Permanent link">&para;</a></h2>
2228 <p>Defined in FT_TRUETYPE_TABLES_H (freetype/tttables.h).</p>
2229 <div class = "codehilite"><pre><code>  FT_EXPORT( <a href="ft2-basic_types.html#ft_ulong">FT_ULong</a> )
2230   <b>FT_Get_CMap_Language_ID</b>( <a href="ft2-character_mapping.html#ft_charmap">FT_CharMap</a>  charmap );
2231 </code></pre></div>
2232
2233 <p>Return cmap language ID as specified in the OpenType standard. Definitions of language ID values are in file <code><a href="ft2-header_file_macros.html#ft_truetype_ids_h">FT_TRUETYPE_IDS_H</a></code>.</p>
2234 <h4>input</h4>
2235 <table class="fields">
2236 <tr><td class="val" id="charmap">charmap</td><td class="desc">
2237 <p>The target charmap.</p>
2238 </td></tr>
2239 </table>
2240
2241 <h4>return</h4>
2242
2243 <p>The language ID of <code>charmap</code>. If <code>charmap</code> doesn't belong to an SFNT face, just return&nbsp;0 as the default value.</p>
2244 <p>For a format&nbsp;14 cmap (to access Unicode IVS), the return value is 0xFFFFFFFF.</p>
2245 <hr>
2246
2247 <h2 id="ft_get_cmap_format">FT_Get_CMap_Format<a class="headerlink" href="#ft_get_cmap_format" title="Permanent link">&para;</a></h2>
2248 <p>Defined in FT_TRUETYPE_TABLES_H (freetype/tttables.h).</p>
2249 <div class = "codehilite"><pre><code>  FT_EXPORT( <a href="ft2-basic_types.html#ft_long">FT_Long</a> )
2250   <b>FT_Get_CMap_Format</b>( <a href="ft2-character_mapping.html#ft_charmap">FT_CharMap</a>  charmap );
2251 </code></pre></div>
2252
2253 <p>Return the format of an SFNT &lsquo;cmap&rsquo; table.</p>
2254 <h4>input</h4>
2255 <table class="fields">
2256 <tr><td class="val" id="charmap">charmap</td><td class="desc">
2257 <p>The target charmap.</p>
2258 </td></tr>
2259 </table>
2260
2261 <h4>return</h4>
2262
2263 <p>The format of <code>charmap</code>. If <code>charmap</code> doesn't belong to an SFNT face, return -1.</p>
2264 <hr>
2265
2266 <h2 id="ft_param_tag_unpatented_hinting">FT_PARAM_TAG_UNPATENTED_HINTING<a class="headerlink" href="#ft_param_tag_unpatented_hinting" title="Permanent link">&para;</a></h2>
2267 <div class = "codehilite"><pre><code>#<span class="keyword">define</span> <b>FT_PARAM_TAG_UNPATENTED_HINTING</b> \
2268           <a href="ft2-basic_types.html#ft_make_tag">FT_MAKE_TAG</a>( 'u', 'n', 'p', 'a' )
2269 </code></pre></div>
2270
2271 <p>Deprecated, no effect.</p>
2272 <p>Previously: A constant used as the tag of an <code><a href="ft2-face_creation.html#ft_parameter">FT_Parameter</a></code> structure to indicate that unpatented methods only should be used by the TrueType bytecode interpreter for a typeface opened by <code><a href="ft2-face_creation.html#ft_open_face">FT_Open_Face</a></code>.</p>
2273 <hr>
2274
2275 <h2 id="tt_platform_xxx">TT_PLATFORM_XXX<a class="headerlink" href="#tt_platform_xxx" title="Permanent link">&para;</a></h2>
2276 <p>Defined in FT_TRUETYPE_IDS_H (freetype/ttnameid.h).</p>
2277 <div class = "codehilite"><pre><code>#<span class="keyword">define</span> <a href="ft2-truetype_tables.html#tt_platform_apple_unicode">TT_PLATFORM_APPLE_UNICODE</a>  0
2278 #<span class="keyword">define</span> <a href="ft2-truetype_tables.html#tt_platform_macintosh">TT_PLATFORM_MACINTOSH</a>      1
2279 #<span class="keyword">define</span> <a href="ft2-truetype_tables.html#tt_platform_iso">TT_PLATFORM_ISO</a>            2 /* deprecated */
2280 #<span class="keyword">define</span> <a href="ft2-truetype_tables.html#tt_platform_microsoft">TT_PLATFORM_MICROSOFT</a>      3
2281 #<span class="keyword">define</span> <a href="ft2-truetype_tables.html#tt_platform_custom">TT_PLATFORM_CUSTOM</a>         4
2282 #<span class="keyword">define</span> <a href="ft2-truetype_tables.html#tt_platform_adobe">TT_PLATFORM_ADOBE</a>          7 /* artificial */
2283 </code></pre></div>
2284
2285 <p>A list of valid values for the <code>platform_id</code> identifier code in <code><a href="ft2-character_mapping.html#ft_charmaprec">FT_CharMapRec</a></code> and <code><a href="ft2-sfnt_names.html#ft_sfntname">FT_SfntName</a></code> structures.</p>
2286 <h4>values</h4>
2287 <table class="fields">
2288 <tr><td class="val" id="tt_platform_apple_unicode">TT_PLATFORM_APPLE_UNICODE</td><td class="desc">
2289 <p>Used by Apple to indicate a Unicode character map and/or name entry. See <code><a href="ft2-truetype_tables.html#tt_apple_id_xxx">TT_APPLE_ID_XXX</a></code> for corresponding <code>encoding_id</code> values. Note that name entries in this format are coded as big-endian UCS-2 character codes <em>only</em>.</p>
2290 </td></tr>
2291 <tr><td class="val" id="tt_platform_macintosh">TT_PLATFORM_MACINTOSH</td><td class="desc">
2292 <p>Used by Apple to indicate a MacOS-specific charmap and/or name entry. See <code><a href="ft2-truetype_tables.html#tt_mac_id_xxx">TT_MAC_ID_XXX</a></code> for corresponding <code>encoding_id</code> values. Note that most TrueType fonts contain an Apple roman charmap to be usable on MacOS systems (even if they contain a Microsoft charmap as well).</p>
2293 </td></tr>
2294 <tr><td class="val" id="tt_platform_iso">TT_PLATFORM_ISO</td><td class="desc">
2295 <p>This value was used to specify ISO/IEC 10646 charmaps. It is however now deprecated. See <code><a href="ft2-truetype_tables.html#tt_iso_id_xxx">TT_ISO_ID_XXX</a></code> for a list of corresponding <code>encoding_id</code> values.</p>
2296 </td></tr>
2297 <tr><td class="val" id="tt_platform_microsoft">TT_PLATFORM_MICROSOFT</td><td class="desc">
2298 <p>Used by Microsoft to indicate Windows-specific charmaps. See <code><a href="ft2-truetype_tables.html#tt_ms_id_xxx">TT_MS_ID_XXX</a></code> for a list of corresponding <code>encoding_id</code> values. Note that most fonts contain a Unicode charmap using (<code>TT_PLATFORM_MICROSOFT</code>, <code><a href="ft2-truetype_tables.html#tt_ms_id_xxx">TT_MS_ID_UNICODE_CS</a></code>).</p>
2299 </td></tr>
2300 <tr><td class="val" id="tt_platform_custom">TT_PLATFORM_CUSTOM</td><td class="desc">
2301 <p>Used to indicate application-specific charmaps.</p>
2302 </td></tr>
2303 <tr><td class="val" id="tt_platform_adobe">TT_PLATFORM_ADOBE</td><td class="desc">
2304 <p>This value isn't part of any font format specification, but is used by FreeType to report Adobe-specific charmaps in an <code><a href="ft2-character_mapping.html#ft_charmaprec">FT_CharMapRec</a></code> structure. See <code><a href="ft2-truetype_tables.html#tt_adobe_id_xxx">TT_ADOBE_ID_XXX</a></code>.</p>
2305 </td></tr>
2306 </table>
2307
2308 <hr>
2309
2310 <h2 id="tt_apple_id_xxx">TT_APPLE_ID_XXX<a class="headerlink" href="#tt_apple_id_xxx" title="Permanent link">&para;</a></h2>
2311 <p>Defined in FT_TRUETYPE_IDS_H (freetype/ttnameid.h).</p>
2312 <div class = "codehilite"><pre><code>#<span class="keyword">define</span> <a href="ft2-truetype_tables.html#tt_apple_id_default">TT_APPLE_ID_DEFAULT</a>           0 /* Unicode 1.0                   */
2313 #<span class="keyword">define</span> <a href="ft2-truetype_tables.html#tt_apple_id_unicode_1_1">TT_APPLE_ID_UNICODE_1_1</a>       1 /* specify Hangul at U+34xx      */
2314 #<span class="keyword">define</span> <a href="ft2-truetype_tables.html#tt_apple_id_iso_10646">TT_APPLE_ID_ISO_10646</a>         2 /* deprecated                    */
2315 #<span class="keyword">define</span> <a href="ft2-truetype_tables.html#tt_apple_id_unicode_2_0">TT_APPLE_ID_UNICODE_2_0</a>       3 /* or later                      */
2316 #<span class="keyword">define</span> <a href="ft2-truetype_tables.html#tt_apple_id_unicode_32">TT_APPLE_ID_UNICODE_32</a>        4 /* 2.0 or later, full repertoire */
2317 #<span class="keyword">define</span> <a href="ft2-truetype_tables.html#tt_apple_id_variant_selector">TT_APPLE_ID_VARIANT_SELECTOR</a>  5 /* variation selector data       */
2318 #<span class="keyword">define</span> <a href="ft2-truetype_tables.html#tt_apple_id_full_unicode">TT_APPLE_ID_FULL_UNICODE</a>      6 /* used with type 13 cmaps       */
2319 </code></pre></div>
2320
2321 <p>A list of valid values for the <code>encoding_id</code> for <code><a href="ft2-truetype_tables.html#tt_platform_xxx">TT_PLATFORM_APPLE_UNICODE</a></code> charmaps and name entries.</p>
2322 <h4>values</h4>
2323 <table class="fields long">
2324 <tr><td class="val" id="tt_apple_id_default">TT_APPLE_ID_DEFAULT</td><td class="desc">
2325 <p>Unicode version 1.0.</p>
2326 </td></tr>
2327 <tr><td class="val" id="tt_apple_id_unicode_1_1">TT_APPLE_ID_UNICODE_1_1</td><td class="desc">
2328 <p>Unicode 1.1; specifies Hangul characters starting at U+34xx.</p>
2329 </td></tr>
2330 <tr><td class="val" id="tt_apple_id_iso_10646">TT_APPLE_ID_ISO_10646</td><td class="desc">
2331 <p>Deprecated (identical to preceding).</p>
2332 </td></tr>
2333 <tr><td class="val" id="tt_apple_id_unicode_2_0">TT_APPLE_ID_UNICODE_2_0</td><td class="desc">
2334 <p>Unicode 2.0 and beyond (UTF-16 BMP only).</p>
2335 </td></tr>
2336 <tr><td class="val" id="tt_apple_id_unicode_32">TT_APPLE_ID_UNICODE_32</td><td class="desc">
2337 <p>Unicode 3.1 and beyond, using UTF-32.</p>
2338 </td></tr>
2339 <tr><td class="val" id="tt_apple_id_variant_selector">TT_APPLE_ID_VARIANT_SELECTOR</td><td class="desc">
2340 <p>From Adobe, not Apple. Not a normal cmap. Specifies variations on a real cmap.</p>
2341 </td></tr>
2342 <tr><td class="val" id="tt_apple_id_full_unicode">TT_APPLE_ID_FULL_UNICODE</td><td class="desc">
2343 <p>Used for fallback fonts that provide complete Unicode coverage with a type&nbsp;13 cmap.</p>
2344 </td></tr>
2345 </table>
2346
2347 <hr>
2348
2349 <h2 id="tt_mac_id_xxx">TT_MAC_ID_XXX<a class="headerlink" href="#tt_mac_id_xxx" title="Permanent link">&para;</a></h2>
2350 <p>Defined in FT_TRUETYPE_IDS_H (freetype/ttnameid.h).</p>
2351 <div class = "codehilite"><pre><code>#<span class="keyword">define</span> TT_MAC_ID_ROMAN                 0
2352 #<span class="keyword">define</span> TT_MAC_ID_JAPANESE              1
2353 #<span class="keyword">define</span> TT_MAC_ID_TRADITIONAL_CHINESE   2
2354 #<span class="keyword">define</span> TT_MAC_ID_KOREAN                3
2355 #<span class="keyword">define</span> TT_MAC_ID_ARABIC                4
2356 #<span class="keyword">define</span> TT_MAC_ID_HEBREW                5
2357 #<span class="keyword">define</span> TT_MAC_ID_GREEK                 6
2358 #<span class="keyword">define</span> TT_MAC_ID_RUSSIAN               7
2359 #<span class="keyword">define</span> TT_MAC_ID_RSYMBOL               8
2360 #<span class="keyword">define</span> TT_MAC_ID_DEVANAGARI            9
2361 #<span class="keyword">define</span> TT_MAC_ID_GURMUKHI             10
2362 #<span class="keyword">define</span> TT_MAC_ID_GUJARATI             11
2363 #<span class="keyword">define</span> TT_MAC_ID_ORIYA                12
2364 #<span class="keyword">define</span> TT_MAC_ID_BENGALI              13
2365 #<span class="keyword">define</span> TT_MAC_ID_TAMIL                14
2366 #<span class="keyword">define</span> TT_MAC_ID_TELUGU               15
2367 #<span class="keyword">define</span> TT_MAC_ID_KANNADA              16
2368 #<span class="keyword">define</span> TT_MAC_ID_MALAYALAM            17
2369 #<span class="keyword">define</span> TT_MAC_ID_SINHALESE            18
2370 #<span class="keyword">define</span> TT_MAC_ID_BURMESE              19
2371 #<span class="keyword">define</span> TT_MAC_ID_KHMER                20
2372 #<span class="keyword">define</span> TT_MAC_ID_THAI                 21
2373 #<span class="keyword">define</span> TT_MAC_ID_LAOTIAN              22
2374 #<span class="keyword">define</span> TT_MAC_ID_GEORGIAN             23
2375 #<span class="keyword">define</span> TT_MAC_ID_ARMENIAN             24
2376 #<span class="keyword">define</span> TT_MAC_ID_MALDIVIAN            25
2377 #<span class="keyword">define</span> TT_MAC_ID_SIMPLIFIED_CHINESE   25
2378 #<span class="keyword">define</span> TT_MAC_ID_TIBETAN              26
2379 #<span class="keyword">define</span> TT_MAC_ID_MONGOLIAN            27
2380 #<span class="keyword">define</span> TT_MAC_ID_GEEZ                 28
2381 #<span class="keyword">define</span> TT_MAC_ID_SLAVIC               29
2382 #<span class="keyword">define</span> TT_MAC_ID_VIETNAMESE           30
2383 #<span class="keyword">define</span> TT_MAC_ID_SINDHI               31
2384 #<span class="keyword">define</span> TT_MAC_ID_UNINTERP             32
2385 </code></pre></div>
2386
2387 <p>A list of valid values for the <code>encoding_id</code> for <code><a href="ft2-truetype_tables.html#tt_platform_xxx">TT_PLATFORM_MACINTOSH</a></code> charmaps and name entries.</p>
2388 <hr>
2389
2390 <h2 id="tt_iso_id_xxx">TT_ISO_ID_XXX<a class="headerlink" href="#tt_iso_id_xxx" title="Permanent link">&para;</a></h2>
2391 <p>Defined in FT_TRUETYPE_IDS_H (freetype/ttnameid.h).</p>
2392 <div class = "codehilite"><pre><code>#<span class="keyword">define</span> <a href="ft2-truetype_tables.html#tt_iso_id_7bit_ascii">TT_ISO_ID_7BIT_ASCII</a>  0
2393 #<span class="keyword">define</span> <a href="ft2-truetype_tables.html#tt_iso_id_10646">TT_ISO_ID_10646</a>       1
2394 #<span class="keyword">define</span> <a href="ft2-truetype_tables.html#tt_iso_id_8859_1">TT_ISO_ID_8859_1</a>      2
2395 </code></pre></div>
2396
2397 <p>A list of valid values for the <code>encoding_id</code> for <code><a href="ft2-truetype_tables.html#tt_platform_xxx">TT_PLATFORM_ISO</a></code> charmaps and name entries.</p>
2398 <p>Their use is now deprecated.</p>
2399 <h4>values</h4>
2400 <table class="fields">
2401 <tr><td class="val" id="tt_iso_id_7bit_ascii">TT_ISO_ID_7BIT_ASCII</td><td class="desc">
2402 <p>ASCII.</p>
2403 </td></tr>
2404 <tr><td class="val" id="tt_iso_id_10646">TT_ISO_ID_10646</td><td class="desc">
2405 <p>ISO/10646.</p>
2406 </td></tr>
2407 <tr><td class="val" id="tt_iso_id_8859_1">TT_ISO_ID_8859_1</td><td class="desc">
2408 <p>Also known as Latin-1.</p>
2409 </td></tr>
2410 </table>
2411
2412 <hr>
2413
2414 <h2 id="tt_ms_id_xxx">TT_MS_ID_XXX<a class="headerlink" href="#tt_ms_id_xxx" title="Permanent link">&para;</a></h2>
2415 <p>Defined in FT_TRUETYPE_IDS_H (freetype/ttnameid.h).</p>
2416 <div class = "codehilite"><pre><code>#<span class="keyword">define</span> <a href="ft2-truetype_tables.html#tt_ms_id_symbol_cs">TT_MS_ID_SYMBOL_CS</a>    0
2417 #<span class="keyword">define</span> <a href="ft2-truetype_tables.html#tt_ms_id_unicode_cs">TT_MS_ID_UNICODE_CS</a>   1
2418 #<span class="keyword">define</span> <a href="ft2-truetype_tables.html#tt_ms_id_sjis">TT_MS_ID_SJIS</a>         2
2419 #<span class="keyword">define</span> <a href="ft2-truetype_tables.html#tt_ms_id_prc">TT_MS_ID_PRC</a>          3
2420 #<span class="keyword">define</span> <a href="ft2-truetype_tables.html#tt_ms_id_big_5">TT_MS_ID_BIG_5</a>        4
2421 #<span class="keyword">define</span> <a href="ft2-truetype_tables.html#tt_ms_id_wansung">TT_MS_ID_WANSUNG</a>      5
2422 #<span class="keyword">define</span> <a href="ft2-truetype_tables.html#tt_ms_id_johab">TT_MS_ID_JOHAB</a>        6
2423 #<span class="keyword">define</span> <a href="ft2-truetype_tables.html#tt_ms_id_ucs_4">TT_MS_ID_UCS_4</a>       10
2424
2425   /* this value is deprecated */
2426 #<span class="keyword">define</span> TT_MS_ID_GB2312  <a href="ft2-truetype_tables.html#tt_ms_id_prc">TT_MS_ID_PRC</a>
2427 </code></pre></div>
2428
2429 <p>A list of valid values for the <code>encoding_id</code> for <code><a href="ft2-truetype_tables.html#tt_platform_xxx">TT_PLATFORM_MICROSOFT</a></code> charmaps and name entries.</p>
2430 <h4>values</h4>
2431 <table class="fields">
2432 <tr><td class="val" id="tt_ms_id_symbol_cs">TT_MS_ID_SYMBOL_CS</td><td class="desc">
2433 <p>Microsoft symbol encoding. See <code><a href="ft2-character_mapping.html#ft_encoding">FT_ENCODING_MS_SYMBOL</a></code>.</p>
2434 </td></tr>
2435 <tr><td class="val" id="tt_ms_id_unicode_cs">TT_MS_ID_UNICODE_CS</td><td class="desc">
2436 <p>Microsoft WGL4 charmap, matching Unicode. See <code><a href="ft2-character_mapping.html#ft_encoding">FT_ENCODING_UNICODE</a></code>.</p>
2437 </td></tr>
2438 <tr><td class="val" id="tt_ms_id_sjis">TT_MS_ID_SJIS</td><td class="desc">
2439 <p>Shift JIS Japanese encoding. See <code><a href="ft2-character_mapping.html#ft_encoding">FT_ENCODING_SJIS</a></code>.</p>
2440 </td></tr>
2441 <tr><td class="val" id="tt_ms_id_prc">TT_MS_ID_PRC</td><td class="desc">
2442 <p>Chinese encodings as used in the People's Republic of China (PRC). This means the encodings GB&nbsp;2312 and its supersets GBK and GB&nbsp;18030. See <code><a href="ft2-character_mapping.html#ft_encoding">FT_ENCODING_PRC</a></code>.</p>
2443 </td></tr>
2444 <tr><td class="val" id="tt_ms_id_big_5">TT_MS_ID_BIG_5</td><td class="desc">
2445 <p>Traditional Chinese as used in Taiwan and Hong Kong. See <code><a href="ft2-character_mapping.html#ft_encoding">FT_ENCODING_BIG5</a></code>.</p>
2446 </td></tr>
2447 <tr><td class="val" id="tt_ms_id_wansung">TT_MS_ID_WANSUNG</td><td class="desc">
2448 <p>Korean Extended Wansung encoding. See <code><a href="ft2-character_mapping.html#ft_encoding">FT_ENCODING_WANSUNG</a></code>.</p>
2449 </td></tr>
2450 <tr><td class="val" id="tt_ms_id_johab">TT_MS_ID_JOHAB</td><td class="desc">
2451 <p>Korean Johab encoding. See <code><a href="ft2-character_mapping.html#ft_encoding">FT_ENCODING_JOHAB</a></code>.</p>
2452 </td></tr>
2453 <tr><td class="val" id="tt_ms_id_ucs_4">TT_MS_ID_UCS_4</td><td class="desc">
2454 <p>UCS-4 or UTF-32 charmaps. This has been added to the OpenType specification version 1.4 (mid-2001).</p>
2455 </td></tr>
2456 </table>
2457
2458 <hr>
2459
2460 <h2 id="tt_adobe_id_xxx">TT_ADOBE_ID_XXX<a class="headerlink" href="#tt_adobe_id_xxx" title="Permanent link">&para;</a></h2>
2461 <p>Defined in FT_TRUETYPE_IDS_H (freetype/ttnameid.h).</p>
2462 <div class = "codehilite"><pre><code>#<span class="keyword">define</span> <a href="ft2-truetype_tables.html#tt_adobe_id_standard">TT_ADOBE_ID_STANDARD</a>  0
2463 #<span class="keyword">define</span> <a href="ft2-truetype_tables.html#tt_adobe_id_expert">TT_ADOBE_ID_EXPERT</a>    1
2464 #<span class="keyword">define</span> <a href="ft2-truetype_tables.html#tt_adobe_id_custom">TT_ADOBE_ID_CUSTOM</a>    2
2465 #<span class="keyword">define</span> <a href="ft2-truetype_tables.html#tt_adobe_id_latin_1">TT_ADOBE_ID_LATIN_1</a>   3
2466 </code></pre></div>
2467
2468 <p>A list of valid values for the <code>encoding_id</code> for <code><a href="ft2-truetype_tables.html#tt_platform_xxx">TT_PLATFORM_ADOBE</a></code> charmaps. This is a FreeType-specific extension!</p>
2469 <h4>values</h4>
2470 <table class="fields">
2471 <tr><td class="val" id="tt_adobe_id_standard">TT_ADOBE_ID_STANDARD</td><td class="desc">
2472 <p>Adobe standard encoding.</p>
2473 </td></tr>
2474 <tr><td class="val" id="tt_adobe_id_expert">TT_ADOBE_ID_EXPERT</td><td class="desc">
2475 <p>Adobe expert encoding.</p>
2476 </td></tr>
2477 <tr><td class="val" id="tt_adobe_id_custom">TT_ADOBE_ID_CUSTOM</td><td class="desc">
2478 <p>Adobe custom encoding.</p>
2479 </td></tr>
2480 <tr><td class="val" id="tt_adobe_id_latin_1">TT_ADOBE_ID_LATIN_1</td><td class="desc">
2481 <p>Adobe Latin&nbsp;1 encoding.</p>
2482 </td></tr>
2483 </table>
2484
2485 <hr>
2486
2487 <h2 id="tt_mac_langid_xxx">TT_MAC_LANGID_XXX<a class="headerlink" href="#tt_mac_langid_xxx" title="Permanent link">&para;</a></h2>
2488 <p>Defined in FT_TRUETYPE_IDS_H (freetype/ttnameid.h).</p>
2489 <div class = "codehilite"><pre><code>#<span class="keyword">define</span> TT_MAC_LANGID_ENGLISH                       0
2490 #<span class="keyword">define</span> TT_MAC_LANGID_FRENCH                        1
2491 #<span class="keyword">define</span> TT_MAC_LANGID_GERMAN                        2
2492 #<span class="keyword">define</span> TT_MAC_LANGID_ITALIAN                       3
2493 #<span class="keyword">define</span> TT_MAC_LANGID_DUTCH                         4
2494 #<span class="keyword">define</span> TT_MAC_LANGID_SWEDISH                       5
2495 #<span class="keyword">define</span> TT_MAC_LANGID_SPANISH                       6
2496 #<span class="keyword">define</span> TT_MAC_LANGID_DANISH                        7
2497 #<span class="keyword">define</span> TT_MAC_LANGID_PORTUGUESE                    8
2498 #<span class="keyword">define</span> TT_MAC_LANGID_NORWEGIAN                     9
2499 #<span class="keyword">define</span> TT_MAC_LANGID_HEBREW                       10
2500 #<span class="keyword">define</span> TT_MAC_LANGID_JAPANESE                     11
2501 #<span class="keyword">define</span> TT_MAC_LANGID_ARABIC                       12
2502 #<span class="keyword">define</span> TT_MAC_LANGID_FINNISH                      13
2503 #<span class="keyword">define</span> TT_MAC_LANGID_GREEK                        14
2504 #<span class="keyword">define</span> TT_MAC_LANGID_ICELANDIC                    15
2505 #<span class="keyword">define</span> TT_MAC_LANGID_MALTESE                      16
2506 #<span class="keyword">define</span> TT_MAC_LANGID_TURKISH                      17
2507 #<span class="keyword">define</span> TT_MAC_LANGID_CROATIAN                     18
2508 #<span class="keyword">define</span> TT_MAC_LANGID_CHINESE_TRADITIONAL          19
2509 #<span class="keyword">define</span> TT_MAC_LANGID_URDU                         20
2510 #<span class="keyword">define</span> TT_MAC_LANGID_HINDI                        21
2511 #<span class="keyword">define</span> TT_MAC_LANGID_THAI                         22
2512 #<span class="keyword">define</span> TT_MAC_LANGID_KOREAN                       23
2513 #<span class="keyword">define</span> TT_MAC_LANGID_LITHUANIAN                   24
2514 #<span class="keyword">define</span> TT_MAC_LANGID_POLISH                       25
2515 #<span class="keyword">define</span> TT_MAC_LANGID_HUNGARIAN                    26
2516 #<span class="keyword">define</span> TT_MAC_LANGID_ESTONIAN                     27
2517 #<span class="keyword">define</span> TT_MAC_LANGID_LETTISH                      28
2518 #<span class="keyword">define</span> TT_MAC_LANGID_SAAMISK                      29
2519 #<span class="keyword">define</span> TT_MAC_LANGID_FAEROESE                     30
2520 #<span class="keyword">define</span> TT_MAC_LANGID_FARSI                        31
2521 #<span class="keyword">define</span> TT_MAC_LANGID_RUSSIAN                      32
2522 #<span class="keyword">define</span> TT_MAC_LANGID_CHINESE_SIMPLIFIED           33
2523 #<span class="keyword">define</span> TT_MAC_LANGID_FLEMISH                      34
2524 #<span class="keyword">define</span> TT_MAC_LANGID_IRISH                        35
2525 #<span class="keyword">define</span> TT_MAC_LANGID_ALBANIAN                     36
2526 #<span class="keyword">define</span> TT_MAC_LANGID_ROMANIAN                     37
2527 #<span class="keyword">define</span> TT_MAC_LANGID_CZECH                        38
2528 #<span class="keyword">define</span> TT_MAC_LANGID_SLOVAK                       39
2529 #<span class="keyword">define</span> TT_MAC_LANGID_SLOVENIAN                    40
2530 #<span class="keyword">define</span> TT_MAC_LANGID_YIDDISH                      41
2531 #<span class="keyword">define</span> TT_MAC_LANGID_SERBIAN                      42
2532 #<span class="keyword">define</span> TT_MAC_LANGID_MACEDONIAN                   43
2533 #<span class="keyword">define</span> TT_MAC_LANGID_BULGARIAN                    44
2534 #<span class="keyword">define</span> TT_MAC_LANGID_UKRAINIAN                    45
2535 #<span class="keyword">define</span> TT_MAC_LANGID_BYELORUSSIAN                 46
2536 #<span class="keyword">define</span> TT_MAC_LANGID_UZBEK                        47
2537 #<span class="keyword">define</span> TT_MAC_LANGID_KAZAKH                       48
2538 #<span class="keyword">define</span> TT_MAC_LANGID_AZERBAIJANI                  49
2539 #<span class="keyword">define</span> TT_MAC_LANGID_AZERBAIJANI_CYRILLIC_SCRIPT  49
2540 #<span class="keyword">define</span> TT_MAC_LANGID_AZERBAIJANI_ARABIC_SCRIPT    50
2541 #<span class="keyword">define</span> TT_MAC_LANGID_ARMENIAN                     51
2542 #<span class="keyword">define</span> TT_MAC_LANGID_GEORGIAN                     52
2543 #<span class="keyword">define</span> TT_MAC_LANGID_MOLDAVIAN                    53
2544 #<span class="keyword">define</span> TT_MAC_LANGID_KIRGHIZ                      54
2545 #<span class="keyword">define</span> TT_MAC_LANGID_TAJIKI                       55
2546 #<span class="keyword">define</span> TT_MAC_LANGID_TURKMEN                      56
2547 #<span class="keyword">define</span> TT_MAC_LANGID_MONGOLIAN                    57
2548 #<span class="keyword">define</span> TT_MAC_LANGID_MONGOLIAN_MONGOLIAN_SCRIPT   57
2549 #<span class="keyword">define</span> TT_MAC_LANGID_MONGOLIAN_CYRILLIC_SCRIPT    58
2550 #<span class="keyword">define</span> TT_MAC_LANGID_PASHTO                       59
2551 #<span class="keyword">define</span> TT_MAC_LANGID_KURDISH                      60
2552 #<span class="keyword">define</span> TT_MAC_LANGID_KASHMIRI                     61
2553 #<span class="keyword">define</span> TT_MAC_LANGID_SINDHI                       62
2554 #<span class="keyword">define</span> TT_MAC_LANGID_TIBETAN                      63
2555 #<span class="keyword">define</span> TT_MAC_LANGID_NEPALI                       64
2556 #<span class="keyword">define</span> TT_MAC_LANGID_SANSKRIT                     65
2557 #<span class="keyword">define</span> TT_MAC_LANGID_MARATHI                      66
2558 #<span class="keyword">define</span> TT_MAC_LANGID_BENGALI                      67
2559 #<span class="keyword">define</span> TT_MAC_LANGID_ASSAMESE                     68
2560 #<span class="keyword">define</span> TT_MAC_LANGID_GUJARATI                     69
2561 #<span class="keyword">define</span> TT_MAC_LANGID_PUNJABI                      70
2562 #<span class="keyword">define</span> TT_MAC_LANGID_ORIYA                        71
2563 #<span class="keyword">define</span> TT_MAC_LANGID_MALAYALAM                    72
2564 #<span class="keyword">define</span> TT_MAC_LANGID_KANNADA                      73
2565 #<span class="keyword">define</span> TT_MAC_LANGID_TAMIL                        74
2566 #<span class="keyword">define</span> TT_MAC_LANGID_TELUGU                       75
2567 #<span class="keyword">define</span> TT_MAC_LANGID_SINHALESE                    76
2568 #<span class="keyword">define</span> TT_MAC_LANGID_BURMESE                      77
2569 #<span class="keyword">define</span> TT_MAC_LANGID_KHMER                        78
2570 #<span class="keyword">define</span> TT_MAC_LANGID_LAO                          79
2571 #<span class="keyword">define</span> TT_MAC_LANGID_VIETNAMESE                   80
2572 #<span class="keyword">define</span> TT_MAC_LANGID_INDONESIAN                   81
2573 #<span class="keyword">define</span> TT_MAC_LANGID_TAGALOG                      82
2574 #<span class="keyword">define</span> TT_MAC_LANGID_MALAY_ROMAN_SCRIPT           83
2575 #<span class="keyword">define</span> TT_MAC_LANGID_MALAY_ARABIC_SCRIPT          84
2576 #<span class="keyword">define</span> TT_MAC_LANGID_AMHARIC                      85
2577 #<span class="keyword">define</span> TT_MAC_LANGID_TIGRINYA                     86
2578 #<span class="keyword">define</span> TT_MAC_LANGID_GALLA                        87
2579 #<span class="keyword">define</span> TT_MAC_LANGID_SOMALI                       88
2580 #<span class="keyword">define</span> TT_MAC_LANGID_SWAHILI                      89
2581 #<span class="keyword">define</span> TT_MAC_LANGID_RUANDA                       90
2582 #<span class="keyword">define</span> TT_MAC_LANGID_RUNDI                        91
2583 #<span class="keyword">define</span> TT_MAC_LANGID_CHEWA                        92
2584 #<span class="keyword">define</span> TT_MAC_LANGID_MALAGASY                     93
2585 #<span class="keyword">define</span> TT_MAC_LANGID_ESPERANTO                    94
2586 #<span class="keyword">define</span> TT_MAC_LANGID_WELSH                       128
2587 #<span class="keyword">define</span> TT_MAC_LANGID_BASQUE                      129
2588 #<span class="keyword">define</span> TT_MAC_LANGID_CATALAN                     130
2589 #<span class="keyword">define</span> TT_MAC_LANGID_LATIN                       131
2590 #<span class="keyword">define</span> TT_MAC_LANGID_QUECHUA                     132
2591 #<span class="keyword">define</span> TT_MAC_LANGID_GUARANI                     133
2592 #<span class="keyword">define</span> TT_MAC_LANGID_AYMARA                      134
2593 #<span class="keyword">define</span> TT_MAC_LANGID_TATAR                       135
2594 #<span class="keyword">define</span> TT_MAC_LANGID_UIGHUR                      136
2595 #<span class="keyword">define</span> TT_MAC_LANGID_DZONGKHA                    137
2596 #<span class="keyword">define</span> TT_MAC_LANGID_JAVANESE                    138
2597 #<span class="keyword">define</span> TT_MAC_LANGID_SUNDANESE                   139
2598
2599   /* The following codes are new as of 2000-03-10 */
2600 #<span class="keyword">define</span> TT_MAC_LANGID_GALICIAN                    140
2601 #<span class="keyword">define</span> TT_MAC_LANGID_AFRIKAANS                   141
2602 #<span class="keyword">define</span> TT_MAC_LANGID_BRETON                      142
2603 #<span class="keyword">define</span> TT_MAC_LANGID_INUKTITUT                   143
2604 #<span class="keyword">define</span> TT_MAC_LANGID_SCOTTISH_GAELIC             144
2605 #<span class="keyword">define</span> TT_MAC_LANGID_MANX_GAELIC                 145
2606 #<span class="keyword">define</span> TT_MAC_LANGID_IRISH_GAELIC                146
2607 #<span class="keyword">define</span> TT_MAC_LANGID_TONGAN                      147
2608 #<span class="keyword">define</span> TT_MAC_LANGID_GREEK_POLYTONIC             148
2609 #<span class="keyword">define</span> TT_MAC_LANGID_GREELANDIC                  149
2610 #<span class="keyword">define</span> TT_MAC_LANGID_AZERBAIJANI_ROMAN_SCRIPT    150
2611 </code></pre></div>
2612
2613 <p>Possible values of the language identifier field in the name records of the SFNT &lsquo;name&rsquo; table if the &lsquo;platform&rsquo; identifier code is <code><a href="ft2-truetype_tables.html#tt_platform_xxx">TT_PLATFORM_MACINTOSH</a></code>. These values are also used as return values for function <code><a href="ft2-truetype_tables.html#ft_get_cmap_language_id">FT_Get_CMap_Language_ID</a></code>.</p>
2614 <p>The canonical source for Apple's IDs is</p>
2615 <p><a href="https://developer.apple.com/fonts/TrueType-Reference-Manual/RM06/Chap6name.html">https://developer.apple.com/fonts/TrueType-Reference-Manual/RM06/Chap6name.html</a></p>
2616 <hr>
2617
2618 <h2 id="tt_ms_langid_xxx">TT_MS_LANGID_XXX<a class="headerlink" href="#tt_ms_langid_xxx" title="Permanent link">&para;</a></h2>
2619 <p>Defined in FT_TRUETYPE_IDS_H (freetype/ttnameid.h).</p>
2620 <div class = "codehilite"><pre><code>#<span class="keyword">define</span> TT_MS_LANGID_ARABIC_SAUDI_ARABIA               0x0401
2621 #<span class="keyword">define</span> TT_MS_LANGID_ARABIC_IRAQ                       0x0801
2622 #<span class="keyword">define</span> TT_MS_LANGID_ARABIC_EGYPT                      0x0C01
2623 #<span class="keyword">define</span> TT_MS_LANGID_ARABIC_LIBYA                      0x1001
2624 #<span class="keyword">define</span> TT_MS_LANGID_ARABIC_ALGERIA                    0x1401
2625 #<span class="keyword">define</span> TT_MS_LANGID_ARABIC_MOROCCO                    0x1801
2626 #<span class="keyword">define</span> TT_MS_LANGID_ARABIC_TUNISIA                    0x1C01
2627 #<span class="keyword">define</span> TT_MS_LANGID_ARABIC_OMAN                       0x2001
2628 #<span class="keyword">define</span> TT_MS_LANGID_ARABIC_YEMEN                      0x2401
2629 #<span class="keyword">define</span> TT_MS_LANGID_ARABIC_SYRIA                      0x2801
2630 #<span class="keyword">define</span> TT_MS_LANGID_ARABIC_JORDAN                     0x2C01
2631 #<span class="keyword">define</span> TT_MS_LANGID_ARABIC_LEBANON                    0x3001
2632 #<span class="keyword">define</span> TT_MS_LANGID_ARABIC_KUWAIT                     0x3401
2633 #<span class="keyword">define</span> TT_MS_LANGID_ARABIC_UAE                        0x3801
2634 #<span class="keyword">define</span> TT_MS_LANGID_ARABIC_BAHRAIN                    0x3C01
2635 #<span class="keyword">define</span> TT_MS_LANGID_ARABIC_QATAR                      0x4001
2636 #<span class="keyword">define</span> TT_MS_LANGID_BULGARIAN_BULGARIA                0x0402
2637 #<span class="keyword">define</span> TT_MS_LANGID_CATALAN_CATALAN                   0x0403
2638 #<span class="keyword">define</span> TT_MS_LANGID_CHINESE_TAIWAN                    0x0404
2639 #<span class="keyword">define</span> TT_MS_LANGID_CHINESE_PRC                       0x0804
2640 #<span class="keyword">define</span> TT_MS_LANGID_CHINESE_HONG_KONG                 0x0C04
2641 #<span class="keyword">define</span> TT_MS_LANGID_CHINESE_SINGAPORE                 0x1004
2642 #<span class="keyword">define</span> TT_MS_LANGID_CHINESE_MACAO                     0x1404
2643 #<span class="keyword">define</span> TT_MS_LANGID_CZECH_CZECH_REPUBLIC              0x0405
2644 #<span class="keyword">define</span> TT_MS_LANGID_DANISH_DENMARK                    0x0406
2645 #<span class="keyword">define</span> TT_MS_LANGID_GERMAN_GERMANY                    0x0407
2646 #<span class="keyword">define</span> TT_MS_LANGID_GERMAN_SWITZERLAND                0x0807
2647 #<span class="keyword">define</span> TT_MS_LANGID_GERMAN_AUSTRIA                    0x0C07
2648 #<span class="keyword">define</span> TT_MS_LANGID_GERMAN_LUXEMBOURG                 0x1007
2649 #<span class="keyword">define</span> TT_MS_LANGID_GERMAN_LIECHTENSTEIN              0x1407
2650 #<span class="keyword">define</span> TT_MS_LANGID_GREEK_GREECE                      0x0408
2651 #<span class="keyword">define</span> TT_MS_LANGID_ENGLISH_UNITED_STATES             0x0409
2652 #<span class="keyword">define</span> TT_MS_LANGID_ENGLISH_UNITED_KINGDOM            0x0809
2653 #<span class="keyword">define</span> TT_MS_LANGID_ENGLISH_AUSTRALIA                 0x0C09
2654 #<span class="keyword">define</span> TT_MS_LANGID_ENGLISH_CANADA                    0x1009
2655 #<span class="keyword">define</span> TT_MS_LANGID_ENGLISH_NEW_ZEALAND               0x1409
2656 #<span class="keyword">define</span> TT_MS_LANGID_ENGLISH_IRELAND                   0x1809
2657 #<span class="keyword">define</span> TT_MS_LANGID_ENGLISH_SOUTH_AFRICA              0x1C09
2658 #<span class="keyword">define</span> TT_MS_LANGID_ENGLISH_JAMAICA                   0x2009
2659 #<span class="keyword">define</span> TT_MS_LANGID_ENGLISH_CARIBBEAN                 0x2409
2660 #<span class="keyword">define</span> TT_MS_LANGID_ENGLISH_BELIZE                    0x2809
2661 #<span class="keyword">define</span> TT_MS_LANGID_ENGLISH_TRINIDAD                  0x2C09
2662 #<span class="keyword">define</span> TT_MS_LANGID_ENGLISH_ZIMBABWE                  0x3009
2663 #<span class="keyword">define</span> TT_MS_LANGID_ENGLISH_PHILIPPINES               0x3409
2664 #<span class="keyword">define</span> TT_MS_LANGID_ENGLISH_INDIA                     0x4009
2665 #<span class="keyword">define</span> TT_MS_LANGID_ENGLISH_MALAYSIA                  0x4409
2666 #<span class="keyword">define</span> TT_MS_LANGID_ENGLISH_SINGAPORE                 0x4809
2667 #<span class="keyword">define</span> TT_MS_LANGID_SPANISH_SPAIN_TRADITIONAL_SORT    0x040A
2668 #<span class="keyword">define</span> TT_MS_LANGID_SPANISH_MEXICO                    0x080A
2669 #<span class="keyword">define</span> TT_MS_LANGID_SPANISH_SPAIN_MODERN_SORT         0x0C0A
2670 #<span class="keyword">define</span> TT_MS_LANGID_SPANISH_GUATEMALA                 0x100A
2671 #<span class="keyword">define</span> TT_MS_LANGID_SPANISH_COSTA_RICA                0x140A
2672 #<span class="keyword">define</span> TT_MS_LANGID_SPANISH_PANAMA                    0x180A
2673 #<span class="keyword">define</span> TT_MS_LANGID_SPANISH_DOMINICAN_REPUBLIC        0x1C0A
2674 #<span class="keyword">define</span> TT_MS_LANGID_SPANISH_VENEZUELA                 0x200A
2675 #<span class="keyword">define</span> TT_MS_LANGID_SPANISH_COLOMBIA                  0x240A
2676 #<span class="keyword">define</span> TT_MS_LANGID_SPANISH_PERU                      0x280A
2677 #<span class="keyword">define</span> TT_MS_LANGID_SPANISH_ARGENTINA                 0x2C0A
2678 #<span class="keyword">define</span> TT_MS_LANGID_SPANISH_ECUADOR                   0x300A
2679 #<span class="keyword">define</span> TT_MS_LANGID_SPANISH_CHILE                     0x340A
2680 #<span class="keyword">define</span> TT_MS_LANGID_SPANISH_URUGUAY                   0x380A
2681 #<span class="keyword">define</span> TT_MS_LANGID_SPANISH_PARAGUAY                  0x3C0A
2682 #<span class="keyword">define</span> TT_MS_LANGID_SPANISH_BOLIVIA                   0x400A
2683 #<span class="keyword">define</span> TT_MS_LANGID_SPANISH_EL_SALVADOR               0x440A
2684 #<span class="keyword">define</span> TT_MS_LANGID_SPANISH_HONDURAS                  0x480A
2685 #<span class="keyword">define</span> TT_MS_LANGID_SPANISH_NICARAGUA                 0x4C0A
2686 #<span class="keyword">define</span> TT_MS_LANGID_SPANISH_PUERTO_RICO               0x500A
2687 #<span class="keyword">define</span> TT_MS_LANGID_SPANISH_UNITED_STATES             0x540A
2688 #<span class="keyword">define</span> TT_MS_LANGID_FINNISH_FINLAND                   0x040B
2689 #<span class="keyword">define</span> TT_MS_LANGID_FRENCH_FRANCE                     0x040C
2690 #<span class="keyword">define</span> TT_MS_LANGID_FRENCH_BELGIUM                    0x080C
2691 #<span class="keyword">define</span> TT_MS_LANGID_FRENCH_CANADA                     0x0C0C
2692 #<span class="keyword">define</span> TT_MS_LANGID_FRENCH_SWITZERLAND                0x100C
2693 #<span class="keyword">define</span> TT_MS_LANGID_FRENCH_LUXEMBOURG                 0x140C
2694 #<span class="keyword">define</span> TT_MS_LANGID_FRENCH_MONACO                     0x180C
2695 #<span class="keyword">define</span> TT_MS_LANGID_HEBREW_ISRAEL                     0x040D
2696 #<span class="keyword">define</span> TT_MS_LANGID_HUNGARIAN_HUNGARY                 0x040E
2697 #<span class="keyword">define</span> TT_MS_LANGID_ICELANDIC_ICELAND                 0x040F
2698 #<span class="keyword">define</span> TT_MS_LANGID_ITALIAN_ITALY                     0x0410
2699 #<span class="keyword">define</span> TT_MS_LANGID_ITALIAN_SWITZERLAND               0x0810
2700 #<span class="keyword">define</span> TT_MS_LANGID_JAPANESE_JAPAN                    0x0411
2701 #<span class="keyword">define</span> TT_MS_LANGID_KOREAN_KOREA                      0x0412
2702 #<span class="keyword">define</span> TT_MS_LANGID_DUTCH_NETHERLANDS                 0x0413
2703 #<span class="keyword">define</span> TT_MS_LANGID_DUTCH_BELGIUM                     0x0813
2704 #<span class="keyword">define</span> TT_MS_LANGID_NORWEGIAN_NORWAY_BOKMAL           0x0414
2705 #<span class="keyword">define</span> TT_MS_LANGID_NORWEGIAN_NORWAY_NYNORSK          0x0814
2706 #<span class="keyword">define</span> TT_MS_LANGID_POLISH_POLAND                     0x0415
2707 #<span class="keyword">define</span> TT_MS_LANGID_PORTUGUESE_BRAZIL                 0x0416
2708 #<span class="keyword">define</span> TT_MS_LANGID_PORTUGUESE_PORTUGAL               0x0816
2709 #<span class="keyword">define</span> TT_MS_LANGID_ROMANSH_SWITZERLAND               0x0417
2710 #<span class="keyword">define</span> TT_MS_LANGID_ROMANIAN_ROMANIA                  0x0418
2711 #<span class="keyword">define</span> TT_MS_LANGID_RUSSIAN_RUSSIA                    0x0419
2712 #<span class="keyword">define</span> TT_MS_LANGID_CROATIAN_CROATIA                  0x041A
2713 #<span class="keyword">define</span> TT_MS_LANGID_SERBIAN_SERBIA_LATIN              0x081A
2714 #<span class="keyword">define</span> TT_MS_LANGID_SERBIAN_SERBIA_CYRILLIC           0x0C1A
2715 #<span class="keyword">define</span> TT_MS_LANGID_CROATIAN_BOSNIA_HERZEGOVINA       0x101A
2716 #<span class="keyword">define</span> TT_MS_LANGID_BOSNIAN_BOSNIA_HERZEGOVINA        0x141A
2717 #<span class="keyword">define</span> TT_MS_LANGID_SERBIAN_BOSNIA_HERZ_LATIN         0x181A
2718 #<span class="keyword">define</span> TT_MS_LANGID_SERBIAN_BOSNIA_HERZ_CYRILLIC      0x1C1A
2719 #<span class="keyword">define</span> TT_MS_LANGID_BOSNIAN_BOSNIA_HERZ_CYRILLIC      0x201A
2720 #<span class="keyword">define</span> TT_MS_LANGID_SLOVAK_SLOVAKIA                   0x041B
2721 #<span class="keyword">define</span> TT_MS_LANGID_ALBANIAN_ALBANIA                  0x041C
2722 #<span class="keyword">define</span> TT_MS_LANGID_SWEDISH_SWEDEN                    0x041D
2723 #<span class="keyword">define</span> TT_MS_LANGID_SWEDISH_FINLAND                   0x081D
2724 #<span class="keyword">define</span> TT_MS_LANGID_THAI_THAILAND                     0x041E
2725 #<span class="keyword">define</span> TT_MS_LANGID_TURKISH_TURKEY                    0x041F
2726 #<span class="keyword">define</span> TT_MS_LANGID_URDU_PAKISTAN                     0x0420
2727 #<span class="keyword">define</span> TT_MS_LANGID_INDONESIAN_INDONESIA              0x0421
2728 #<span class="keyword">define</span> TT_MS_LANGID_UKRAINIAN_UKRAINE                 0x0422
2729 #<span class="keyword">define</span> TT_MS_LANGID_BELARUSIAN_BELARUS                0x0423
2730 #<span class="keyword">define</span> TT_MS_LANGID_SLOVENIAN_SLOVENIA                0x0424
2731 #<span class="keyword">define</span> TT_MS_LANGID_ESTONIAN_ESTONIA                  0x0425
2732 #<span class="keyword">define</span> TT_MS_LANGID_LATVIAN_LATVIA                    0x0426
2733 #<span class="keyword">define</span> TT_MS_LANGID_LITHUANIAN_LITHUANIA              0x0427
2734 #<span class="keyword">define</span> TT_MS_LANGID_TAJIK_TAJIKISTAN                  0x0428
2735 #<span class="keyword">define</span> TT_MS_LANGID_VIETNAMESE_VIET_NAM               0x042A
2736 #<span class="keyword">define</span> TT_MS_LANGID_ARMENIAN_ARMENIA                  0x042B
2737 #<span class="keyword">define</span> TT_MS_LANGID_AZERI_AZERBAIJAN_LATIN            0x042C
2738 #<span class="keyword">define</span> TT_MS_LANGID_AZERI_AZERBAIJAN_CYRILLIC         0x082C
2739 #<span class="keyword">define</span> TT_MS_LANGID_BASQUE_BASQUE                     0x042D
2740 #<span class="keyword">define</span> TT_MS_LANGID_UPPER_SORBIAN_GERMANY             0x042E
2741 #<span class="keyword">define</span> TT_MS_LANGID_LOWER_SORBIAN_GERMANY             0x082E
2742 #<span class="keyword">define</span> TT_MS_LANGID_MACEDONIAN_MACEDONIA              0x042F
2743 #<span class="keyword">define</span> TT_MS_LANGID_SETSWANA_SOUTH_AFRICA             0x0432
2744 #<span class="keyword">define</span> TT_MS_LANGID_ISIXHOSA_SOUTH_AFRICA             0x0434
2745 #<span class="keyword">define</span> TT_MS_LANGID_ISIZULU_SOUTH_AFRICA              0x0435
2746 #<span class="keyword">define</span> TT_MS_LANGID_AFRIKAANS_SOUTH_AFRICA            0x0436
2747 #<span class="keyword">define</span> TT_MS_LANGID_GEORGIAN_GEORGIA                  0x0437
2748 #<span class="keyword">define</span> TT_MS_LANGID_FAEROESE_FAEROE_ISLANDS           0x0438
2749 #<span class="keyword">define</span> TT_MS_LANGID_HINDI_INDIA                       0x0439
2750 #<span class="keyword">define</span> TT_MS_LANGID_MALTESE_MALTA                     0x043A
2751 #<span class="keyword">define</span> TT_MS_LANGID_SAMI_NORTHERN_NORWAY              0x043B
2752 #<span class="keyword">define</span> TT_MS_LANGID_SAMI_NORTHERN_SWEDEN              0x083B
2753 #<span class="keyword">define</span> TT_MS_LANGID_SAMI_NORTHERN_FINLAND             0x0C3B
2754 #<span class="keyword">define</span> TT_MS_LANGID_SAMI_LULE_NORWAY                  0x103B
2755 #<span class="keyword">define</span> TT_MS_LANGID_SAMI_LULE_SWEDEN                  0x143B
2756 #<span class="keyword">define</span> TT_MS_LANGID_SAMI_SOUTHERN_NORWAY              0x183B
2757 #<span class="keyword">define</span> TT_MS_LANGID_SAMI_SOUTHERN_SWEDEN              0x1C3B
2758 #<span class="keyword">define</span> TT_MS_LANGID_SAMI_SKOLT_FINLAND                0x203B
2759 #<span class="keyword">define</span> TT_MS_LANGID_SAMI_INARI_FINLAND                0x243B
2760 #<span class="keyword">define</span> TT_MS_LANGID_IRISH_IRELAND                     0x083C
2761 #<span class="keyword">define</span> TT_MS_LANGID_MALAY_MALAYSIA                    0x043E
2762 #<span class="keyword">define</span> TT_MS_LANGID_MALAY_BRUNEI_DARUSSALAM           0x083E
2763 #<span class="keyword">define</span> TT_MS_LANGID_KAZAKH_KAZAKHSTAN                 0x043F
2764 #<span class="keyword">define</span> TT_MS_LANGID_KYRGYZ_KYRGYZSTAN /* Cyrillic */  0x0440
2765 #<span class="keyword">define</span> TT_MS_LANGID_KISWAHILI_KENYA                   0x0441
2766 #<span class="keyword">define</span> TT_MS_LANGID_TURKMEN_TURKMENISTAN              0x0442
2767 #<span class="keyword">define</span> TT_MS_LANGID_UZBEK_UZBEKISTAN_LATIN            0x0443
2768 #<span class="keyword">define</span> TT_MS_LANGID_UZBEK_UZBEKISTAN_CYRILLIC         0x0843
2769 #<span class="keyword">define</span> TT_MS_LANGID_TATAR_RUSSIA                      0x0444
2770 #<span class="keyword">define</span> TT_MS_LANGID_BENGALI_INDIA                     0x0445
2771 #<span class="keyword">define</span> TT_MS_LANGID_BENGALI_BANGLADESH                0x0845
2772 #<span class="keyword">define</span> TT_MS_LANGID_PUNJABI_INDIA                     0x0446
2773 #<span class="keyword">define</span> TT_MS_LANGID_GUJARATI_INDIA                    0x0447
2774 #<span class="keyword">define</span> TT_MS_LANGID_ODIA_INDIA                        0x0448
2775 #<span class="keyword">define</span> TT_MS_LANGID_TAMIL_INDIA                       0x0449
2776 #<span class="keyword">define</span> TT_MS_LANGID_TELUGU_INDIA                      0x044A
2777 #<span class="keyword">define</span> TT_MS_LANGID_KANNADA_INDIA                     0x044B
2778 #<span class="keyword">define</span> TT_MS_LANGID_MALAYALAM_INDIA                   0x044C
2779 #<span class="keyword">define</span> TT_MS_LANGID_ASSAMESE_INDIA                    0x044D
2780 #<span class="keyword">define</span> TT_MS_LANGID_MARATHI_INDIA                     0x044E
2781 #<span class="keyword">define</span> TT_MS_LANGID_SANSKRIT_INDIA                    0x044F
2782 #<span class="keyword">define</span> TT_MS_LANGID_MONGOLIAN_MONGOLIA /* Cyrillic */ 0x0450
2783 #<span class="keyword">define</span> TT_MS_LANGID_MONGOLIAN_PRC                     0x0850
2784 #<span class="keyword">define</span> TT_MS_LANGID_TIBETAN_PRC                       0x0451
2785 #<span class="keyword">define</span> TT_MS_LANGID_WELSH_UNITED_KINGDOM              0x0452
2786 #<span class="keyword">define</span> TT_MS_LANGID_KHMER_CAMBODIA                    0x0453
2787 #<span class="keyword">define</span> TT_MS_LANGID_LAO_LAOS                          0x0454
2788 #<span class="keyword">define</span> TT_MS_LANGID_GALICIAN_GALICIAN                 0x0456
2789 #<span class="keyword">define</span> TT_MS_LANGID_KONKANI_INDIA                     0x0457
2790 #<span class="keyword">define</span> TT_MS_LANGID_SYRIAC_SYRIA                      0x045A
2791 #<span class="keyword">define</span> TT_MS_LANGID_SINHALA_SRI_LANKA                 0x045B
2792 #<span class="keyword">define</span> TT_MS_LANGID_INUKTITUT_CANADA                  0x045D
2793 #<span class="keyword">define</span> TT_MS_LANGID_INUKTITUT_CANADA_LATIN            0x085D
2794 #<span class="keyword">define</span> TT_MS_LANGID_AMHARIC_ETHIOPIA                  0x045E
2795 #<span class="keyword">define</span> TT_MS_LANGID_TAMAZIGHT_ALGERIA                 0x085F
2796 #<span class="keyword">define</span> TT_MS_LANGID_NEPALI_NEPAL                      0x0461
2797 #<span class="keyword">define</span> TT_MS_LANGID_FRISIAN_NETHERLANDS               0x0462
2798 #<span class="keyword">define</span> TT_MS_LANGID_PASHTO_AFGHANISTAN                0x0463
2799 #<span class="keyword">define</span> TT_MS_LANGID_FILIPINO_PHILIPPINES              0x0464
2800 #<span class="keyword">define</span> TT_MS_LANGID_DHIVEHI_MALDIVES                  0x0465
2801 #<span class="keyword">define</span> TT_MS_LANGID_HAUSA_NIGERIA                     0x0468
2802 #<span class="keyword">define</span> TT_MS_LANGID_YORUBA_NIGERIA                    0x046A
2803 #<span class="keyword">define</span> TT_MS_LANGID_QUECHUA_BOLIVIA                   0x046B
2804 #<span class="keyword">define</span> TT_MS_LANGID_QUECHUA_ECUADOR                   0x086B
2805 #<span class="keyword">define</span> TT_MS_LANGID_QUECHUA_PERU                      0x0C6B
2806 #<span class="keyword">define</span> TT_MS_LANGID_SESOTHO_SA_LEBOA_SOUTH_AFRICA     0x046C
2807 #<span class="keyword">define</span> TT_MS_LANGID_BASHKIR_RUSSIA                    0x046D
2808 #<span class="keyword">define</span> TT_MS_LANGID_LUXEMBOURGISH_LUXEMBOURG          0x046E
2809 #<span class="keyword">define</span> TT_MS_LANGID_GREENLANDIC_GREENLAND             0x046F
2810 #<span class="keyword">define</span> TT_MS_LANGID_IGBO_NIGERIA                      0x0470
2811 #<span class="keyword">define</span> TT_MS_LANGID_YI_PRC                            0x0478
2812 #<span class="keyword">define</span> TT_MS_LANGID_MAPUDUNGUN_CHILE                  0x047A
2813 #<span class="keyword">define</span> TT_MS_LANGID_MOHAWK_MOHAWK                     0x047C
2814 #<span class="keyword">define</span> TT_MS_LANGID_BRETON_FRANCE                     0x047E
2815 #<span class="keyword">define</span> TT_MS_LANGID_UIGHUR_PRC                        0x0480
2816 #<span class="keyword">define</span> TT_MS_LANGID_MAORI_NEW_ZEALAND                 0x0481
2817 #<span class="keyword">define</span> TT_MS_LANGID_OCCITAN_FRANCE                    0x0482
2818 #<span class="keyword">define</span> TT_MS_LANGID_CORSICAN_FRANCE                   0x0483
2819 #<span class="keyword">define</span> TT_MS_LANGID_ALSATIAN_FRANCE                   0x0484
2820 #<span class="keyword">define</span> TT_MS_LANGID_YAKUT_RUSSIA                      0x0485
2821 #<span class="keyword">define</span> TT_MS_LANGID_KICHE_GUATEMALA                   0x0486
2822 #<span class="keyword">define</span> TT_MS_LANGID_KINYARWANDA_RWANDA                0x0487
2823 #<span class="keyword">define</span> TT_MS_LANGID_WOLOF_SENEGAL                     0x0488
2824 #<span class="keyword">define</span> TT_MS_LANGID_DARI_AFGHANISTAN                  0x048C
2825 </code></pre></div>
2826
2827 <p>Possible values of the language identifier field in the name records of the SFNT &lsquo;name&rsquo; table if the &lsquo;platform&rsquo; identifier code is <code><a href="ft2-truetype_tables.html#tt_platform_xxx">TT_PLATFORM_MICROSOFT</a></code>. These values are also used as return values for function <code><a href="ft2-truetype_tables.html#ft_get_cmap_language_id">FT_Get_CMap_Language_ID</a></code>.</p>
2828 <p>The canonical source for Microsoft's IDs is</p>
2829 <p><a href="https://docs.microsoft.com/en-us/windows/desktop/Intl/language-identifier-constants-and-strings">https://docs.microsoft.com/en-us/windows/desktop/Intl/language-identifier-constants-and-strings</a> ,</p>
2830 <p>however, we only provide macros for language identifiers present in the OpenType specification: Microsoft has abandoned the concept of LCIDs (language code identifiers), and format&nbsp;1 of the &lsquo;name&rsquo; table provides a better mechanism for languages not covered here.</p>
2831 <p>More legacy values not listed in the reference can be found in the <code><a href="ft2-header_file_macros.html#ft_truetype_ids_h">FT_TRUETYPE_IDS_H</a></code> header file.</p>
2832 <hr>
2833
2834 <h2 id="tt_name_id_xxx">TT_NAME_ID_XXX<a class="headerlink" href="#tt_name_id_xxx" title="Permanent link">&para;</a></h2>
2835 <p>Defined in FT_TRUETYPE_IDS_H (freetype/ttnameid.h).</p>
2836 <div class = "codehilite"><pre><code>#<span class="keyword">define</span> TT_NAME_ID_COPYRIGHT              0
2837 #<span class="keyword">define</span> TT_NAME_ID_FONT_FAMILY            1
2838 #<span class="keyword">define</span> TT_NAME_ID_FONT_SUBFAMILY         2
2839 #<span class="keyword">define</span> TT_NAME_ID_UNIQUE_ID              3
2840 #<span class="keyword">define</span> TT_NAME_ID_FULL_NAME              4
2841 #<span class="keyword">define</span> TT_NAME_ID_VERSION_STRING         5
2842 #<span class="keyword">define</span> TT_NAME_ID_PS_NAME                6
2843 #<span class="keyword">define</span> TT_NAME_ID_TRADEMARK              7
2844
2845   /* the following values are from the OpenType spec */
2846 #<span class="keyword">define</span> TT_NAME_ID_MANUFACTURER           8
2847 #<span class="keyword">define</span> TT_NAME_ID_DESIGNER               9
2848 #<span class="keyword">define</span> TT_NAME_ID_DESCRIPTION            10
2849 #<span class="keyword">define</span> TT_NAME_ID_VENDOR_URL             11
2850 #<span class="keyword">define</span> TT_NAME_ID_DESIGNER_URL           12
2851 #<span class="keyword">define</span> TT_NAME_ID_LICENSE                13
2852 #<span class="keyword">define</span> TT_NAME_ID_LICENSE_URL            14
2853   /* number 15 is reserved */
2854 #<span class="keyword">define</span> TT_NAME_ID_TYPOGRAPHIC_FAMILY     16
2855 #<span class="keyword">define</span> TT_NAME_ID_TYPOGRAPHIC_SUBFAMILY  17
2856 #<span class="keyword">define</span> TT_NAME_ID_MAC_FULL_NAME          18
2857
2858   /* The following code is new as of 2000-01-21 */
2859 #<span class="keyword">define</span> TT_NAME_ID_SAMPLE_TEXT            19
2860
2861   /* This is new in OpenType 1.3 */
2862 #<span class="keyword">define</span> TT_NAME_ID_CID_FINDFONT_NAME      20
2863
2864   /* This is new in OpenType 1.5 */
2865 #<span class="keyword">define</span> TT_NAME_ID_WWS_FAMILY             21
2866 #<span class="keyword">define</span> TT_NAME_ID_WWS_SUBFAMILY          22
2867
2868   /* This is new in OpenType 1.7 */
2869 #<span class="keyword">define</span> TT_NAME_ID_LIGHT_BACKGROUND       23
2870 #<span class="keyword">define</span> TT_NAME_ID_DARK_BACKGROUND        24
2871
2872   /* This is new in OpenType 1.8 */
2873 #<span class="keyword">define</span> TT_NAME_ID_VARIATIONS_PREFIX      25
2874
2875   /* these two values are deprecated */
2876 #<span class="keyword">define</span> TT_NAME_ID_PREFERRED_FAMILY     TT_NAME_ID_TYPOGRAPHIC_FAMILY
2877 #<span class="keyword">define</span> TT_NAME_ID_PREFERRED_SUBFAMILY  TT_NAME_ID_TYPOGRAPHIC_SUBFAMILY
2878 </code></pre></div>
2879
2880 <p>Possible values of the &lsquo;name&rsquo; identifier field in the name records of an SFNT &lsquo;name&rsquo; table. These values are platform independent.</p>
2881 <hr>
2882
2883 <h2 id="tt_ucr_xxx">TT_UCR_XXX<a class="headerlink" href="#tt_ucr_xxx" title="Permanent link">&para;</a></h2>
2884 <p>Defined in FT_TRUETYPE_IDS_H (freetype/ttnameid.h).</p>
2885 <div class = "codehilite"><pre><code>  /* ulUnicodeRange1 */
2886   /* --------------- */
2887
2888   /* Bit  0   Basic Latin */
2889 #<span class="keyword">define</span> TT_UCR_BASIC_LATIN                     (1L &lt;&lt;  0) /* U+0020-U+007E */
2890   /* Bit  1   C1 Controls and Latin-1 Supplement */
2891 #<span class="keyword">define</span> TT_UCR_LATIN1_SUPPLEMENT               (1L &lt;&lt;  1) /* U+0080-U+00FF */
2892   /* Bit  2   Latin Extended-A */
2893 #<span class="keyword">define</span> TT_UCR_LATIN_EXTENDED_A                (1L &lt;&lt;  2) /* U+0100-U+017F */
2894   /* Bit  3   Latin Extended-B */
2895 #<span class="keyword">define</span> TT_UCR_LATIN_EXTENDED_B                (1L &lt;&lt;  3) /* U+0180-U+024F */
2896   /* Bit  4   IPA Extensions                 */
2897   /*          Phonetic Extensions            */
2898   /*          Phonetic Extensions Supplement */
2899 #<span class="keyword">define</span> TT_UCR_IPA_EXTENSIONS                  (1L &lt;&lt;  4) /* U+0250-U+02AF */
2900                                                           /* U+1D00-U+1D7F */
2901                                                           /* U+1D80-U+1DBF */
2902   /* Bit  5   Spacing Modifier Letters */
2903   /*          Modifier Tone Letters    */
2904 #<span class="keyword">define</span> TT_UCR_SPACING_MODIFIER                (1L &lt;&lt;  5) /* U+02B0-U+02FF */
2905                                                           /* U+A700-U+A71F */
2906   /* Bit  6   Combining Diacritical Marks            */
2907   /*          Combining Diacritical Marks Supplement */
2908 #<span class="keyword">define</span> TT_UCR_COMBINING_DIACRITICAL_MARKS     (1L &lt;&lt;  6) /* U+0300-U+036F */
2909                                                           /* U+1DC0-U+1DFF */
2910   /* Bit  7   Greek and Coptic */
2911 #<span class="keyword">define</span> TT_UCR_GREEK                           (1L &lt;&lt;  7) /* U+0370-U+03FF */
2912   /* Bit  8   Coptic */
2913 #<span class="keyword">define</span> TT_UCR_COPTIC                          (1L &lt;&lt;  8) /* U+2C80-U+2CFF */
2914   /* Bit  9   Cyrillic            */
2915   /*          Cyrillic Supplement */
2916   /*          Cyrillic Extended-A */
2917   /*          Cyrillic Extended-B */
2918 #<span class="keyword">define</span> TT_UCR_CYRILLIC                        (1L &lt;&lt;  9) /* U+0400-U+04FF */
2919                                                           /* U+0500-U+052F */
2920                                                           /* U+2DE0-U+2DFF */
2921                                                           /* U+A640-U+A69F */
2922   /* Bit 10   Armenian */
2923 #<span class="keyword">define</span> TT_UCR_ARMENIAN                        (1L &lt;&lt; 10) /* U+0530-U+058F */
2924   /* Bit 11   Hebrew */
2925 #<span class="keyword">define</span> TT_UCR_HEBREW                          (1L &lt;&lt; 11) /* U+0590-U+05FF */
2926   /* Bit 12   Vai */
2927 #<span class="keyword">define</span> TT_UCR_VAI                             (1L &lt;&lt; 12) /* U+A500-U+A63F */
2928   /* Bit 13   Arabic            */
2929   /*          Arabic Supplement */
2930 #<span class="keyword">define</span> TT_UCR_ARABIC                          (1L &lt;&lt; 13) /* U+0600-U+06FF */
2931                                                           /* U+0750-U+077F */
2932   /* Bit 14   NKo */
2933 #<span class="keyword">define</span> TT_UCR_NKO                             (1L &lt;&lt; 14) /* U+07C0-U+07FF */
2934   /* Bit 15   Devanagari */
2935 #<span class="keyword">define</span> TT_UCR_DEVANAGARI                      (1L &lt;&lt; 15) /* U+0900-U+097F */
2936   /* Bit 16   Bengali */
2937 #<span class="keyword">define</span> TT_UCR_BENGALI                         (1L &lt;&lt; 16) /* U+0980-U+09FF */
2938   /* Bit 17   Gurmukhi */
2939 #<span class="keyword">define</span> TT_UCR_GURMUKHI                        (1L &lt;&lt; 17) /* U+0A00-U+0A7F */
2940   /* Bit 18   Gujarati */
2941 #<span class="keyword">define</span> TT_UCR_GUJARATI                        (1L &lt;&lt; 18) /* U+0A80-U+0AFF */
2942   /* Bit 19   Oriya */
2943 #<span class="keyword">define</span> TT_UCR_ORIYA                           (1L &lt;&lt; 19) /* U+0B00-U+0B7F */
2944   /* Bit 20   Tamil */
2945 #<span class="keyword">define</span> TT_UCR_TAMIL                           (1L &lt;&lt; 20) /* U+0B80-U+0BFF */
2946   /* Bit 21   Telugu */
2947 #<span class="keyword">define</span> TT_UCR_TELUGU                          (1L &lt;&lt; 21) /* U+0C00-U+0C7F */
2948   /* Bit 22   Kannada */
2949 #<span class="keyword">define</span> TT_UCR_KANNADA                         (1L &lt;&lt; 22) /* U+0C80-U+0CFF */
2950   /* Bit 23   Malayalam */
2951 #<span class="keyword">define</span> TT_UCR_MALAYALAM                       (1L &lt;&lt; 23) /* U+0D00-U+0D7F */
2952   /* Bit 24   Thai */
2953 #<span class="keyword">define</span> TT_UCR_THAI                            (1L &lt;&lt; 24) /* U+0E00-U+0E7F */
2954   /* Bit 25   Lao */
2955 #<span class="keyword">define</span> TT_UCR_LAO                             (1L &lt;&lt; 25) /* U+0E80-U+0EFF */
2956   /* Bit 26   Georgian            */
2957   /*          Georgian Supplement */
2958 #<span class="keyword">define</span> TT_UCR_GEORGIAN                        (1L &lt;&lt; 26) /* U+10A0-U+10FF */
2959                                                           /* U+2D00-U+2D2F */
2960   /* Bit 27   Balinese */
2961 #<span class="keyword">define</span> TT_UCR_BALINESE                        (1L &lt;&lt; 27) /* U+1B00-U+1B7F */
2962   /* Bit 28   Hangul Jamo */
2963 #<span class="keyword">define</span> TT_UCR_HANGUL_JAMO                     (1L &lt;&lt; 28) /* U+1100-U+11FF */
2964   /* Bit 29   Latin Extended Additional */
2965   /*          Latin Extended-C          */
2966   /*          Latin Extended-D          */
2967 #<span class="keyword">define</span> TT_UCR_LATIN_EXTENDED_ADDITIONAL       (1L &lt;&lt; 29) /* U+1E00-U+1EFF */
2968                                                           /* U+2C60-U+2C7F */
2969                                                           /* U+A720-U+A7FF */
2970   /* Bit 30   Greek Extended */
2971 #<span class="keyword">define</span> TT_UCR_GREEK_EXTENDED                  (1L &lt;&lt; 30) /* U+1F00-U+1FFF */
2972   /* Bit 31   General Punctuation      */
2973   /*          Supplemental Punctuation */
2974 #<span class="keyword">define</span> TT_UCR_GENERAL_PUNCTUATION             (1L &lt;&lt; 31) /* U+2000-U+206F */
2975                                                           /* U+2E00-U+2E7F */
2976
2977   /* ulUnicodeRange2 */
2978   /* --------------- */
2979
2980   /* Bit 32   Superscripts And Subscripts */
2981 #<span class="keyword">define</span> TT_UCR_SUPERSCRIPTS_SUBSCRIPTS         (1L &lt;&lt;  0) /* U+2070-U+209F */
2982   /* Bit 33   Currency Symbols */
2983 #<span class="keyword">define</span> TT_UCR_CURRENCY_SYMBOLS                (1L &lt;&lt;  1) /* U+20A0-U+20CF */
2984   /* Bit 34   Combining Diacritical Marks For Symbols */
2985 #<span class="keyword">define</span> TT_UCR_COMBINING_DIACRITICAL_MARKS_SYMB \
2986                                                (1L &lt;&lt;  2) /* U+20D0-U+20FF */
2987   /* Bit 35   Letterlike Symbols */
2988 #<span class="keyword">define</span> TT_UCR_LETTERLIKE_SYMBOLS              (1L &lt;&lt;  3) /* U+2100-U+214F */
2989   /* Bit 36   Number Forms */
2990 #<span class="keyword">define</span> TT_UCR_NUMBER_FORMS                    (1L &lt;&lt;  4) /* U+2150-U+218F */
2991   /* Bit 37   Arrows                           */
2992   /*          Supplemental Arrows-A            */
2993   /*          Supplemental Arrows-B            */
2994   /*          Miscellaneous Symbols and Arrows */
2995 #<span class="keyword">define</span> TT_UCR_ARROWS                          (1L &lt;&lt;  5) /* U+2190-U+21FF */
2996                                                           /* U+27F0-U+27FF */
2997                                                           /* U+2900-U+297F */
2998                                                           /* U+2B00-U+2BFF */
2999   /* Bit 38   Mathematical Operators               */
3000   /*          Supplemental Mathematical Operators  */
3001   /*          Miscellaneous Mathematical Symbols-A */
3002   /*          Miscellaneous Mathematical Symbols-B */
3003 #<span class="keyword">define</span> TT_UCR_MATHEMATICAL_OPERATORS          (1L &lt;&lt;  6) /* U+2200-U+22FF */
3004                                                           /* U+2A00-U+2AFF */
3005                                                           /* U+27C0-U+27EF */
3006                                                           /* U+2980-U+29FF */
3007   /* Bit 39 Miscellaneous Technical */
3008 #<span class="keyword">define</span> TT_UCR_MISCELLANEOUS_TECHNICAL         (1L &lt;&lt;  7) /* U+2300-U+23FF */
3009   /* Bit 40   Control Pictures */
3010 #<span class="keyword">define</span> TT_UCR_CONTROL_PICTURES                (1L &lt;&lt;  8) /* U+2400-U+243F */
3011   /* Bit 41   Optical Character Recognition */
3012 #<span class="keyword">define</span> TT_UCR_OCR                             (1L &lt;&lt;  9) /* U+2440-U+245F */
3013   /* Bit 42   Enclosed Alphanumerics */
3014 #<span class="keyword">define</span> TT_UCR_ENCLOSED_ALPHANUMERICS          (1L &lt;&lt; 10) /* U+2460-U+24FF */
3015   /* Bit 43   Box Drawing */
3016 #<span class="keyword">define</span> TT_UCR_BOX_DRAWING                     (1L &lt;&lt; 11) /* U+2500-U+257F */
3017   /* Bit 44   Block Elements */
3018 #<span class="keyword">define</span> TT_UCR_BLOCK_ELEMENTS                  (1L &lt;&lt; 12) /* U+2580-U+259F */
3019   /* Bit 45   Geometric Shapes */
3020 #<span class="keyword">define</span> TT_UCR_GEOMETRIC_SHAPES                (1L &lt;&lt; 13) /* U+25A0-U+25FF */
3021   /* Bit 46   Miscellaneous Symbols */
3022 #<span class="keyword">define</span> TT_UCR_MISCELLANEOUS_SYMBOLS           (1L &lt;&lt; 14) /* U+2600-U+26FF */
3023   /* Bit 47   Dingbats */
3024 #<span class="keyword">define</span> TT_UCR_DINGBATS                        (1L &lt;&lt; 15) /* U+2700-U+27BF */
3025   /* Bit 48   CJK Symbols and Punctuation */
3026 #<span class="keyword">define</span> TT_UCR_CJK_SYMBOLS                     (1L &lt;&lt; 16) /* U+3000-U+303F */
3027   /* Bit 49   Hiragana */
3028 #<span class="keyword">define</span> TT_UCR_HIRAGANA                        (1L &lt;&lt; 17) /* U+3040-U+309F */
3029   /* Bit 50   Katakana                     */
3030   /*          Katakana Phonetic Extensions */
3031 #<span class="keyword">define</span> TT_UCR_KATAKANA                        (1L &lt;&lt; 18) /* U+30A0-U+30FF */
3032                                                           /* U+31F0-U+31FF */
3033   /* Bit 51   Bopomofo          */
3034   /*          Bopomofo Extended */
3035 #<span class="keyword">define</span> TT_UCR_BOPOMOFO                        (1L &lt;&lt; 19) /* U+3100-U+312F */
3036                                                           /* U+31A0-U+31BF */
3037   /* Bit 52   Hangul Compatibility Jamo */
3038 #<span class="keyword">define</span> TT_UCR_HANGUL_COMPATIBILITY_JAMO       (1L &lt;&lt; 20) /* U+3130-U+318F */
3039   /* Bit 53   Phags-Pa */
3040 #<span class="keyword">define</span> TT_UCR_CJK_MISC                        (1L &lt;&lt; 21) /* U+A840-U+A87F */
3041 #<span class="keyword">define</span> TT_UCR_KANBUN  TT_UCR_CJK_MISC /* deprecated */
3042 #<span class="keyword">define</span> TT_UCR_PHAGSPA
3043   /* Bit 54   Enclosed CJK Letters and Months */
3044 #<span class="keyword">define</span> TT_UCR_ENCLOSED_CJK_LETTERS_MONTHS     (1L &lt;&lt; 22) /* U+3200-U+32FF */
3045   /* Bit 55   CJK Compatibility */
3046 #<span class="keyword">define</span> TT_UCR_CJK_COMPATIBILITY               (1L &lt;&lt; 23) /* U+3300-U+33FF */
3047   /* Bit 56   Hangul Syllables */
3048 #<span class="keyword">define</span> TT_UCR_HANGUL                          (1L &lt;&lt; 24) /* U+AC00-U+D7A3 */
3049   /* Bit 57   High Surrogates              */
3050   /*          High Private Use Surrogates  */
3051   /*          Low Surrogates               */
3052
3053   /* According to OpenType specs v.1.3+,   */
3054   /* setting bit 57 implies that there is  */
3055   /* at least one codepoint beyond the     */
3056   /* Basic Multilingual Plane that is      */
3057   /* supported by this font.  So it really */
3058   /* means &gt;= U+10000.                     */
3059 #<span class="keyword">define</span> TT_UCR_SURROGATES                      (1L &lt;&lt; 25) /* U+D800-U+DB7F */
3060                                                           /* U+DB80-U+DBFF */
3061                                                           /* U+DC00-U+DFFF */
3062 #<span class="keyword">define</span> TT_UCR_NON_PLANE_0  TT_UCR_SURROGATES
3063   /* Bit 58  Phoenician */
3064 #<span class="keyword">define</span> TT_UCR_PHOENICIAN                      (1L &lt;&lt; 26) /*U+10900-U+1091F*/
3065   /* Bit 59   CJK Unified Ideographs             */
3066   /*          CJK Radicals Supplement            */
3067   /*          Kangxi Radicals                    */
3068   /*          Ideographic Description Characters */
3069   /*          CJK Unified Ideographs Extension A */
3070   /*          CJK Unified Ideographs Extension B */
3071   /*          Kanbun                             */
3072 #<span class="keyword">define</span> TT_UCR_CJK_UNIFIED_IDEOGRAPHS          (1L &lt;&lt; 27) /* U+4E00-U+9FFF */
3073                                                           /* U+2E80-U+2EFF */
3074                                                           /* U+2F00-U+2FDF */
3075                                                           /* U+2FF0-U+2FFF */
3076                                                           /* U+3400-U+4DB5 */
3077                                                           /*U+20000-U+2A6DF*/
3078                                                           /* U+3190-U+319F */
3079   /* Bit 60   Private Use */
3080 #<span class="keyword">define</span> TT_UCR_PRIVATE_USE                     (1L &lt;&lt; 28) /* U+E000-U+F8FF */
3081   /* Bit 61   CJK Strokes                             */
3082   /*          CJK Compatibility Ideographs            */
3083   /*          CJK Compatibility Ideographs Supplement */
3084 #<span class="keyword">define</span> TT_UCR_CJK_COMPATIBILITY_IDEOGRAPHS    (1L &lt;&lt; 29) /* U+31C0-U+31EF */
3085                                                           /* U+F900-U+FAFF */
3086                                                           /*U+2F800-U+2FA1F*/
3087   /* Bit 62   Alphabetic Presentation Forms */
3088 #<span class="keyword">define</span> TT_UCR_ALPHABETIC_PRESENTATION_FORMS   (1L &lt;&lt; 30) /* U+FB00-U+FB4F */
3089   /* Bit 63   Arabic Presentation Forms-A */
3090 #<span class="keyword">define</span> TT_UCR_ARABIC_PRESENTATION_FORMS_A     (1L &lt;&lt; 31) /* U+FB50-U+FDFF */
3091
3092   /* ulUnicodeRange3 */
3093   /* --------------- */
3094
3095   /* Bit 64   Combining Half Marks */
3096 #<span class="keyword">define</span> TT_UCR_COMBINING_HALF_MARKS            (1L &lt;&lt;  0) /* U+FE20-U+FE2F */
3097   /* Bit 65   Vertical forms          */
3098   /*          CJK Compatibility Forms */
3099 #<span class="keyword">define</span> TT_UCR_CJK_COMPATIBILITY_FORMS         (1L &lt;&lt;  1) /* U+FE10-U+FE1F */
3100                                                           /* U+FE30-U+FE4F */
3101   /* Bit 66   Small Form Variants */
3102 #<span class="keyword">define</span> TT_UCR_SMALL_FORM_VARIANTS             (1L &lt;&lt;  2) /* U+FE50-U+FE6F */
3103   /* Bit 67   Arabic Presentation Forms-B */
3104 #<span class="keyword">define</span> TT_UCR_ARABIC_PRESENTATION_FORMS_B     (1L &lt;&lt;  3) /* U+FE70-U+FEFE */
3105   /* Bit 68   Halfwidth and Fullwidth Forms */
3106 #<span class="keyword">define</span> TT_UCR_HALFWIDTH_FULLWIDTH_FORMS       (1L &lt;&lt;  4) /* U+FF00-U+FFEF */
3107   /* Bit 69   Specials */
3108 #<span class="keyword">define</span> TT_UCR_SPECIALS                        (1L &lt;&lt;  5) /* U+FFF0-U+FFFD */
3109   /* Bit 70   Tibetan */
3110 #<span class="keyword">define</span> TT_UCR_TIBETAN                         (1L &lt;&lt;  6) /* U+0F00-U+0FFF */
3111   /* Bit 71   Syriac */
3112 #<span class="keyword">define</span> TT_UCR_SYRIAC                          (1L &lt;&lt;  7) /* U+0700-U+074F */
3113   /* Bit 72   Thaana */
3114 #<span class="keyword">define</span> TT_UCR_THAANA                          (1L &lt;&lt;  8) /* U+0780-U+07BF */
3115   /* Bit 73   Sinhala */
3116 #<span class="keyword">define</span> TT_UCR_SINHALA                         (1L &lt;&lt;  9) /* U+0D80-U+0DFF */
3117   /* Bit 74   Myanmar */
3118 #<span class="keyword">define</span> TT_UCR_MYANMAR                         (1L &lt;&lt; 10) /* U+1000-U+109F */
3119   /* Bit 75   Ethiopic            */
3120   /*          Ethiopic Supplement */
3121   /*          Ethiopic Extended   */
3122 #<span class="keyword">define</span> TT_UCR_ETHIOPIC                        (1L &lt;&lt; 11) /* U+1200-U+137F */
3123                                                           /* U+1380-U+139F */
3124                                                           /* U+2D80-U+2DDF */
3125   /* Bit 76   Cherokee */
3126 #<span class="keyword">define</span> TT_UCR_CHEROKEE                        (1L &lt;&lt; 12) /* U+13A0-U+13FF */
3127   /* Bit 77   Unified Canadian Aboriginal Syllabics */
3128 #<span class="keyword">define</span> TT_UCR_CANADIAN_ABORIGINAL_SYLLABICS   (1L &lt;&lt; 13) /* U+1400-U+167F */
3129   /* Bit 78   Ogham */
3130 #<span class="keyword">define</span> TT_UCR_OGHAM                           (1L &lt;&lt; 14) /* U+1680-U+169F */
3131   /* Bit 79   Runic */
3132 #<span class="keyword">define</span> TT_UCR_RUNIC                           (1L &lt;&lt; 15) /* U+16A0-U+16FF */
3133   /* Bit 80   Khmer         */
3134   /*          Khmer Symbols */
3135 #<span class="keyword">define</span> TT_UCR_KHMER                           (1L &lt;&lt; 16) /* U+1780-U+17FF */
3136                                                           /* U+19E0-U+19FF */
3137   /* Bit 81   Mongolian */
3138 #<span class="keyword">define</span> TT_UCR_MONGOLIAN                       (1L &lt;&lt; 17) /* U+1800-U+18AF */
3139   /* Bit 82   Braille Patterns */
3140 #<span class="keyword">define</span> TT_UCR_BRAILLE                         (1L &lt;&lt; 18) /* U+2800-U+28FF */
3141   /* Bit 83   Yi Syllables */
3142   /*          Yi Radicals  */
3143 #<span class="keyword">define</span> TT_UCR_YI                              (1L &lt;&lt; 19) /* U+A000-U+A48F */
3144                                                           /* U+A490-U+A4CF */
3145   /* Bit 84   Tagalog  */
3146   /*          Hanunoo  */
3147   /*          Buhid    */
3148   /*          Tagbanwa */
3149 #<span class="keyword">define</span> TT_UCR_PHILIPPINE                      (1L &lt;&lt; 20) /* U+1700-U+171F */
3150                                                           /* U+1720-U+173F */
3151                                                           /* U+1740-U+175F */
3152                                                           /* U+1760-U+177F */
3153   /* Bit 85   Old Italic */
3154 #<span class="keyword">define</span> TT_UCR_OLD_ITALIC                      (1L &lt;&lt; 21) /*U+10300-U+1032F*/
3155   /* Bit 86   Gothic */
3156 #<span class="keyword">define</span> TT_UCR_GOTHIC                          (1L &lt;&lt; 22) /*U+10330-U+1034F*/
3157   /* Bit 87   Deseret */
3158 #<span class="keyword">define</span> TT_UCR_DESERET                         (1L &lt;&lt; 23) /*U+10400-U+1044F*/
3159   /* Bit 88   Byzantine Musical Symbols      */
3160   /*          Musical Symbols                */
3161   /*          Ancient Greek Musical Notation */
3162 #<span class="keyword">define</span> TT_UCR_MUSICAL_SYMBOLS                 (1L &lt;&lt; 24) /*U+1D000-U+1D0FF*/
3163                                                           /*U+1D100-U+1D1FF*/
3164                                                           /*U+1D200-U+1D24F*/
3165   /* Bit 89   Mathematical Alphanumeric Symbols */
3166 #<span class="keyword">define</span> TT_UCR_MATH_ALPHANUMERIC_SYMBOLS       (1L &lt;&lt; 25) /*U+1D400-U+1D7FF*/
3167   /* Bit 90   Private Use (plane 15) */
3168   /*          Private Use (plane 16) */
3169 #<span class="keyword">define</span> TT_UCR_PRIVATE_USE_SUPPLEMENTARY       (1L &lt;&lt; 26) /*U+F0000-U+FFFFD*/
3170                                                         /*U+100000-U+10FFFD*/
3171   /* Bit 91   Variation Selectors            */
3172   /*          Variation Selectors Supplement */
3173 #<span class="keyword">define</span> TT_UCR_VARIATION_SELECTORS             (1L &lt;&lt; 27) /* U+FE00-U+FE0F */
3174                                                           /*U+E0100-U+E01EF*/
3175   /* Bit 92   Tags */
3176 #<span class="keyword">define</span> TT_UCR_TAGS                            (1L &lt;&lt; 28) /*U+E0000-U+E007F*/
3177   /* Bit 93   Limbu */
3178 #<span class="keyword">define</span> TT_UCR_LIMBU                           (1L &lt;&lt; 29) /* U+1900-U+194F */
3179   /* Bit 94   Tai Le */
3180 #<span class="keyword">define</span> TT_UCR_TAI_LE                          (1L &lt;&lt; 30) /* U+1950-U+197F */
3181   /* Bit 95   New Tai Lue */
3182 #<span class="keyword">define</span> TT_UCR_NEW_TAI_LUE                     (1L &lt;&lt; 31) /* U+1980-U+19DF */
3183
3184   /* ulUnicodeRange4 */
3185   /* --------------- */
3186
3187   /* Bit 96   Buginese */
3188 #<span class="keyword">define</span> TT_UCR_BUGINESE                        (1L &lt;&lt;  0) /* U+1A00-U+1A1F */
3189   /* Bit 97   Glagolitic */
3190 #<span class="keyword">define</span> TT_UCR_GLAGOLITIC                      (1L &lt;&lt;  1) /* U+2C00-U+2C5F */
3191   /* Bit 98   Tifinagh */
3192 #<span class="keyword">define</span> TT_UCR_TIFINAGH                        (1L &lt;&lt;  2) /* U+2D30-U+2D7F */
3193   /* Bit 99   Yijing Hexagram Symbols */
3194 #<span class="keyword">define</span> TT_UCR_YIJING                          (1L &lt;&lt;  3) /* U+4DC0-U+4DFF */
3195   /* Bit 100  Syloti Nagri */
3196 #<span class="keyword">define</span> TT_UCR_SYLOTI_NAGRI                    (1L &lt;&lt;  4) /* U+A800-U+A82F */
3197   /* Bit 101  Linear B Syllabary */
3198   /*          Linear B Ideograms */
3199   /*          Aegean Numbers     */
3200 #<span class="keyword">define</span> TT_UCR_LINEAR_B                        (1L &lt;&lt;  5) /*U+10000-U+1007F*/
3201                                                           /*U+10080-U+100FF*/
3202                                                           /*U+10100-U+1013F*/
3203   /* Bit 102  Ancient Greek Numbers */
3204 #<span class="keyword">define</span> TT_UCR_ANCIENT_GREEK_NUMBERS           (1L &lt;&lt;  6) /*U+10140-U+1018F*/
3205   /* Bit 103  Ugaritic */
3206 #<span class="keyword">define</span> TT_UCR_UGARITIC                        (1L &lt;&lt;  7) /*U+10380-U+1039F*/
3207   /* Bit 104  Old Persian */
3208 #<span class="keyword">define</span> TT_UCR_OLD_PERSIAN                     (1L &lt;&lt;  8) /*U+103A0-U+103DF*/
3209   /* Bit 105  Shavian */
3210 #<span class="keyword">define</span> TT_UCR_SHAVIAN                         (1L &lt;&lt;  9) /*U+10450-U+1047F*/
3211   /* Bit 106  Osmanya */
3212 #<span class="keyword">define</span> TT_UCR_OSMANYA                         (1L &lt;&lt; 10) /*U+10480-U+104AF*/
3213   /* Bit 107  Cypriot Syllabary */
3214 #<span class="keyword">define</span> TT_UCR_CYPRIOT_SYLLABARY               (1L &lt;&lt; 11) /*U+10800-U+1083F*/
3215   /* Bit 108  Kharoshthi */
3216 #<span class="keyword">define</span> TT_UCR_KHAROSHTHI                      (1L &lt;&lt; 12) /*U+10A00-U+10A5F*/
3217   /* Bit 109  Tai Xuan Jing Symbols */
3218 #<span class="keyword">define</span> TT_UCR_TAI_XUAN_JING                   (1L &lt;&lt; 13) /*U+1D300-U+1D35F*/
3219   /* Bit 110  Cuneiform                         */
3220   /*          Cuneiform Numbers and Punctuation */
3221 #<span class="keyword">define</span> TT_UCR_CUNEIFORM                       (1L &lt;&lt; 14) /*U+12000-U+123FF*/
3222                                                           /*U+12400-U+1247F*/
3223   /* Bit 111  Counting Rod Numerals */
3224 #<span class="keyword">define</span> TT_UCR_COUNTING_ROD_NUMERALS           (1L &lt;&lt; 15) /*U+1D360-U+1D37F*/
3225   /* Bit 112  Sundanese */
3226 #<span class="keyword">define</span> TT_UCR_SUNDANESE                       (1L &lt;&lt; 16) /* U+1B80-U+1BBF */
3227   /* Bit 113  Lepcha */
3228 #<span class="keyword">define</span> TT_UCR_LEPCHA                          (1L &lt;&lt; 17) /* U+1C00-U+1C4F */
3229   /* Bit 114  Ol Chiki */
3230 #<span class="keyword">define</span> TT_UCR_OL_CHIKI                        (1L &lt;&lt; 18) /* U+1C50-U+1C7F */
3231   /* Bit 115  Saurashtra */
3232 #<span class="keyword">define</span> TT_UCR_SAURASHTRA                      (1L &lt;&lt; 19) /* U+A880-U+A8DF */
3233   /* Bit 116  Kayah Li */
3234 #<span class="keyword">define</span> TT_UCR_KAYAH_LI                        (1L &lt;&lt; 20) /* U+A900-U+A92F */
3235   /* Bit 117  Rejang */
3236 #<span class="keyword">define</span> TT_UCR_REJANG                          (1L &lt;&lt; 21) /* U+A930-U+A95F */
3237   /* Bit 118  Cham */
3238 #<span class="keyword">define</span> TT_UCR_CHAM                            (1L &lt;&lt; 22) /* U+AA00-U+AA5F */
3239   /* Bit 119  Ancient Symbols */
3240 #<span class="keyword">define</span> TT_UCR_ANCIENT_SYMBOLS                 (1L &lt;&lt; 23) /*U+10190-U+101CF*/
3241   /* Bit 120  Phaistos Disc */
3242 #<span class="keyword">define</span> TT_UCR_PHAISTOS_DISC                   (1L &lt;&lt; 24) /*U+101D0-U+101FF*/
3243   /* Bit 121  Carian */
3244   /*          Lycian */
3245   /*          Lydian */
3246 #<span class="keyword">define</span> TT_UCR_OLD_ANATOLIAN                   (1L &lt;&lt; 25) /*U+102A0-U+102DF*/
3247                                                           /*U+10280-U+1029F*/
3248                                                           /*U+10920-U+1093F*/
3249   /* Bit 122  Domino Tiles  */
3250   /*          Mahjong Tiles */
3251 #<span class="keyword">define</span> TT_UCR_GAME_TILES                      (1L &lt;&lt; 26) /*U+1F030-U+1F09F*/
3252                                                           /*U+1F000-U+1F02F*/
3253   /* Bit 123-127 Reserved for process-internal usage */
3254 </code></pre></div>
3255
3256 <p>Possible bit mask values for the <code>ulUnicodeRangeX</code> fields in an SFNT &lsquo;OS/2&rsquo; table.</p>
3257 <hr>
3258
3259
3260
3261
3262
3263
3264
3265             </article>
3266           </div>
3267         </div>
3268
3269       </main>
3270
3271
3272 <footer class="md-footer">
3273
3274     <nav class="md-footer__inner md-grid" aria-label="Footer">
3275
3276
3277         <a href="ft2-multiple_masters.html" class="md-footer__link md-footer__link--prev" aria-label="Previous: Multiple Masters" rel="prev">
3278           <div class="md-footer__button md-icon">
3279             <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>
3280           </div>
3281           <div class="md-footer__title">
3282             <div class="md-ellipsis">
3283               <span class="md-footer__direction">
3284                 Previous
3285               </span>
3286               Multiple Masters
3287             </div>
3288           </div>
3289         </a>
3290
3291
3292
3293         <a href="ft2-type1_tables.html" class="md-footer__link md-footer__link--next" aria-label="Next: Type 1 Tables" rel="next">
3294           <div class="md-footer__title">
3295             <div class="md-ellipsis">
3296               <span class="md-footer__direction">
3297                 Next
3298               </span>
3299               Type 1 Tables
3300             </div>
3301           </div>
3302           <div class="md-footer__button md-icon">
3303             <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>
3304           </div>
3305         </a>
3306
3307     </nav>
3308
3309   <div class="md-footer-meta md-typeset">
3310     <div class="md-footer-meta__inner md-grid">
3311       <div class="md-footer-copyright">
3312
3313           <div class="md-footer-copyright__highlight">
3314             Copyright 2023 <a href = "https://www.freetype.org/license.html">The FreeType Project</a>.
3315           </div>
3316
3317         Made with
3318         <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
3319           Material for MkDocs
3320         </a>
3321
3322       </div>
3323
3324     </div>
3325   </div>
3326 </footer>
3327
3328     </div>
3329     <div class="md-dialog" data-md-component="dialog">
3330       <div class="md-dialog__inner md-typeset"></div>
3331     </div>
3332     <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>
3333
3334
3335       <script src="assets/javascripts/bundle.82b56eb2.min.js"></script>
3336
3337         <script src="javascripts/extra.js"></script>
3338
3339
3340   </body>
3341 </html>