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