Scroll to navigation

FTBENCH(1) General Commands Manual FTBENCH(1)

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

For Multiple Master, GX, or OpenType variation fonts, specify design coordinates for each axis at start-up. Ignored for all other font formats.
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.
Compare with cached version if available.
Use at most N iterations for each test (0 means time limited).
Use charmap with index E instead of the default unicode.
Use hexadecimal (not decimal) number L as load flags (see the `FT_LOAD_XXX' macros in the FreeType reference).
Using CFF hinting engine name. Available versions are depending on compilation options of FreeType; call ftbench without an argument to get the actual list.
Using TT interpreter version ver. Available versions are depending on compilation options of FreeType; call ftbench without an argument to get the actual list.
Forward or reverse range of glyph indices to use (default is from 0 to the number of glyphs minus one).
Set maximum cache size to M KiByte (default is 1024).
Preload font file in memory (this is, testing FT_New_Memory_Face instead of FT_New_Face).
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.
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.
Use at most T seconds per test (default is 2).
Show version.
August 2023 FreeType 2.13.2