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>Error Code Values - 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="#error-code-values" 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 Error Code Values 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 <li class="md-nav__item md-nav__item--nested"> 403 404 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-5" type="checkbox" id="nav-5"> 405 406 <label class="md-nav__link" for="nav-5"> 407 Format-Specific API 408 </label> 409 <nav class="md-nav" data-md-component="collapsible" data-md-level="1"> 410 <label class="md-nav__title" for="nav-5"> 411 Format-Specific API 412 </label> 413 <ul class="md-nav__list" data-md-scrollfix> 414 415 416 417 418 419 420 421 <li class="md-nav__item"> 422 <a href="ft2-multiple_masters.html" title="Multiple Masters" class="md-nav__link"> 423 Multiple Masters 424 </a> 425 </li> 426 427 428 429 430 431 432 433 <li class="md-nav__item"> 434 <a href="ft2-truetype_tables.html" title="TrueType Tables" class="md-nav__link"> 435 TrueType Tables 436 </a> 437 </li> 438 439 440 441 442 443 444 445 <li class="md-nav__item"> 446 <a href="ft2-type1_tables.html" title="Type 1 Tables" class="md-nav__link"> 447 Type 1 Tables 448 </a> 449 </li> 450 451 452 453 454 455 456 457 <li class="md-nav__item"> 458 <a href="ft2-sfnt_names.html" title="SFNT Names" class="md-nav__link"> 459 SFNT Names 460 </a> 461 </li> 462 463 464 465 466 467 468 469 <li class="md-nav__item"> 470 <a href="ft2-bdf_fonts.html" title="BDF and PCF Files" class="md-nav__link"> 471 BDF and PCF Files 472 </a> 473 </li> 474 475 476 477 478 479 480 481 <li class="md-nav__item"> 482 <a href="ft2-cid_fonts.html" title="CID Fonts" class="md-nav__link"> 483 CID Fonts 484 </a> 485 </li> 486 487 488 489 490 491 492 493 <li class="md-nav__item"> 494 <a href="ft2-pfr_fonts.html" title="PFR Fonts" class="md-nav__link"> 495 PFR Fonts 496 </a> 497 </li> 498 499 500 501 502 503 504 505 <li class="md-nav__item"> 506 <a href="ft2-winfnt_fonts.html" title="Window FNT Files" class="md-nav__link"> 507 Window FNT Files 508 </a> 509 </li> 510 511 512 513 514 515 516 517 <li class="md-nav__item"> 518 <a href="ft2-font_formats.html" title="Font Formats" class="md-nav__link"> 519 Font Formats 520 </a> 521 </li> 522 523 524 525 526 527 528 529 <li class="md-nav__item"> 530 <a href="ft2-gasp_table.html" title="Gasp Table" class="md-nav__link"> 531 Gasp Table 532 </a> 533 </li> 534 535 536 </ul> 537 </nav> 538 </li> 539 540 541 542 543 544 545 546 <li class="md-nav__item md-nav__item--nested"> 547 548 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-6" type="checkbox" id="nav-6"> 549 550 <label class="md-nav__link" for="nav-6"> 551 Controlling FreeType Modules 552 </label> 553 <nav class="md-nav" data-md-component="collapsible" data-md-level="1"> 554 <label class="md-nav__title" for="nav-6"> 555 Controlling FreeType Modules 556 </label> 557 <ul class="md-nav__list" data-md-scrollfix> 558 559 560 561 562 563 564 565 <li class="md-nav__item"> 566 <a href="ft2-auto_hinter.html" title="The auto-hinter" class="md-nav__link"> 567 The auto-hinter 568 </a> 569 </li> 570 571 572 573 574 575 576 577 <li class="md-nav__item"> 578 <a href="ft2-cff_driver.html" title="The CFF driver" class="md-nav__link"> 579 The CFF driver 580 </a> 581 </li> 582 583 584 585 586 587 588 589 <li class="md-nav__item"> 590 <a href="ft2-t1_cid_driver.html" title="The Type 1 and CID drivers" class="md-nav__link"> 591 The Type 1 and CID drivers 592 </a> 593 </li> 594 595 596 597 598 599 600 601 <li class="md-nav__item"> 602 <a href="ft2-tt_driver.html" title="The TrueType driver" class="md-nav__link"> 603 The TrueType driver 604 </a> 605 </li> 606 607 608 609 610 611 612 613 <li class="md-nav__item"> 614 <a href="ft2-pcf_driver.html" title="The PCF driver" class="md-nav__link"> 615 The PCF driver 616 </a> 617 </li> 618 619 620 621 622 623 624 625 <li class="md-nav__item"> 626 <a href="ft2-properties.html" title="Driver properties" class="md-nav__link"> 627 Driver properties 628 </a> 629 </li> 630 631 632 633 634 635 636 637 <li class="md-nav__item"> 638 <a href="ft2-parameter_tags.html" title="Parameter Tags" class="md-nav__link"> 639 Parameter Tags 640 </a> 641 </li> 642 643 644 645 646 647 648 649 <li class="md-nav__item"> 650 <a href="ft2-lcd_rendering.html" title="Subpixel Rendering" class="md-nav__link"> 651 Subpixel Rendering 652 </a> 653 </li> 654 655 656 </ul> 657 </nav> 658 </li> 659 660 661 662 663 664 665 666 <li class="md-nav__item md-nav__item--nested"> 667 668 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-7" type="checkbox" id="nav-7"> 669 670 <label class="md-nav__link" for="nav-7"> 671 Cache Sub-System 672 </label> 673 <nav class="md-nav" data-md-component="collapsible" data-md-level="1"> 674 <label class="md-nav__title" for="nav-7"> 675 Cache Sub-System 676 </label> 677 <ul class="md-nav__list" data-md-scrollfix> 678 679 680 681 682 683 684 685 <li class="md-nav__item"> 686 <a href="ft2-cache_subsystem.html" title="Cache Sub-System" class="md-nav__link"> 687 Cache Sub-System 688 </a> 689 </li> 690 691 692 </ul> 693 </nav> 694 </li> 695 696 697 698 699 700 701 702 <li class="md-nav__item md-nav__item--nested"> 703 704 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-8" type="checkbox" id="nav-8"> 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 <li class="md-nav__item"> 758 <a href="ft2-quick_advance.html" title="Quick retrieval of advance values" class="md-nav__link"> 759 Quick retrieval of advance values 760 </a> 761 </li> 762 763 764 765 766 767 768 769 <li class="md-nav__item"> 770 <a href="ft2-bitmap_handling.html" title="Bitmap Handling" class="md-nav__link"> 771 Bitmap Handling 772 </a> 773 </li> 774 775 776 777 778 779 780 781 <li class="md-nav__item"> 782 <a href="ft2-raster.html" title="Scanline Converter" class="md-nav__link"> 783 Scanline Converter 784 </a> 785 </li> 786 787 788 789 790 791 792 793 <li class="md-nav__item"> 794 <a href="ft2-glyph_stroker.html" title="Glyph Stroker" class="md-nav__link"> 795 Glyph Stroker 796 </a> 797 </li> 798 799 800 801 802 803 804 805 <li class="md-nav__item"> 806 <a href="ft2-system_interface.html" title="System Interface" class="md-nav__link"> 807 System Interface 808 </a> 809 </li> 810 811 812 813 814 815 816 817 <li class="md-nav__item"> 818 <a href="ft2-module_management.html" title="Module Management" class="md-nav__link"> 819 Module Management 820 </a> 821 </li> 822 823 824 825 826 827 828 829 <li class="md-nav__item"> 830 <a href="ft2-gzip.html" title="GZIP Streams" class="md-nav__link"> 831 GZIP Streams 832 </a> 833 </li> 834 835 836 837 838 839 840 841 <li class="md-nav__item"> 842 <a href="ft2-lzw.html" title="LZW Streams" class="md-nav__link"> 843 LZW Streams 844 </a> 845 </li> 846 847 848 849 850 851 852 853 <li class="md-nav__item"> 854 <a href="ft2-bzip2.html" title="BZIP2 Streams" class="md-nav__link"> 855 BZIP2 Streams 856 </a> 857 </li> 858 859 860 </ul> 861 </nav> 862 </li> 863 864 865 866 867 868 869 870 871 872 <li class="md-nav__item md-nav__item--active md-nav__item--nested"> 873 874 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-9" type="checkbox" id="nav-9" checked> 875 876 <label class="md-nav__link" for="nav-9"> 877 Error Codes 878 </label> 879 <nav class="md-nav" data-md-component="collapsible" data-md-level="1"> 880 <label class="md-nav__title" for="nav-9"> 881 Error Codes 882 </label> 883 <ul class="md-nav__list" data-md-scrollfix> 884 885 886 887 888 889 890 891 <li class="md-nav__item"> 892 <a href="ft2-error_enumerations.html" title="Error Enumerations" class="md-nav__link"> 893 Error Enumerations 894 </a> 895 </li> 896 897 898 899 900 901 902 903 904 905 <li class="md-nav__item md-nav__item--active"> 906 907 <input class="md-toggle md-nav__toggle" data-md-toggle="toc" type="checkbox" id="__toc"> 908 909 910 911 912 <label class="md-nav__link md-nav__link--active" for="__toc"> 913 Error Code Values 914 </label> 915 916 <a href="ft2-error_code_values.html" title="Error Code Values" class="md-nav__link md-nav__link--active"> 917 Error Code Values 918 </a> 919 920 921<nav class="md-nav md-nav--secondary"> 922 923 924 925 926 927 <label class="md-nav__title" for="__toc">Table of contents</label> 928 <ul class="md-nav__list" data-md-scrollfix> 929 930 <li class="md-nav__item"> 931 <a href="#synopsis" class="md-nav__link"> 932 Synopsis 933 </a> 934 935</li> 936 937 <li class="md-nav__item"> 938 <a href="#ft_err_xxx" class="md-nav__link"> 939 FT_Err_XXX 940 </a> 941 942</li> 943 944 945 946 947 948 </ul> 949 950</nav> 951 952 </li> 953 954 955 </ul> 956 </nav> 957 </li> 958 959 960 961 962 963 964 965 <li class="md-nav__item md-nav__item--nested"> 966 967 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-10" type="checkbox" id="nav-10"> 968 969 <label class="md-nav__link" for="nav-10"> 970 Miscellaneous 971 </label> 972 <nav class="md-nav" data-md-component="collapsible" data-md-level="1"> 973 <label class="md-nav__title" for="nav-10"> 974 Miscellaneous 975 </label> 976 <ul class="md-nav__list" data-md-scrollfix> 977 978 979 980 981 982 983 984 <li class="md-nav__item"> 985 <a href="ft2-gx_validation.html" title="TrueTypeGX/AAT Validation" class="md-nav__link"> 986 TrueTypeGX/AAT Validation 987 </a> 988 </li> 989 990 991 992 993 994 995 996 <li class="md-nav__item"> 997 <a href="ft2-incremental.html" title="Incremental Loading" class="md-nav__link"> 998 Incremental Loading 999 </a> 1000 </li> 1001 1002 1003 1004 1005 1006 1007 1008 <li class="md-nav__item"> 1009 <a href="ft2-truetype_engine.html" title="The TrueType Engine" class="md-nav__link"> 1010 The TrueType Engine 1011 </a> 1012 </li> 1013 1014 1015 1016 1017 1018 1019 1020 <li class="md-nav__item"> 1021 <a href="ft2-ot_validation.html" title="OpenType Validation" class="md-nav__link"> 1022 OpenType Validation 1023 </a> 1024 </li> 1025 1026 1027 </ul> 1028 </nav> 1029 </li> 1030 1031 1032 </ul> 1033</nav> 1034 </div> 1035 </div> 1036 </div> 1037 1038 1039 <div class="md-sidebar md-sidebar--secondary" data-md-component="toc"> 1040 <div class="md-sidebar__scrollwrap"> 1041 <div class="md-sidebar__inner"> 1042 1043<nav class="md-nav md-nav--secondary"> 1044 1045 1046 1047 1048 1049 <label class="md-nav__title" for="__toc">Table of contents</label> 1050 <ul class="md-nav__list" data-md-scrollfix> 1051 1052 <li class="md-nav__item"> 1053 <a href="#synopsis" class="md-nav__link"> 1054 Synopsis 1055 </a> 1056 1057</li> 1058 1059 <li class="md-nav__item"> 1060 <a href="#ft_err_xxx" class="md-nav__link"> 1061 FT_Err_XXX 1062 </a> 1063 1064</li> 1065 1066 1067 1068 1069 1070 </ul> 1071 1072</nav> 1073 </div> 1074 </div> 1075 </div> 1076 1077 1078 <div class="md-content"> 1079 <article class="md-content__inner md-typeset"> 1080 1081 1082 1083 <p><a href="https://www.freetype.org">FreeType</a> » <a href="../">Docs</a> » <a href="index.html#error-codes">Error Codes</a> » Error Code Values</p> 1084<hr /> 1085<h1 id="error-code-values">Error Code Values<a class="headerlink" href="#error-code-values" title="Permanent link">¶</a></h1> 1086<h2 id="synopsis">Synopsis<a class="headerlink" href="#synopsis" title="Permanent link">¶</a></h2> 1087<p>The list below is taken verbatim from the file <code>fterrdef.h</code> (loaded automatically by including <code>FT_FREETYPE_H</code>). The first argument of the <code>FT_ERROR_DEF_</code> macro is the error label; by default, the prefix <code>FT_Err_</code> gets added so that you get error names like <code>FT_Err_Cannot_Open_Resource</code>. The second argument is the error code, and the last argument an error string, which is not used by FreeType.</p> 1088<p>Within your application you should <strong>only</strong> use error names and <strong>never</strong> its numeric values! The latter might (and actually do) change in forthcoming FreeType versions.</p> 1089<p>Macro <code>FT_NOERRORDEF_</code> defines <code>FT_Err_Ok</code>, which is always zero. See the ‘Error Enumerations’ subsection how to automatically generate a list of error strings.</p> 1090<h2 id="ft_err_xxx">FT_Err_XXX<a class="headerlink" href="#ft_err_xxx" title="Permanent link">¶</a></h2> 1091<div class = "codehilite"><pre><code> /* generic errors */ 1092 1093 FT_NOERRORDEF_( Ok, 0x00, 1094 "no error" ) 1095 1096 FT_ERRORDEF_( Cannot_Open_Resource, 0x01, 1097 "cannot open resource" ) 1098 FT_ERRORDEF_( Unknown_File_Format, 0x02, 1099 "unknown file format" ) 1100 FT_ERRORDEF_( Invalid_File_Format, 0x03, 1101 "broken file" ) 1102 FT_ERRORDEF_( Invalid_Version, 0x04, 1103 "invalid FreeType version" ) 1104 FT_ERRORDEF_( Lower_Module_Version, 0x05, 1105 "module version is too low" ) 1106 FT_ERRORDEF_( Invalid_Argument, 0x06, 1107 "invalid argument" ) 1108 FT_ERRORDEF_( Unimplemented_Feature, 0x07, 1109 "unimplemented feature" ) 1110 FT_ERRORDEF_( Invalid_Table, 0x08, 1111 "broken table" ) 1112 FT_ERRORDEF_( Invalid_Offset, 0x09, 1113 "broken offset within table" ) 1114 FT_ERRORDEF_( Array_Too_Large, 0x0A, 1115 "array allocation size too large" ) 1116 FT_ERRORDEF_( Missing_Module, 0x0B, 1117 "missing module" ) 1118 FT_ERRORDEF_( Missing_Property, 0x0C, 1119 "missing property" ) 1120 1121 /* glyph/character errors */ 1122 1123 FT_ERRORDEF_( Invalid_Glyph_Index, 0x10, 1124 "invalid glyph index" ) 1125 FT_ERRORDEF_( Invalid_Character_Code, 0x11, 1126 "invalid character code" ) 1127 FT_ERRORDEF_( Invalid_Glyph_Format, 0x12, 1128 "unsupported glyph image format" ) 1129 FT_ERRORDEF_( Cannot_Render_Glyph, 0x13, 1130 "cannot render this glyph format" ) 1131 FT_ERRORDEF_( Invalid_Outline, 0x14, 1132 "invalid outline" ) 1133 FT_ERRORDEF_( Invalid_Composite, 0x15, 1134 "invalid composite glyph" ) 1135 FT_ERRORDEF_( Too_Many_Hints, 0x16, 1136 "too many hints" ) 1137 FT_ERRORDEF_( Invalid_Pixel_Size, 0x17, 1138 "invalid pixel size" ) 1139 1140 /* handle errors */ 1141 1142 FT_ERRORDEF_( Invalid_Handle, 0x20, 1143 "invalid object handle" ) 1144 FT_ERRORDEF_( Invalid_Library_Handle, 0x21, 1145 "invalid library handle" ) 1146 FT_ERRORDEF_( Invalid_Driver_Handle, 0x22, 1147 "invalid module handle" ) 1148 FT_ERRORDEF_( Invalid_Face_Handle, 0x23, 1149 "invalid face handle" ) 1150 FT_ERRORDEF_( Invalid_Size_Handle, 0x24, 1151 "invalid size handle" ) 1152 FT_ERRORDEF_( Invalid_Slot_Handle, 0x25, 1153 "invalid glyph slot handle" ) 1154 FT_ERRORDEF_( Invalid_CharMap_Handle, 0x26, 1155 "invalid charmap handle" ) 1156 FT_ERRORDEF_( Invalid_Cache_Handle, 0x27, 1157 "invalid cache manager handle" ) 1158 FT_ERRORDEF_( Invalid_Stream_Handle, 0x28, 1159 "invalid stream handle" ) 1160 1161 /* driver errors */ 1162 1163 FT_ERRORDEF_( Too_Many_Drivers, 0x30, 1164 "too many modules" ) 1165 FT_ERRORDEF_( Too_Many_Extensions, 0x31, 1166 "too many extensions" ) 1167 1168 /* memory errors */ 1169 1170 FT_ERRORDEF_( Out_Of_Memory, 0x40, 1171 "out of memory" ) 1172 FT_ERRORDEF_( Unlisted_Object, 0x41, 1173 "unlisted object" ) 1174 1175 /* stream errors */ 1176 1177 FT_ERRORDEF_( Cannot_Open_Stream, 0x51, 1178 "cannot open stream" ) 1179 FT_ERRORDEF_( Invalid_Stream_Seek, 0x52, 1180 "invalid stream seek" ) 1181 FT_ERRORDEF_( Invalid_Stream_Skip, 0x53, 1182 "invalid stream skip" ) 1183 FT_ERRORDEF_( Invalid_Stream_Read, 0x54, 1184 "invalid stream read" ) 1185 FT_ERRORDEF_( Invalid_Stream_Operation, 0x55, 1186 "invalid stream operation" ) 1187 FT_ERRORDEF_( Invalid_Frame_Operation, 0x56, 1188 "invalid frame operation" ) 1189 FT_ERRORDEF_( Nested_Frame_Access, 0x57, 1190 "nested frame access" ) 1191 FT_ERRORDEF_( Invalid_Frame_Read, 0x58, 1192 "invalid frame read" ) 1193 1194 /* raster errors */ 1195 1196 FT_ERRORDEF_( Raster_Uninitialized, 0x60, 1197 "raster uninitialized" ) 1198 FT_ERRORDEF_( Raster_Corrupted, 0x61, 1199 "raster corrupted" ) 1200 FT_ERRORDEF_( Raster_Overflow, 0x62, 1201 "raster overflow" ) 1202 FT_ERRORDEF_( Raster_Negative_Height, 0x63, 1203 "negative height while rastering" ) 1204 1205 /* cache errors */ 1206 1207 FT_ERRORDEF_( Too_Many_Caches, 0x70, 1208 "too many registered caches" ) 1209 1210 /* TrueType and SFNT errors */ 1211 1212 FT_ERRORDEF_( Invalid_Opcode, 0x80, 1213 "invalid opcode" ) 1214 FT_ERRORDEF_( Too_Few_Arguments, 0x81, 1215 "too few arguments" ) 1216 FT_ERRORDEF_( Stack_Overflow, 0x82, 1217 "stack overflow" ) 1218 FT_ERRORDEF_( Code_Overflow, 0x83, 1219 "code overflow" ) 1220 FT_ERRORDEF_( Bad_Argument, 0x84, 1221 "bad argument" ) 1222 FT_ERRORDEF_( Divide_By_Zero, 0x85, 1223 "division by zero" ) 1224 FT_ERRORDEF_( Invalid_Reference, 0x86, 1225 "invalid reference" ) 1226 FT_ERRORDEF_( Debug_OpCode, 0x87, 1227 "found debug opcode" ) 1228 FT_ERRORDEF_( ENDF_In_Exec_Stream, 0x88, 1229 "found ENDF opcode in execution stream" ) 1230 FT_ERRORDEF_( Nested_DEFS, 0x89, 1231 "nested DEFS" ) 1232 FT_ERRORDEF_( Invalid_CodeRange, 0x8A, 1233 "invalid code range" ) 1234 FT_ERRORDEF_( Execution_Too_Long, 0x8B, 1235 "execution context too <span class="keyword">long</span>" ) 1236 FT_ERRORDEF_( Too_Many_Function_Defs, 0x8C, 1237 "too many function definitions" ) 1238 FT_ERRORDEF_( Too_Many_Instruction_Defs, 0x8D, 1239 "too many instruction definitions" ) 1240 FT_ERRORDEF_( Table_Missing, 0x8E, 1241 "SFNT font table missing" ) 1242 FT_ERRORDEF_( Horiz_Header_Missing, 0x8F, 1243 "horizontal header (hhea) table missing" ) 1244 FT_ERRORDEF_( Locations_Missing, 0x90, 1245 "locations (loca) table missing" ) 1246 FT_ERRORDEF_( Name_Table_Missing, 0x91, 1247 "name table missing" ) 1248 FT_ERRORDEF_( CMap_Table_Missing, 0x92, 1249 "character map (cmap) table missing" ) 1250 FT_ERRORDEF_( Hmtx_Table_Missing, 0x93, 1251 "horizontal metrics (hmtx) table missing" ) 1252 FT_ERRORDEF_( Post_Table_Missing, 0x94, 1253 "PostScript (post) table missing" ) 1254 FT_ERRORDEF_( Invalid_Horiz_Metrics, 0x95, 1255 "invalid horizontal metrics" ) 1256 FT_ERRORDEF_( Invalid_CharMap_Format, 0x96, 1257 "invalid character map (cmap) format" ) 1258 FT_ERRORDEF_( Invalid_PPem, 0x97, 1259 "invalid ppem value" ) 1260 FT_ERRORDEF_( Invalid_Vert_Metrics, 0x98, 1261 "invalid vertical metrics" ) 1262 FT_ERRORDEF_( Could_Not_Find_Context, 0x99, 1263 "could not find context" ) 1264 FT_ERRORDEF_( Invalid_Post_Table_Format, 0x9A, 1265 "invalid PostScript (post) table format" ) 1266 FT_ERRORDEF_( Invalid_Post_Table, 0x9B, 1267 "invalid PostScript (post) table" ) 1268 FT_ERRORDEF_( DEF_In_Glyf_Bytecode, 0x9C, 1269 "found FDEF or IDEF opcode in glyf bytecode" ) 1270 FT_ERRORDEF_( Missing_Bitmap, 0x9D, 1271 "missing bitmap in strike" ) 1272 1273 /* CFF, CID, and Type 1 errors */ 1274 1275 FT_ERRORDEF_( Syntax_Error, 0xA0, 1276 "opcode syntax error" ) 1277 FT_ERRORDEF_( Stack_Underflow, 0xA1, 1278 "argument stack underflow" ) 1279 FT_ERRORDEF_( Ignore, 0xA2, 1280 "ignore" ) 1281 FT_ERRORDEF_( No_Unicode_Glyph_Name, 0xA3, 1282 "no Unicode glyph name found" ) 1283 FT_ERRORDEF_( Glyph_Too_Big, 0xA4, 1284 "glyph too big for hinting" ) 1285 1286 /* BDF errors */ 1287 1288 FT_ERRORDEF_( Missing_Startfont_Field, 0xB0, 1289 "`STARTFONT' field missing" ) 1290 FT_ERRORDEF_( Missing_Font_Field, 0xB1, 1291 "`FONT' field missing" ) 1292 FT_ERRORDEF_( Missing_Size_Field, 0xB2, 1293 "`SIZE' field missing" ) 1294 FT_ERRORDEF_( Missing_Fontboundingbox_Field, 0xB3, 1295 "`FONTBOUNDINGBOX' field missing" ) 1296 FT_ERRORDEF_( Missing_Chars_Field, 0xB4, 1297 "`CHARS' field missing" ) 1298 FT_ERRORDEF_( Missing_Startchar_Field, 0xB5, 1299 "`STARTCHAR' field missing" ) 1300 FT_ERRORDEF_( Missing_Encoding_Field, 0xB6, 1301 "`ENCODING' field missing" ) 1302 FT_ERRORDEF_( Missing_Bbx_Field, 0xB7, 1303 "`BBX' field missing" ) 1304 FT_ERRORDEF_( Bbx_Too_Big, 0xB8, 1305 "`BBX' too big" ) 1306 FT_ERRORDEF_( Corrupted_Font_Header, 0xB9, 1307 "Font header corrupted or missing fields" ) 1308 FT_ERRORDEF_( Corrupted_Font_Glyphs, 0xBA, 1309 "Font glyphs corrupted or missing fields" ) 1310</code></pre></div> 1311 1312<hr> 1313 1314 1315 1316 1317 1318 1319 1320 1321 1322 1323 </article> 1324 </div> 1325 </div> 1326 </main> 1327 1328 1329<footer class="md-footer"> 1330 1331 <div class="md-footer-nav"> 1332 <nav class="md-footer-nav__inner md-grid"> 1333 1334 <a href="ft2-error_enumerations.html" title="Error Enumerations" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev"> 1335 <div class="md-flex__cell md-flex__cell--shrink"> 1336 <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i> 1337 </div> 1338 <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title"> 1339 <span class="md-flex__ellipsis"> 1340 <span class="md-footer-nav__direction"> 1341 Previous 1342 </span> 1343 Error Enumerations 1344 </span> 1345 </div> 1346 </a> 1347 1348 1349 <a href="ft2-gx_validation.html" title="TrueTypeGX/AAT Validation" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next"> 1350 <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title"> 1351 <span class="md-flex__ellipsis"> 1352 <span class="md-footer-nav__direction"> 1353 Next 1354 </span> 1355 TrueTypeGX/AAT Validation 1356 </span> 1357 </div> 1358 <div class="md-flex__cell md-flex__cell--shrink"> 1359 <i class="md-icon md-icon--arrow-forward md-footer-nav__button"></i> 1360 </div> 1361 </a> 1362 1363 </nav> 1364 </div> 1365 1366 <div class="md-footer-meta md-typeset"> 1367 <div class="md-footer-meta__inner md-grid"> 1368 <div class="md-footer-copyright"> 1369 1370 <div class="md-footer-copyright__highlight"> 1371 Copyright 2020 <a href = "https://www.freetype.org/license.html">The FreeType Project</a>. 1372 </div> 1373 1374 powered by 1375 <a href="https://www.mkdocs.org" target="_blank" rel="noopener">MkDocs</a> 1376 and 1377 <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener"> 1378 Material for MkDocs</a> 1379 </div> 1380 1381 </div> 1382 </div> 1383</footer> 1384 1385 </div> 1386 1387 <script src="assets/javascripts/application.c33a9706.js"></script> 1388 1389 <script>app.initialize({version:"1.1",url:{base:"."}})</script> 1390 1391 <script src="javascripts/extra.js"></script> 1392 1393 1394 </body> 1395</html>