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
- -a axis1,axis2,...
-
For Multiple Master, GX, or OpenType variation fonts, specify design coordinates for each axis at start-up. Ignored for all other font formats.
- -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 option -i.
- -C
-
Compare with cached version if available.
- -c N
-
Use at most N iterations for each test (0 means time limited).
- -e E
-
Use charmap with index E instead of the default unicode.
- -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 R
-
Set render mode to R:
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.