• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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>FreeType Version - 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="#freetype-version" 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                FreeType Version
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        &#xE5CD;
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
259
260  <li class="md-nav__item md-nav__item--active md-nav__item--nested">
261
262      <input class="md-toggle md-nav__toggle" data-md-toggle="nav-4" type="checkbox" id="nav-4" checked>
263
264    <label class="md-nav__link" for="nav-4">
265      Core API
266    </label>
267    <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
268      <label class="md-nav__title" for="nav-4">
269        Core API
270      </label>
271      <ul class="md-nav__list" data-md-scrollfix>
272
273
274
275
276
277
278
279
280
281  <li class="md-nav__item md-nav__item--active">
282
283    <input class="md-toggle md-nav__toggle" data-md-toggle="toc" type="checkbox" id="__toc">
284
285
286
287
288      <label class="md-nav__link md-nav__link--active" for="__toc">
289        FreeType Version
290      </label>
291
292    <a href="ft2-version.html" title="FreeType Version" class="md-nav__link md-nav__link--active">
293      FreeType Version
294    </a>
295
296
297<nav class="md-nav md-nav--secondary">
298
299
300
301
302
303    <label class="md-nav__title" for="__toc">Table of contents</label>
304    <ul class="md-nav__list" data-md-scrollfix>
305
306        <li class="md-nav__item">
307  <a href="#synopsis" class="md-nav__link">
308    Synopsis
309  </a>
310
311</li>
312
313        <li class="md-nav__item">
314  <a href="#ft_library_version" class="md-nav__link">
315    FT_Library_Version
316  </a>
317
318</li>
319
320        <li class="md-nav__item">
321  <a href="#ft_face_checktruetypepatents" class="md-nav__link">
322    FT_Face_CheckTrueTypePatents
323  </a>
324
325</li>
326
327        <li class="md-nav__item">
328  <a href="#ft_face_setunpatentedhinting" class="md-nav__link">
329    FT_Face_SetUnpatentedHinting
330  </a>
331
332</li>
333
334        <li class="md-nav__item">
335  <a href="#freetype_xxx" class="md-nav__link">
336    FREETYPE_XXX
337  </a>
338
339</li>
340
341
342
343
344
345    </ul>
346
347</nav>
348
349  </li>
350
351
352
353
354
355
356
357  <li class="md-nav__item">
358    <a href="ft2-basic_types.html" title="Basic Data Types" class="md-nav__link">
359      Basic Data Types
360    </a>
361  </li>
362
363
364
365
366
367
368
369  <li class="md-nav__item">
370    <a href="ft2-base_interface.html" title="Base Interface" class="md-nav__link">
371      Base Interface
372    </a>
373  </li>
374
375
376
377
378
379
380
381  <li class="md-nav__item">
382    <a href="ft2-glyph_variants.html" title="Unicode Variation Sequences" class="md-nav__link">
383      Unicode Variation Sequences
384    </a>
385  </li>
386
387
388
389
390
391
392
393  <li class="md-nav__item">
394    <a href="ft2-color_management.html" title="Glyph Color Management" class="md-nav__link">
395      Glyph Color Management
396    </a>
397  </li>
398
399
400
401
402
403
404
405  <li class="md-nav__item">
406    <a href="ft2-layer_management.html" title="Glyph Layer Management" class="md-nav__link">
407      Glyph Layer Management
408    </a>
409  </li>
410
411
412
413
414
415
416
417  <li class="md-nav__item">
418    <a href="ft2-glyph_management.html" title="Glyph Management" class="md-nav__link">
419      Glyph Management
420    </a>
421  </li>
422
423
424
425
426
427
428
429  <li class="md-nav__item">
430    <a href="ft2-mac_specific.html" title="Mac Specific Interface" class="md-nav__link">
431      Mac Specific Interface
432    </a>
433  </li>
434
435
436
437
438
439
440
441  <li class="md-nav__item">
442    <a href="ft2-sizes_management.html" title="Size Management" class="md-nav__link">
443      Size Management
444    </a>
445  </li>
446
447
448
449
450
451
452
453  <li class="md-nav__item">
454    <a href="ft2-header_file_macros.html" title="Header File Macros" class="md-nav__link">
455      Header File Macros
456    </a>
457  </li>
458
459
460      </ul>
461    </nav>
462  </li>
463
464
465
466
467
468
469
470  <li class="md-nav__item md-nav__item--nested">
471
472      <input class="md-toggle md-nav__toggle" data-md-toggle="nav-5" type="checkbox" id="nav-5">
473
474    <label class="md-nav__link" for="nav-5">
475      Format-Specific API
476    </label>
477    <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
478      <label class="md-nav__title" for="nav-5">
479        Format-Specific API
480      </label>
481      <ul class="md-nav__list" data-md-scrollfix>
482
483
484
485
486
487
488
489  <li class="md-nav__item">
490    <a href="ft2-multiple_masters.html" title="Multiple Masters" class="md-nav__link">
491      Multiple Masters
492    </a>
493  </li>
494
495
496
497
498
499
500
501  <li class="md-nav__item">
502    <a href="ft2-truetype_tables.html" title="TrueType Tables" class="md-nav__link">
503      TrueType Tables
504    </a>
505  </li>
506
507
508
509
510
511
512
513  <li class="md-nav__item">
514    <a href="ft2-type1_tables.html" title="Type 1 Tables" class="md-nav__link">
515      Type 1 Tables
516    </a>
517  </li>
518
519
520
521
522
523
524
525  <li class="md-nav__item">
526    <a href="ft2-sfnt_names.html" title="SFNT Names" class="md-nav__link">
527      SFNT Names
528    </a>
529  </li>
530
531
532
533
534
535
536
537  <li class="md-nav__item">
538    <a href="ft2-bdf_fonts.html" title="BDF and PCF Files" class="md-nav__link">
539      BDF and PCF Files
540    </a>
541  </li>
542
543
544
545
546
547
548
549  <li class="md-nav__item">
550    <a href="ft2-cid_fonts.html" title="CID Fonts" class="md-nav__link">
551      CID Fonts
552    </a>
553  </li>
554
555
556
557
558
559
560
561  <li class="md-nav__item">
562    <a href="ft2-pfr_fonts.html" title="PFR Fonts" class="md-nav__link">
563      PFR Fonts
564    </a>
565  </li>
566
567
568
569
570
571
572
573  <li class="md-nav__item">
574    <a href="ft2-winfnt_fonts.html" title="Window FNT Files" class="md-nav__link">
575      Window FNT Files
576    </a>
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_library_version" class="md-nav__link">
1082    FT_Library_Version
1083  </a>
1084
1085</li>
1086
1087        <li class="md-nav__item">
1088  <a href="#ft_face_checktruetypepatents" class="md-nav__link">
1089    FT_Face_CheckTrueTypePatents
1090  </a>
1091
1092</li>
1093
1094        <li class="md-nav__item">
1095  <a href="#ft_face_setunpatentedhinting" class="md-nav__link">
1096    FT_Face_SetUnpatentedHinting
1097  </a>
1098
1099</li>
1100
1101        <li class="md-nav__item">
1102  <a href="#freetype_xxx" class="md-nav__link">
1103    FREETYPE_XXX
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> &raquo; <a href="../">Docs</a> &raquo; <a href="index.html#core-api">Core API</a> &raquo; FreeType Version</p>
1126<hr />
1127<h1 id="freetype-version">FreeType Version<a class="headerlink" href="#freetype-version" title="Permanent link">&para;</a></h1>
1128<h2 id="synopsis">Synopsis<a class="headerlink" href="#synopsis" title="Permanent link">&para;</a></h2>
1129<p>Note that those functions and macros are of limited use because even a new release of FreeType with only documentation changes increases the version number.</p>
1130<h2 id="ft_library_version">FT_Library_Version<a class="headerlink" href="#ft_library_version" title="Permanent link">&para;</a></h2>
1131<p>Defined in FT_FREETYPE_H (freetype/freetype.h).</p>
1132<div class = "codehilite"><pre><code>  FT_EXPORT( <span class="keyword">void</span> )
1133  <b>FT_Library_Version</b>( <a href="ft2-base_interface.html#ft_library">FT_Library</a>   library,
1134                      <a href="ft2-basic_types.html#ft_int">FT_Int</a>      *amajor,
1135                      <a href="ft2-basic_types.html#ft_int">FT_Int</a>      *aminor,
1136                      <a href="ft2-basic_types.html#ft_int">FT_Int</a>      *apatch );
1137</code></pre></div>
1138
1139<p>Return the version of the FreeType library being used. This is useful when dynamically linking to the library, since one cannot use the macros <code><a href="ft2-version.html#freetype_xxx">FREETYPE_MAJOR</a></code>, <code><a href="ft2-version.html#freetype_xxx">FREETYPE_MINOR</a></code>, and <code><a href="ft2-version.html#freetype_xxx">FREETYPE_PATCH</a></code>.</p>
1140<h4>input</h4>
1141
1142<table class="fields">
1143<tr><td class="val" id="library">library</td><td class="desc">
1144<p>A source library handle.</p>
1145</td></tr>
1146</table>
1147
1148<h4>output</h4>
1149
1150<table class="fields">
1151<tr><td class="val" id="amajor">amajor</td><td class="desc">
1152<p>The major version number.</p>
1153</td></tr>
1154<tr><td class="val" id="aminor">aminor</td><td class="desc">
1155<p>The minor version number.</p>
1156</td></tr>
1157<tr><td class="val" id="apatch">apatch</td><td class="desc">
1158<p>The patch version number.</p>
1159</td></tr>
1160</table>
1161
1162<h4>note</h4>
1163
1164<p>The reason why this function takes a <code>library</code> argument is because certain programs implement library initialization in a custom way that doesn't use <code><a href="ft2-base_interface.html#ft_init_freetype">FT_Init_FreeType</a></code>.</p>
1165<p>In such cases, the library version might not be available before the library object has been created.</p>
1166<hr>
1167
1168<h2 id="ft_face_checktruetypepatents">FT_Face_CheckTrueTypePatents<a class="headerlink" href="#ft_face_checktruetypepatents" title="Permanent link">&para;</a></h2>
1169<p>Defined in FT_FREETYPE_H (freetype/freetype.h).</p>
1170<div class = "codehilite"><pre><code>  FT_EXPORT( <a href="ft2-basic_types.html#ft_bool">FT_Bool</a> )
1171  <b>FT_Face_CheckTrueTypePatents</b>( <a href="ft2-base_interface.html#ft_face">FT_Face</a>  face );
1172</code></pre></div>
1173
1174<p>Deprecated, does nothing.</p>
1175<h4>input</h4>
1176
1177<table class="fields">
1178<tr><td class="val" id="face">face</td><td class="desc">
1179<p>A face handle.</p>
1180</td></tr>
1181</table>
1182
1183<h4>return</h4>
1184
1185<p>Always returns false.</p>
1186<h4>note</h4>
1187
1188<p>Since May 2010, TrueType hinting is no longer patented.</p>
1189<h4>since</h4>
1190
1191<p>2.3.5</p>
1192<hr>
1193
1194<h2 id="ft_face_setunpatentedhinting">FT_Face_SetUnpatentedHinting<a class="headerlink" href="#ft_face_setunpatentedhinting" title="Permanent link">&para;</a></h2>
1195<p>Defined in FT_FREETYPE_H (freetype/freetype.h).</p>
1196<div class = "codehilite"><pre><code>  FT_EXPORT( <a href="ft2-basic_types.html#ft_bool">FT_Bool</a> )
1197  <b>FT_Face_SetUnpatentedHinting</b>( <a href="ft2-base_interface.html#ft_face">FT_Face</a>  face,
1198                                <a href="ft2-basic_types.html#ft_bool">FT_Bool</a>  value );
1199</code></pre></div>
1200
1201<p>Deprecated, does nothing.</p>
1202<h4>input</h4>
1203
1204<table class="fields">
1205<tr><td class="val" id="face">face</td><td class="desc">
1206<p>A face handle.</p>
1207</td></tr>
1208<tr><td class="val" id="value">value</td><td class="desc">
1209<p>New boolean setting.</p>
1210</td></tr>
1211</table>
1212
1213<h4>return</h4>
1214
1215<p>Always returns false.</p>
1216<h4>note</h4>
1217
1218<p>Since May 2010, TrueType hinting is no longer patented.</p>
1219<h4>since</h4>
1220
1221<p>2.3.5</p>
1222<hr>
1223
1224<h2 id="freetype_xxx">FREETYPE_XXX<a class="headerlink" href="#freetype_xxx" title="Permanent link">&para;</a></h2>
1225<p>Defined in FT_FREETYPE_H (freetype/freetype.h).</p>
1226<div class = "codehilite"><pre><code>#<span class="keyword">define</span> <a href="ft2-version.html#freetype_major">FREETYPE_MAJOR</a>  2
1227#<span class="keyword">define</span> <a href="ft2-version.html#freetype_minor">FREETYPE_MINOR</a>  10
1228#<span class="keyword">define</span> <a href="ft2-version.html#freetype_patch">FREETYPE_PATCH</a>  4
1229</code></pre></div>
1230
1231<p>These three macros identify the FreeType source code version. Use <code><a href="ft2-version.html#ft_library_version">FT_Library_Version</a></code> to access them at runtime.</p>
1232<h4>values</h4>
1233
1234<table class="fields">
1235<tr><td class="val" id="freetype_major">FREETYPE_MAJOR</td><td class="desc">
1236<p>The major version number.</p>
1237</td></tr>
1238<tr><td class="val" id="freetype_minor">FREETYPE_MINOR</td><td class="desc">
1239<p>The minor version number.</p>
1240</td></tr>
1241<tr><td class="val" id="freetype_patch">FREETYPE_PATCH</td><td class="desc">
1242<p>The patch level.</p>
1243</td></tr>
1244</table>
1245
1246<h4>note</h4>
1247
1248<p>The version number of FreeType if built as a dynamic link library with the &lsquo;libtool&rsquo; package is <em>not</em> controlled by these three macros.</p>
1249<hr>
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260            </article>
1261          </div>
1262        </div>
1263      </main>
1264
1265
1266<footer class="md-footer">
1267
1268    <div class="md-footer-nav">
1269      <nav class="md-footer-nav__inner md-grid">
1270
1271          <a href="ft2-user_allocation.html" title="User allocation" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
1272            <div class="md-flex__cell md-flex__cell--shrink">
1273              <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
1274            </div>
1275            <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
1276              <span class="md-flex__ellipsis">
1277                <span class="md-footer-nav__direction">
1278                  Previous
1279                </span>
1280                User allocation
1281              </span>
1282            </div>
1283          </a>
1284
1285
1286          <a href="ft2-basic_types.html" title="Basic Data Types" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
1287            <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
1288              <span class="md-flex__ellipsis">
1289                <span class="md-footer-nav__direction">
1290                  Next
1291                </span>
1292                Basic Data Types
1293              </span>
1294            </div>
1295            <div class="md-flex__cell md-flex__cell--shrink">
1296              <i class="md-icon md-icon--arrow-forward md-footer-nav__button"></i>
1297            </div>
1298          </a>
1299
1300      </nav>
1301    </div>
1302
1303  <div class="md-footer-meta md-typeset">
1304    <div class="md-footer-meta__inner md-grid">
1305      <div class="md-footer-copyright">
1306
1307          <div class="md-footer-copyright__highlight">
1308            Copyright 2020 <a href = "https://www.freetype.org/license.html">The FreeType Project</a>.
1309          </div>
1310
1311        powered by
1312        <a href="https://www.mkdocs.org" target="_blank" rel="noopener">MkDocs</a>
1313        and
1314        <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
1315          Material for MkDocs</a>
1316      </div>
1317
1318    </div>
1319  </div>
1320</footer>
1321
1322    </div>
1323
1324      <script src="assets/javascripts/application.c33a9706.js"></script>
1325
1326      <script>app.initialize({version:"1.1",url:{base:"."}})</script>
1327
1328        <script src="javascripts/extra.js"></script>
1329
1330
1331  </body>
1332</html>