docs/reference/site/ft2-quick_advance.html

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