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

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.
Compare with cached version if available.
Use at most n iterations for each test (0 means time limited).
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 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.
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.
May 2022 Freetype 2.12.1