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 cboxes (FT_Glyph_Get_CBox) |
| f |
get glyph indices (FT_Get_Char_Index) |
| g |
iterate CMap (FT_Get_{First,Next}_Char) |
| h |
open a new face (FT_New_Face or FT_New_Memory_Face) |
| i |
embolden glyphs (FT_GlyphSlot_Embolden) |
| j |
get glyph bboxes (FT_Outline_Get_BBox) |
| k |
open a new face and load glyphs |
- (default is abcdefghijk, 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 idx
- Start with glyph index idx (default is 0).
- -j idx
- End with glyph index idx (default is 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.
