1FTBENCH(1)                  General Commands Manual                 FTBENCH(1)
2
3
4

NAME

6       ftbench - benchmark some common FreeType paths
7

SYNOPSIS

9       ftbench [options] fontname
10

DESCRIPTION

12       The  ftbench  tool  measures performance of some common FreeType opera‐
13       tions.
14
15       This program is part of the FreeType demos package.
16

OPTIONS

18       -a "axis1 axis2 ..."
19              For Multiple Master, GX, or OpenType  variation  fonts,  specify
20              design  coordinates  for each axis at start-up.  Ignored for all
21              other font formats.
22
23       -b tests
24              Perform chosen tests:
25
26              a   load glyphs (FT_Load_Glyph)
27              b   load advance widths (FT_Get_Advances)
28              c   render glyphs (FT_Render_Glyph)
29              d   load glyphs (FT_Get_Glyph)
30              e   get glyph indices (FT_Get_Char_Index)
31              f   iterate CMap (FT_Get_{First,Next}_Char)
32              g   open a new face (FT_New_Face or FT_New_Memory_Face)
33              h   embolden glyphs (FT_GlyphSlot_Embolden)
34              i   stroke glyphs (FT_Glyph_Stroke)
35              j   get glyph bboxes (FT_Outline_Get_BBox)
36              k   get glyph cboxes (FT_Glyph_Get_CBox)
37              l   open a new face and load glyphs
38
39              (default is abcdefghijkl, this is, all tests).
40
41              The number of used glyphs per test (within a  single  iteration)
42              is given by option -i.
43
44       -C     Compare with cached version if available.
45
46       -c N   Use at most N iterations for each test (0 means time limited).
47
48       -e E   Use charmap with index E instead of the default unicode.
49
50       -f L   Use hexadecimal (not decimal) number L as load flags (see the `‐
51              FT_LOAD_XXX' macros in the FreeType reference).
52
53       -H name
54              Using CFF hinting engine name.  Available versions are depending
55              on  compilation options of FreeType; call ftbench without an ar‐
56              gument to get the actual list.
57
58       -I ver Using TT interpreter version ver.  Available  versions  are  de‐
59              pending on compilation options of FreeType; call ftbench without
60              an argument to get the actual list.
61
62       -i I-J Forward or reverse range of glyph indices  to  use  (default  is
63              from 0 to the number of glyphs minus one).
64
65       -m M   Set maximum cache size to M KiByte (default is 1024).
66
67       -p     Preload font file in memory (this is, testing FT_New_Memory_Face
68              instead of FT_New_Face).
69
70       -r R   Set render mode to R:
71
72              0   normal
73              1   light
74              2   mono
75              3   horizontal LCD
76              4   vertical LCD
77
78              (default is 0).  This corresponds to  the  values  of  the  `FT_
79              RENDER_MODE_XXX' flags.
80
81       -s S   Use  S  ppem  as face size (default is 10ppem).  If set to zero,
82              don't call FT_Set_Pixel_Sizes.  Use value 0 with  option  `-f 1'
83              or  something similar to load the glyphs unscaled, otherwise er‐
84              rors will show up.
85
86       -t T   Use at most T seconds per test (default is 2).
87
88       -v     Show version.
89
90
91
92FreeType 2.13.1                    June 2023                        FTBENCH(1)
Impressum