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 option -i.
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       -e E   Use charmap with index E instead of the default unicode.
44
45       -f L   Use hexadecimal (not decimal) number L as load flags (see the `‐
46              FT_LOAD_XXX' macros in the FreeType reference).
47
48       -H name
49              Using CFF hinting engine name.  Available versions are depending
50              on  compilation options of FreeType; call ftbench without an ar‐
51              gument to get the actual list.
52
53       -I ver Using TT interpreter version ver.  Available  versions  are  de‐
54              pending on compilation options of FreeType; call ftbench without
55              an argument to get the actual list.
56
57       -i I-J Forward or reverse range of glyph indices  to  use  (default  is
58              from 0 to the number of glyphs minus one).
59
60       -m M   Set maximum cache size to M KiByte (default is 1024).
61
62       -p     Preload font file in memory (this is, testing FT_New_Memory_Face
63              instead of FT_New_Face).
64
65       -r R   Set render mode to R:
66
67              0   normal
68              1   light
69              2   mono
70              3   horizontal LCD
71              4   vertical LCD
72
73              (default is 0).  This corresponds to  the  values  of  the  `FT_
74              RENDER_MODE_XXX' flags.
75
76       -s S   Use  S  ppem  as face size (default is 10ppem).  If set to zero,
77              don't call FT_Set_Pixel_Sizes.  Use value 0 with  option  `-f 1'
78              or  something similar to load the glyphs unscaled, otherwise er‐
79              rors will show up.
80
81       -t T   Use at most T seconds per test (default is 2).
82
83       -v     Show version.
84
85
86
87FreeType 2.13.0                  February 2023                      FTBENCH(1)