ftbench(1)

benchmark some common FreeType paths

Section 1 freetype2-demos bookworm source

Description

FTBENCH

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:

Image grohtml-12393-1.png

(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:

Image grohtml-12393-2.png

(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.