FTBENCH
Section: User Commands (1)
Updated: October 2020
Page Index
NAME
ftbench - benchmark some common FreeType paths
SYNOPSIS
ftbench
[
options]
fontname
DESCRIPTION
The
ftbench
tool measures performance of some common FreeType operations.
This program is part of the FreeType demos package.
OPTIONS
- -b tests
-
Perform chosen tests:
-
| a | load glyphs (FT_Load_Glyph)
|
| b | load advance widths (FT_Get_Advances)
|
| c | render glyphs (FT_Render_Glyph)
|
| d | load glyphs (FT_Get_Glyph)
|
| e | get glyph indices (FT_Get_Char_Index)
|
| f | iterate CMap (FT_Get_{First,Next}_Char)
|
| g | open a new face (FT_New_Face or FT_New_Memory_Face)
|
| h | embolden glyphs (FT_GlyphSlot_Embolden)
|
| i | stroke glyphs (FT_Glyph_Stroke)
|
| j | get glyph bboxes (FT_Outline_Get_BBox)
|
| k | get glyph cboxes (FT_Glyph_Get_CBox)
|
| l | open a new face and load glyphs
|
-
(default is
abcdefghijkl,
this is, all tests).
-
The number of used glyphs per test (within a single iteration) is given by
options
-i
and
-j.
- -C
-
Compare with cached version if available.
- -c n
-
Use at most
n
iterations for each test (0 means time limited).
- -f l
-
Use
hexadecimal
(not decimal) number
l
as load flags (see the
`FT_LOAD_XXX'
macros in the FreeType reference).
- -H name
-
Using CFF hinting engine
name.
Available versions are depending on compilation options of FreeType;
call
ftbench
without an argument to get the actual list.
- -I ver
-
Using TT interpreter version
ver.
Available versions are depending on compilation options of FreeType;
call
ftbench
without an argument to get the actual list.
- -i I-J
-
Forward or reverse range of glyph indices to use
(default is from 0 to the number of glyphs minus one).
- -m m
-
Set maximum cache size to
M
KiByte (default is 1024).
- -p
-
Preload font file in memory (this is, testing
FT_New_Memory_Face
instead of
FT_New_Face).
- -r n
-
Set render mode to
n:
-
| 0 | normal
|
| 1 | light
|
| 2 | mono
|
| 3 | horizontal LCD
|
| 4 | vertical LCD
|
-
(default is 0).
This corresponds to the values of the
`FT_RENDER_MODE_XXX'
flags.
- -s s
-
Use
s
ppem as face size (default is 10ppem).
If set to zero, don't call
FT_Set_Pixel_Sizes.
Use value 0 with option
`-f 1'
or something similar to load the glyphs unscaled,
otherwise errors will show up.
- -t t
-
Use at most
t
seconds per test (default is 2).
- -v
-
Show version.