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.4"> 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.1, mkdocs-material-4.6.3"> 40 41 42 43 <title>Window FNT Files - FreeType-2.10.4 API Reference</title> 44 45 46 47 <link rel="stylesheet" href="assets/stylesheets/application.adb8469c.css"> 48 49 <link rel="stylesheet" href="assets/stylesheets/application-palette.a8b3c06d.css"> 50 51 52 53 54 <meta name="theme-color" content="#4caf50"> 55 56 57 58 <script src="assets/javascripts/modernizr.86422ebf.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%7CRoboto+Mono&display=fallback"> 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="#window-fnt-files" tabindex="0" 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="." title="FreeType-2.10.4 API Reference" aria-label="FreeType-2.10.4 API Reference" class="md-header-nav__button md-logo"> 102 103 <img alt="logo" 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.4 API Reference 115 </span> 116 <span class="md-header-nav__topic"> 117 118 Window FNT Files 119 120 </span> 121 122 </div> 123 </div> 124 <div class="md-flex__cell md-flex__cell--shrink"> 125 126 <label class="md-icon md-icon--search md-header-nav__button" for="__search"></label> 127 128<div class="md-search" data-md-component="search" role="dialog"> 129 <label class="md-search__overlay" for="__search"></label> 130 <div class="md-search__inner" role="search"> 131 <form class="md-search__form" name="search"> 132 <input type="text" class="md-search__input" aria-label="search" name="query" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="query" data-md-state="active"> 133 <label class="md-icon md-search__icon" for="__search"></label> 134 <button type="reset" class="md-icon md-search__icon" data-md-component="reset" tabindex="-1"> 135  136 </button> 137 </form> 138 <div class="md-search__output"> 139 <div class="md-search__scrollwrap" data-md-scrollfix> 140 <div class="md-search-result" data-md-component="result"> 141 <div class="md-search-result__meta"> 142 Type to start searching 143 </div> 144 <ol class="md-search-result__list"></ol> 145 </div> 146 </div> 147 </div> 148 </div> 149</div> 150 151 </div> 152 153 </div> 154 </nav> 155</header> 156 157 <div class="md-container"> 158 159 160 161 162 <main class="md-main" role="main"> 163 <div class="md-main__inner md-grid" data-md-component="container"> 164 165 166 <div class="md-sidebar md-sidebar--primary" data-md-component="navigation"> 167 <div class="md-sidebar__scrollwrap"> 168 <div class="md-sidebar__inner"> 169 <nav class="md-nav md-nav--primary" data-md-level="0"> 170 <label class="md-nav__title md-nav__title--site" for="__drawer"> 171 <a href="." title="FreeType-2.10.4 API Reference" class="md-nav__button md-logo"> 172 173 <img alt="logo" src="images/favico.ico" width="48" height="48"> 174 175 </a> 176 FreeType-2.10.4 API Reference 177 </label> 178 179 <ul class="md-nav__list" data-md-scrollfix> 180 181 182 183 184 185 186 <li class="md-nav__item"> 187 <a href="index.html" title="TOC" class="md-nav__link"> 188 TOC 189 </a> 190 </li> 191 192 193 194 195 196 197 198 <li class="md-nav__item"> 199 <a href="ft2-index.html" title="Index" class="md-nav__link"> 200 Index 201 </a> 202 </li> 203 204 205 206 207 208 209 210 <li class="md-nav__item md-nav__item--nested"> 211 212 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3" type="checkbox" id="nav-3"> 213 214 <label class="md-nav__link" for="nav-3"> 215 General Remarks 216 </label> 217 <nav class="md-nav" data-md-component="collapsible" data-md-level="1"> 218 <label class="md-nav__title" for="nav-3"> 219 General Remarks 220 </label> 221 <ul class="md-nav__list" data-md-scrollfix> 222 223 224 225 226 227 228 229 <li class="md-nav__item"> 230 <a href="ft2-header_inclusion.html" title="FreeType's header inclusion scheme" class="md-nav__link"> 231 FreeType's header inclusion scheme 232 </a> 233 </li> 234 235 236 237 238 239 240 241 <li class="md-nav__item"> 242 <a href="ft2-user_allocation.html" title="User allocation" class="md-nav__link"> 243 User allocation 244 </a> 245 </li> 246 247 248 </ul> 249 </nav> 250 </li> 251 252 253 254 255 256 257 258 <li class="md-nav__item md-nav__item--nested"> 259 260 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-4" type="checkbox" id="nav-4"> 261 262 <label class="md-nav__link" for="nav-4"> 263 Core API 264 </label> 265 <nav class="md-nav" data-md-component="collapsible" data-md-level="1"> 266 <label class="md-nav__title" for="nav-4"> 267 Core API 268 </label> 269 <ul class="md-nav__list" data-md-scrollfix> 270 271 272 273 274 275 276 277 <li class="md-nav__item"> 278 <a href="ft2-version.html" title="FreeType Version" class="md-nav__link"> 279 FreeType Version 280 </a> 281 </li> 282 283 284 285 286 287 288 289 <li class="md-nav__item"> 290 <a href="ft2-basic_types.html" title="Basic Data Types" class="md-nav__link"> 291 Basic Data Types 292 </a> 293 </li> 294 295 296 297 298 299 300 301 <li class="md-nav__item"> 302 <a href="ft2-base_interface.html" title="Base Interface" class="md-nav__link"> 303 Base Interface 304 </a> 305 </li> 306 307 308 309 310 311 312 313 <li class="md-nav__item"> 314 <a href="ft2-glyph_variants.html" title="Unicode Variation Sequences" class="md-nav__link"> 315 Unicode Variation Sequences 316 </a> 317 </li> 318 319 320 321 322 323 324 325 <li class="md-nav__item"> 326 <a href="ft2-color_management.html" title="Glyph Color Management" class="md-nav__link"> 327 Glyph Color Management 328 </a> 329 </li> 330 331 332 333 334 335 336 337 <li class="md-nav__item"> 338 <a href="ft2-layer_management.html" title="Glyph Layer Management" class="md-nav__link"> 339 Glyph Layer Management 340 </a> 341 </li> 342 343 344 345 346 347 348 349 <li class="md-nav__item"> 350 <a href="ft2-glyph_management.html" title="Glyph Management" class="md-nav__link"> 351 Glyph Management 352 </a> 353 </li> 354 355 356 357 358 359 360 361 <li class="md-nav__item"> 362 <a href="ft2-mac_specific.html" title="Mac Specific Interface" class="md-nav__link"> 363 Mac Specific Interface 364 </a> 365 </li> 366 367 368 369 370 371 372 373 <li class="md-nav__item"> 374 <a href="ft2-sizes_management.html" title="Size Management" class="md-nav__link"> 375 Size Management 376 </a> 377 </li> 378 379 380 381 382 383 384 385 <li class="md-nav__item"> 386 <a href="ft2-header_file_macros.html" title="Header File Macros" class="md-nav__link"> 387 Header File Macros 388 </a> 389 </li> 390 391 392 </ul> 393 </nav> 394 </li> 395 396 397 398 399 400 401 402 403 404 <li class="md-nav__item md-nav__item--active md-nav__item--nested"> 405 406 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-5" type="checkbox" id="nav-5" checked> 407 408 <label class="md-nav__link" for="nav-5"> 409 Format-Specific API 410 </label> 411 <nav class="md-nav" data-md-component="collapsible" data-md-level="1"> 412 <label class="md-nav__title" for="nav-5"> 413 Format-Specific API 414 </label> 415 <ul class="md-nav__list" data-md-scrollfix> 416 417 418 419 420 421 422 423 <li class="md-nav__item"> 424 <a href="ft2-multiple_masters.html" title="Multiple Masters" class="md-nav__link"> 425 Multiple Masters 426 </a> 427 </li> 428 429 430 431 432 433 434 435 <li class="md-nav__item"> 436 <a href="ft2-truetype_tables.html" title="TrueType Tables" class="md-nav__link"> 437 TrueType Tables 438 </a> 439 </li> 440 441 442 443 444 445 446 447 <li class="md-nav__item"> 448 <a href="ft2-type1_tables.html" title="Type 1 Tables" class="md-nav__link"> 449 Type 1 Tables 450 </a> 451 </li> 452 453 454 455 456 457 458 459 <li class="md-nav__item"> 460 <a href="ft2-sfnt_names.html" title="SFNT Names" class="md-nav__link"> 461 SFNT Names 462 </a> 463 </li> 464 465 466 467 468 469 470 471 <li class="md-nav__item"> 472 <a href="ft2-bdf_fonts.html" title="BDF and PCF Files" class="md-nav__link"> 473 BDF and PCF Files 474 </a> 475 </li> 476 477 478 479 480 481 482 483 <li class="md-nav__item"> 484 <a href="ft2-cid_fonts.html" title="CID Fonts" class="md-nav__link"> 485 CID Fonts 486 </a> 487 </li> 488 489 490 491 492 493 494 495 <li class="md-nav__item"> 496 <a href="ft2-pfr_fonts.html" title="PFR Fonts" class="md-nav__link"> 497 PFR Fonts 498 </a> 499 </li> 500 501 502 503 504 505 506 507 508 509 <li class="md-nav__item md-nav__item--active"> 510 511 <input class="md-toggle md-nav__toggle" data-md-toggle="toc" type="checkbox" id="__toc"> 512 513 514 515 516 <label class="md-nav__link md-nav__link--active" for="__toc"> 517 Window FNT Files 518 </label> 519 520 <a href="ft2-winfnt_fonts.html" title="Window FNT Files" class="md-nav__link md-nav__link--active"> 521 Window FNT Files 522 </a> 523 524 525<nav class="md-nav md-nav--secondary"> 526 527 528 529 530 531 <label class="md-nav__title" for="__toc">Table of contents</label> 532 <ul class="md-nav__list" data-md-scrollfix> 533 534 <li class="md-nav__item"> 535 <a href="#synopsis" class="md-nav__link"> 536 Synopsis 537 </a> 538 539</li> 540 541 <li class="md-nav__item"> 542 <a href="#ft_winfnt_id_xxx" class="md-nav__link"> 543 FT_WinFNT_ID_XXX 544 </a> 545 546</li> 547 548 <li class="md-nav__item"> 549 <a href="#ft_winfnt_headerrec" class="md-nav__link"> 550 FT_WinFNT_HeaderRec 551 </a> 552 553</li> 554 555 <li class="md-nav__item"> 556 <a href="#ft_winfnt_header" class="md-nav__link"> 557 FT_WinFNT_Header 558 </a> 559 560</li> 561 562 <li class="md-nav__item"> 563 <a href="#ft_get_winfnt_header" class="md-nav__link"> 564 FT_Get_WinFNT_Header 565 </a> 566 567</li> 568 569 570 571 572 573 </ul> 574 575</nav> 576 577 </li> 578 579 580 581 582 583 584 585 <li class="md-nav__item"> 586 <a href="ft2-font_formats.html" title="Font Formats" class="md-nav__link"> 587 Font Formats 588 </a> 589 </li> 590 591 592 593 594 595 596 597 <li class="md-nav__item"> 598 <a href="ft2-gasp_table.html" title="Gasp Table" class="md-nav__link"> 599 Gasp Table 600 </a> 601 </li> 602 603 604 </ul> 605 </nav> 606 </li> 607 608 609 610 611 612 613 614 <li class="md-nav__item md-nav__item--nested"> 615 616 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-6" type="checkbox" id="nav-6"> 617 618 <label class="md-nav__link" for="nav-6"> 619 Controlling FreeType Modules 620 </label> 621 <nav class="md-nav" data-md-component="collapsible" data-md-level="1"> 622 <label class="md-nav__title" for="nav-6"> 623 Controlling FreeType Modules 624 </label> 625 <ul class="md-nav__list" data-md-scrollfix> 626 627 628 629 630 631 632 633 <li class="md-nav__item"> 634 <a href="ft2-auto_hinter.html" title="The auto-hinter" class="md-nav__link"> 635 The auto-hinter 636 </a> 637 </li> 638 639 640 641 642 643 644 645 <li class="md-nav__item"> 646 <a href="ft2-cff_driver.html" title="The CFF driver" class="md-nav__link"> 647 The CFF driver 648 </a> 649 </li> 650 651 652 653 654 655 656 657 <li class="md-nav__item"> 658 <a href="ft2-t1_cid_driver.html" title="The Type 1 and CID drivers" class="md-nav__link"> 659 The Type 1 and CID drivers 660 </a> 661 </li> 662 663 664 665 666 667 668 669 <li class="md-nav__item"> 670 <a href="ft2-tt_driver.html" title="The TrueType driver" class="md-nav__link"> 671 The TrueType driver 672 </a> 673 </li> 674 675 676 677 678 679 680 681 <li class="md-nav__item"> 682 <a href="ft2-pcf_driver.html" title="The PCF driver" class="md-nav__link"> 683 The PCF driver 684 </a> 685 </li> 686 687 688 689 690 691 692 693 <li class="md-nav__item"> 694 <a href="ft2-properties.html" title="Driver properties" class="md-nav__link"> 695 Driver properties 696 </a> 697 </li> 698 699 700 701 702 703 704 705 <li class="md-nav__item"> 706 <a href="ft2-parameter_tags.html" title="Parameter Tags" class="md-nav__link"> 707 Parameter Tags 708 </a> 709 </li> 710 711 712 713 714 715 716 717 <li class="md-nav__item"> 718 <a href="ft2-lcd_rendering.html" title="Subpixel Rendering" class="md-nav__link"> 719 Subpixel Rendering 720 </a> 721 </li> 722 723 724 </ul> 725 </nav> 726 </li> 727 728 729 730 731 732 733 734 <li class="md-nav__item md-nav__item--nested"> 735 736 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-7" type="checkbox" id="nav-7"> 737 738 <label class="md-nav__link" for="nav-7"> 739 Cache Sub-System 740 </label> 741 <nav class="md-nav" data-md-component="collapsible" data-md-level="1"> 742 <label class="md-nav__title" for="nav-7"> 743 Cache Sub-System 744 </label> 745 <ul class="md-nav__list" data-md-scrollfix> 746 747 748 749 750 751 752 753 <li class="md-nav__item"> 754 <a href="ft2-cache_subsystem.html" title="Cache Sub-System" class="md-nav__link"> 755 Cache Sub-System 756 </a> 757 </li> 758 759 760 </ul> 761 </nav> 762 </li> 763 764 765 766 767 768 769 770 <li class="md-nav__item md-nav__item--nested"> 771 772 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-8" type="checkbox" id="nav-8"> 773 774 <label class="md-nav__link" for="nav-8"> 775 Support API 776 </label> 777 <nav class="md-nav" data-md-component="collapsible" data-md-level="1"> 778 <label class="md-nav__title" for="nav-8"> 779 Support API 780 </label> 781 <ul class="md-nav__list" data-md-scrollfix> 782 783 784 785 786 787 788 789 <li class="md-nav__item"> 790 <a href="ft2-computations.html" title="Computations" class="md-nav__link"> 791 Computations 792 </a> 793 </li> 794 795 796 797 798 799 800 801 <li class="md-nav__item"> 802 <a href="ft2-list_processing.html" title="List Processing" class="md-nav__link"> 803 List Processing 804 </a> 805 </li> 806 807 808 809 810 811 812 813 <li class="md-nav__item"> 814 <a href="ft2-outline_processing.html" title="Outline Processing" class="md-nav__link"> 815 Outline Processing 816 </a> 817 </li> 818 819 820 821 822 823 824 825 <li class="md-nav__item"> 826 <a href="ft2-quick_advance.html" title="Quick retrieval of advance values" class="md-nav__link"> 827 Quick retrieval of advance values 828 </a> 829 </li> 830 831 832 833 834 835 836 837 <li class="md-nav__item"> 838 <a href="ft2-bitmap_handling.html" title="Bitmap Handling" class="md-nav__link"> 839 Bitmap Handling 840 </a> 841 </li> 842 843 844 845 846 847 848 849 <li class="md-nav__item"> 850 <a href="ft2-raster.html" title="Scanline Converter" class="md-nav__link"> 851 Scanline Converter 852 </a> 853 </li> 854 855 856 857 858 859 860 861 <li class="md-nav__item"> 862 <a href="ft2-glyph_stroker.html" title="Glyph Stroker" class="md-nav__link"> 863 Glyph Stroker 864 </a> 865 </li> 866 867 868 869 870 871 872 873 <li class="md-nav__item"> 874 <a href="ft2-system_interface.html" title="System Interface" class="md-nav__link"> 875 System Interface 876 </a> 877 </li> 878 879 880 881 882 883 884 885 <li class="md-nav__item"> 886 <a href="ft2-module_management.html" title="Module Management" class="md-nav__link"> 887 Module Management 888 </a> 889 </li> 890 891 892 893 894 895 896 897 <li class="md-nav__item"> 898 <a href="ft2-gzip.html" title="GZIP Streams" class="md-nav__link"> 899 GZIP Streams 900 </a> 901 </li> 902 903 904 905 906 907 908 909 <li class="md-nav__item"> 910 <a href="ft2-lzw.html" title="LZW Streams" class="md-nav__link"> 911 LZW Streams 912 </a> 913 </li> 914 915 916 917 918 919 920 921 <li class="md-nav__item"> 922 <a href="ft2-bzip2.html" title="BZIP2 Streams" class="md-nav__link"> 923 BZIP2 Streams 924 </a> 925 </li> 926 927 928 </ul> 929 </nav> 930 </li> 931 932 933 934 935 936 937 938 <li class="md-nav__item md-nav__item--nested"> 939 940 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-9" type="checkbox" id="nav-9"> 941 942 <label class="md-nav__link" for="nav-9"> 943 Error Codes 944 </label> 945 <nav class="md-nav" data-md-component="collapsible" data-md-level="1"> 946 <label class="md-nav__title" for="nav-9"> 947 Error Codes 948 </label> 949 <ul class="md-nav__list" data-md-scrollfix> 950 951 952 953 954 955 956 957 <li class="md-nav__item"> 958 <a href="ft2-error_enumerations.html" title="Error Enumerations" class="md-nav__link"> 959 Error Enumerations 960 </a> 961 </li> 962 963 964 965 966 967 968 969 <li class="md-nav__item"> 970 <a href="ft2-error_code_values.html" title="Error Code Values" class="md-nav__link"> 971 Error Code Values 972 </a> 973 </li> 974 975 976 </ul> 977 </nav> 978 </li> 979 980 981 982 983 984 985 986 <li class="md-nav__item md-nav__item--nested"> 987 988 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-10" type="checkbox" id="nav-10"> 989 990 <label class="md-nav__link" for="nav-10"> 991 Miscellaneous 992 </label> 993 <nav class="md-nav" data-md-component="collapsible" data-md-level="1"> 994 <label class="md-nav__title" for="nav-10"> 995 Miscellaneous 996 </label> 997 <ul class="md-nav__list" data-md-scrollfix> 998 999 1000 1001 1002 1003 1004 1005 <li class="md-nav__item"> 1006 <a href="ft2-gx_validation.html" title="TrueTypeGX/AAT Validation" class="md-nav__link"> 1007 TrueTypeGX/AAT Validation 1008 </a> 1009 </li> 1010 1011 1012 1013 1014 1015 1016 1017 <li class="md-nav__item"> 1018 <a href="ft2-incremental.html" title="Incremental Loading" class="md-nav__link"> 1019 Incremental Loading 1020 </a> 1021 </li> 1022 1023 1024 1025 1026 1027 1028 1029 <li class="md-nav__item"> 1030 <a href="ft2-truetype_engine.html" title="The TrueType Engine" class="md-nav__link"> 1031 The TrueType Engine 1032 </a> 1033 </li> 1034 1035 1036 1037 1038 1039 1040 1041 <li class="md-nav__item"> 1042 <a href="ft2-ot_validation.html" title="OpenType Validation" class="md-nav__link"> 1043 OpenType Validation 1044 </a> 1045 </li> 1046 1047 1048 </ul> 1049 </nav> 1050 </li> 1051 1052 1053 </ul> 1054</nav> 1055 </div> 1056 </div> 1057 </div> 1058 1059 1060 <div class="md-sidebar md-sidebar--secondary" data-md-component="toc"> 1061 <div class="md-sidebar__scrollwrap"> 1062 <div class="md-sidebar__inner"> 1063 1064<nav class="md-nav md-nav--secondary"> 1065 1066 1067 1068 1069 1070 <label class="md-nav__title" for="__toc">Table of contents</label> 1071 <ul class="md-nav__list" data-md-scrollfix> 1072 1073 <li class="md-nav__item"> 1074 <a href="#synopsis" class="md-nav__link"> 1075 Synopsis 1076 </a> 1077 1078</li> 1079 1080 <li class="md-nav__item"> 1081 <a href="#ft_winfnt_id_xxx" class="md-nav__link"> 1082 FT_WinFNT_ID_XXX 1083 </a> 1084 1085</li> 1086 1087 <li class="md-nav__item"> 1088 <a href="#ft_winfnt_headerrec" class="md-nav__link"> 1089 FT_WinFNT_HeaderRec 1090 </a> 1091 1092</li> 1093 1094 <li class="md-nav__item"> 1095 <a href="#ft_winfnt_header" class="md-nav__link"> 1096 FT_WinFNT_Header 1097 </a> 1098 1099</li> 1100 1101 <li class="md-nav__item"> 1102 <a href="#ft_get_winfnt_header" class="md-nav__link"> 1103 FT_Get_WinFNT_Header 1104 </a> 1105 1106</li> 1107 1108 1109 1110 1111 1112 </ul> 1113 1114</nav> 1115 </div> 1116 </div> 1117 </div> 1118 1119 1120 <div class="md-content"> 1121 <article class="md-content__inner md-typeset"> 1122 1123 1124 1125 <p><a href="https://www.freetype.org">FreeType</a> » <a href="../">Docs</a> » <a href="index.html#format-specific-api">Format-Specific API</a> » Window FNT Files</p> 1126<hr /> 1127<h1 id="window-fnt-files">Window FNT Files<a class="headerlink" href="#window-fnt-files" title="Permanent link">¶</a></h1> 1128<h2 id="synopsis">Synopsis<a class="headerlink" href="#synopsis" title="Permanent link">¶</a></h2> 1129<p>This section contains the declaration of Windows FNT-specific functions.</p> 1130<h2 id="ft_winfnt_id_xxx">FT_WinFNT_ID_XXX<a class="headerlink" href="#ft_winfnt_id_xxx" title="Permanent link">¶</a></h2> 1131<p>Defined in FT_WINFONTS_H (freetype/ftwinfnt.h).</p> 1132<div class = "codehilite"><pre><code>#<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_cp1252">FT_WinFNT_ID_CP1252</a> 0 1133#<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_default">FT_WinFNT_ID_DEFAULT</a> 1 1134#<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_symbol">FT_WinFNT_ID_SYMBOL</a> 2 1135#<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_mac">FT_WinFNT_ID_MAC</a> 77 1136#<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_cp932">FT_WinFNT_ID_CP932</a> 128 1137#<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_cp949">FT_WinFNT_ID_CP949</a> 129 1138#<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_cp1361">FT_WinFNT_ID_CP1361</a> 130 1139#<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_cp936">FT_WinFNT_ID_CP936</a> 134 1140#<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_cp950">FT_WinFNT_ID_CP950</a> 136 1141#<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_cp1253">FT_WinFNT_ID_CP1253</a> 161 1142#<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_cp1254">FT_WinFNT_ID_CP1254</a> 162 1143#<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_cp1258">FT_WinFNT_ID_CP1258</a> 163 1144#<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_cp1255">FT_WinFNT_ID_CP1255</a> 177 1145#<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_cp1256">FT_WinFNT_ID_CP1256</a> 178 1146#<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_cp1257">FT_WinFNT_ID_CP1257</a> 186 1147#<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_cp1251">FT_WinFNT_ID_CP1251</a> 204 1148#<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_cp874">FT_WinFNT_ID_CP874</a> 222 1149#<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_cp1250">FT_WinFNT_ID_CP1250</a> 238 1150#<span class="keyword">define</span> <a href="ft2-winfnt_fonts.html#ft_winfnt_id_oem">FT_WinFNT_ID_OEM</a> 255 1151</code></pre></div> 1152 1153<p>A list of valid values for the <code>charset</code> byte in <code><a href="ft2-winfnt_fonts.html#ft_winfnt_headerrec">FT_WinFNT_HeaderRec</a></code>. Exact mapping tables for the various ‘cpXXXX’ encodings (except for ‘cp1361’) can be found at ‘<a href="ftp://ftp.unicode.org/Public/">ftp://ftp.unicode.org/Public/</a>’ in the <code>MAPPINGS/VENDORS/MICSFT/WINDOWS</code> subdirectory. ‘cp1361’ is roughly a superset of <code>MAPPINGS/OBSOLETE/EASTASIA/KSC/JOHAB.TXT</code>.</p> 1154<h4>values</h4> 1155 1156<table class="fields"> 1157<tr><td class="val" id="ft_winfnt_id_default">FT_WinFNT_ID_DEFAULT</td><td class="desc"> 1158<p>This is used for font enumeration and font creation as a ‘don't care’ value. Valid font files don't contain this value. When querying for information about the character set of the font that is currently selected into a specified device context, this return value (of the related Windows API) simply denotes failure.</p> 1159</td></tr> 1160<tr><td class="val" id="ft_winfnt_id_symbol">FT_WinFNT_ID_SYMBOL</td><td class="desc"> 1161<p>There is no known mapping table available.</p> 1162</td></tr> 1163<tr><td class="val" id="ft_winfnt_id_mac">FT_WinFNT_ID_MAC</td><td class="desc"> 1164<p>Mac Roman encoding.</p> 1165</td></tr> 1166<tr><td class="val" id="ft_winfnt_id_oem">FT_WinFNT_ID_OEM</td><td class="desc"> 1167<p>From Michael Poettgen <michael@poettgen.de>:</p> 1168<p>The ‘Windows Font Mapping’ article says that <code>FT_WinFNT_ID_OEM</code> is used for the charset of vector fonts, like <code>modern.fon</code>, <code>roman.fon</code>, and <code>script.fon</code> on Windows.</p> 1169<p>The ‘CreateFont’ documentation says: The <code>FT_WinFNT_ID_OEM</code> value specifies a character set that is operating-system dependent.</p> 1170<p>The ‘IFIMETRICS’ documentation from the ‘Windows Driver Development Kit’ says: This font supports an OEM-specific character set. The OEM character set is system dependent.</p> 1171<p>In general OEM, as opposed to ANSI (i.e., ‘cp1252’), denotes the second default codepage that most international versions of Windows have. It is one of the OEM codepages from</p> 1172<p><a href="https://docs.microsoft.com/en-us/windows/desktop/intl/code-page-identifiers">https://docs.microsoft.com/en-us/windows/desktop/intl/code-page-identifiers</a> ,</p> 1173<p>and is used for the ‘DOS boxes’, to support legacy applications. A German Windows version for example usually uses ANSI codepage 1252 and OEM codepage 850.</p> 1174</td></tr> 1175<tr><td class="val" id="ft_winfnt_id_cp874">FT_WinFNT_ID_CP874</td><td class="desc"> 1176<p>A superset of Thai TIS 620 and ISO 8859-11.</p> 1177</td></tr> 1178<tr><td class="val" id="ft_winfnt_id_cp932">FT_WinFNT_ID_CP932</td><td class="desc"> 1179<p>A superset of Japanese Shift-JIS (with minor deviations).</p> 1180</td></tr> 1181<tr><td class="val" id="ft_winfnt_id_cp936">FT_WinFNT_ID_CP936</td><td class="desc"> 1182<p>A superset of simplified Chinese GB 2312-1980 (with different ordering and minor deviations).</p> 1183</td></tr> 1184<tr><td class="val" id="ft_winfnt_id_cp949">FT_WinFNT_ID_CP949</td><td class="desc"> 1185<p>A superset of Korean Hangul KS C 5601-1987 (with different ordering and minor deviations).</p> 1186</td></tr> 1187<tr><td class="val" id="ft_winfnt_id_cp950">FT_WinFNT_ID_CP950</td><td class="desc"> 1188<p>A superset of traditional Chinese Big 5 ETen (with different ordering and minor deviations).</p> 1189</td></tr> 1190<tr><td class="val" id="ft_winfnt_id_cp1250">FT_WinFNT_ID_CP1250</td><td class="desc"> 1191<p>A superset of East European ISO 8859-2 (with slightly different ordering).</p> 1192</td></tr> 1193<tr><td class="val" id="ft_winfnt_id_cp1251">FT_WinFNT_ID_CP1251</td><td class="desc"> 1194<p>A superset of Russian ISO 8859-5 (with different ordering).</p> 1195</td></tr> 1196<tr><td class="val" id="ft_winfnt_id_cp1252">FT_WinFNT_ID_CP1252</td><td class="desc"> 1197<p>ANSI encoding. A superset of ISO 8859-1.</p> 1198</td></tr> 1199<tr><td class="val" id="ft_winfnt_id_cp1253">FT_WinFNT_ID_CP1253</td><td class="desc"> 1200<p>A superset of Greek ISO 8859-7 (with minor modifications).</p> 1201</td></tr> 1202<tr><td class="val" id="ft_winfnt_id_cp1254">FT_WinFNT_ID_CP1254</td><td class="desc"> 1203<p>A superset of Turkish ISO 8859-9.</p> 1204</td></tr> 1205<tr><td class="val" id="ft_winfnt_id_cp1255">FT_WinFNT_ID_CP1255</td><td class="desc"> 1206<p>A superset of Hebrew ISO 8859-8 (with some modifications).</p> 1207</td></tr> 1208<tr><td class="val" id="ft_winfnt_id_cp1256">FT_WinFNT_ID_CP1256</td><td class="desc"> 1209<p>A superset of Arabic ISO 8859-6 (with different ordering).</p> 1210</td></tr> 1211<tr><td class="val" id="ft_winfnt_id_cp1257">FT_WinFNT_ID_CP1257</td><td class="desc"> 1212<p>A superset of Baltic ISO 8859-13 (with some deviations).</p> 1213</td></tr> 1214<tr><td class="val" id="ft_winfnt_id_cp1258">FT_WinFNT_ID_CP1258</td><td class="desc"> 1215<p>For Vietnamese. This encoding doesn't cover all necessary characters.</p> 1216</td></tr> 1217<tr><td class="val" id="ft_winfnt_id_cp1361">FT_WinFNT_ID_CP1361</td><td class="desc"> 1218<p>Korean (Johab).</p> 1219</td></tr> 1220</table> 1221 1222<hr> 1223 1224<h2 id="ft_winfnt_headerrec">FT_WinFNT_HeaderRec<a class="headerlink" href="#ft_winfnt_headerrec" title="Permanent link">¶</a></h2> 1225<p>Defined in FT_WINFONTS_H (freetype/ftwinfnt.h).</p> 1226<div class = "codehilite"><pre><code> <span class="keyword">typedef</span> <span class="keyword">struct</span> FT_WinFNT_HeaderRec_ 1227 { 1228 <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> version; 1229 <a href="ft2-basic_types.html#ft_ulong">FT_ULong</a> file_size; 1230 <a href="ft2-basic_types.html#ft_byte">FT_Byte</a> copyright[60]; 1231 <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> file_type; 1232 <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> nominal_point_size; 1233 <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> vertical_resolution; 1234 <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> horizontal_resolution; 1235 <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> ascent; 1236 <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> internal_leading; 1237 <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> external_leading; 1238 <a href="ft2-basic_types.html#ft_byte">FT_Byte</a> italic; 1239 <a href="ft2-basic_types.html#ft_byte">FT_Byte</a> underline; 1240 <a href="ft2-basic_types.html#ft_byte">FT_Byte</a> strike_out; 1241 <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> weight; 1242 <a href="ft2-basic_types.html#ft_byte">FT_Byte</a> charset; 1243 <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> pixel_width; 1244 <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> pixel_height; 1245 <a href="ft2-basic_types.html#ft_byte">FT_Byte</a> pitch_and_family; 1246 <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> avg_width; 1247 <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> max_width; 1248 <a href="ft2-basic_types.html#ft_byte">FT_Byte</a> first_char; 1249 <a href="ft2-basic_types.html#ft_byte">FT_Byte</a> last_char; 1250 <a href="ft2-basic_types.html#ft_byte">FT_Byte</a> default_char; 1251 <a href="ft2-basic_types.html#ft_byte">FT_Byte</a> break_char; 1252 <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> bytes_per_row; 1253 <a href="ft2-basic_types.html#ft_ulong">FT_ULong</a> device_offset; 1254 <a href="ft2-basic_types.html#ft_ulong">FT_ULong</a> face_name_offset; 1255 <a href="ft2-basic_types.html#ft_ulong">FT_ULong</a> bits_pointer; 1256 <a href="ft2-basic_types.html#ft_ulong">FT_ULong</a> bits_offset; 1257 <a href="ft2-basic_types.html#ft_byte">FT_Byte</a> reserved; 1258 <a href="ft2-basic_types.html#ft_ulong">FT_ULong</a> flags; 1259 <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> A_space; 1260 <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> B_space; 1261 <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> C_space; 1262 <a href="ft2-basic_types.html#ft_ushort">FT_UShort</a> color_table_offset; 1263 <a href="ft2-basic_types.html#ft_ulong">FT_ULong</a> reserved1[4]; 1264 1265 } <b>FT_WinFNT_HeaderRec</b>; 1266</code></pre></div> 1267 1268<p>Windows FNT Header info.</p> 1269<hr> 1270 1271<h2 id="ft_winfnt_header">FT_WinFNT_Header<a class="headerlink" href="#ft_winfnt_header" title="Permanent link">¶</a></h2> 1272<p>Defined in FT_WINFONTS_H (freetype/ftwinfnt.h).</p> 1273<div class = "codehilite"><pre><code> <span class="keyword">typedef</span> <span class="keyword">struct</span> FT_WinFNT_HeaderRec_* <b>FT_WinFNT_Header</b>; 1274</code></pre></div> 1275 1276<p>A handle to an <code><a href="ft2-winfnt_fonts.html#ft_winfnt_headerrec">FT_WinFNT_HeaderRec</a></code> structure.</p> 1277<hr> 1278 1279<h2 id="ft_get_winfnt_header">FT_Get_WinFNT_Header<a class="headerlink" href="#ft_get_winfnt_header" title="Permanent link">¶</a></h2> 1280<p>Defined in FT_WINFONTS_H (freetype/ftwinfnt.h).</p> 1281<div class = "codehilite"><pre><code> FT_EXPORT( <a href="ft2-basic_types.html#ft_error">FT_Error</a> ) 1282 <b>FT_Get_WinFNT_Header</b>( <a href="ft2-base_interface.html#ft_face">FT_Face</a> face, 1283 <a href="ft2-winfnt_fonts.html#ft_winfnt_headerrec">FT_WinFNT_HeaderRec</a> *aheader ); 1284</code></pre></div> 1285 1286<p>Retrieve a Windows FNT font info header.</p> 1287<h4>input</h4> 1288 1289<table class="fields"> 1290<tr><td class="val" id="face">face</td><td class="desc"> 1291<p>A handle to the input face.</p> 1292</td></tr> 1293</table> 1294 1295<h4>output</h4> 1296 1297<table class="fields"> 1298<tr><td class="val" id="aheader">aheader</td><td class="desc"> 1299<p>The WinFNT header.</p> 1300</td></tr> 1301</table> 1302 1303<h4>return</h4> 1304 1305<p>FreeType error code. 0 means success.</p> 1306<h4>note</h4> 1307 1308<p>This function only works with Windows FNT faces, returning an error otherwise.</p> 1309<hr> 1310 1311 1312 1313 1314 1315 1316 1317 1318 1319 1320 </article> 1321 </div> 1322 </div> 1323 </main> 1324 1325 1326<footer class="md-footer"> 1327 1328 <div class="md-footer-nav"> 1329 <nav class="md-footer-nav__inner md-grid"> 1330 1331 <a href="ft2-pfr_fonts.html" title="PFR Fonts" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev"> 1332 <div class="md-flex__cell md-flex__cell--shrink"> 1333 <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i> 1334 </div> 1335 <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title"> 1336 <span class="md-flex__ellipsis"> 1337 <span class="md-footer-nav__direction"> 1338 Previous 1339 </span> 1340 PFR Fonts 1341 </span> 1342 </div> 1343 </a> 1344 1345 1346 <a href="ft2-font_formats.html" title="Font Formats" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next"> 1347 <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title"> 1348 <span class="md-flex__ellipsis"> 1349 <span class="md-footer-nav__direction"> 1350 Next 1351 </span> 1352 Font Formats 1353 </span> 1354 </div> 1355 <div class="md-flex__cell md-flex__cell--shrink"> 1356 <i class="md-icon md-icon--arrow-forward md-footer-nav__button"></i> 1357 </div> 1358 </a> 1359 1360 </nav> 1361 </div> 1362 1363 <div class="md-footer-meta md-typeset"> 1364 <div class="md-footer-meta__inner md-grid"> 1365 <div class="md-footer-copyright"> 1366 1367 <div class="md-footer-copyright__highlight"> 1368 Copyright 2020 <a href = "https://www.freetype.org/license.html">The FreeType Project</a>. 1369 </div> 1370 1371 powered by 1372 <a href="https://www.mkdocs.org" target="_blank" rel="noopener">MkDocs</a> 1373 and 1374 <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener"> 1375 Material for MkDocs</a> 1376 </div> 1377 1378 </div> 1379 </div> 1380</footer> 1381 1382 </div> 1383 1384 <script src="assets/javascripts/application.c33a9706.js"></script> 1385 1386 <script>app.initialize({version:"1.1",url:{base:"."}})</script> 1387 1388 <script src="javascripts/extra.js"></script> 1389 1390 1391 </body> 1392</html>