[ftbench README] enhanced.

This commit is contained in:
goksu 2023-09-25 13:33:57 +03:00
parent 25bcda3a05
commit 8ca5bb5bf1
No known key found for this signature in database
1 changed files with 15 additions and 9 deletions

View File

@ -1,17 +1,18 @@
ftbench
========
ftbench is a program designed to run FreeType benchmarks. It accepts various options and a font name to run specific tests on font rendering operations.
ftbench is a program designed to run FreeType benchmarks between versions.
It accepts various options to run specific tests on font rendering operations.
Each test may involve tasks such as:
. Initializing the library
. Opening the font file
. Loading and optionally rendering each glyph
. Comparing results with cached versions (if available)
. Configuring specific charmap indices, load flags, etc.
Usage is time-limited or can be explicitly set to use a maximum number of iterations per test.
Usage is iterations-limited or can be explicitly set to use a maximum
number of iterations per test.
Command line options
@ -20,7 +21,8 @@ Command line options
-C Compare with cached version (if available).
-c N Use at most N iterations for each test (0 means time-limited).
-e E Set specific charmap index E.
-f L Use hex number L as load flags (see FT_LOAD_XXX'). -H NAME Use PS hinting engine NAME (default is adobe').
-f L Use hex number L as load flags (see FT_LOAD_XXX').
-H NAME Use PS hinting engine NAME (default is adobe').
-I VER Use TT interpreter version VER (default is version 40).
-i I-J Forward or reverse range of glyph indices to use.
-l N Set LCD filter to N (default is 0: none).
@ -34,12 +36,16 @@ Command line options
-b tests Perform chosen tests (default is all).
-v Show version.
Compilation
Usage
-----------
make baseline To create a baseline for your benchmarks, use the `make baseline` command. This will compile the ftbench.c and create a set of baseline measurements in the objs/baseline/ directory.
make baseline <flags> To create a baseline for your benchmarks,
use the `make baseline` command. This will compile the ftbench.c and
create a set of baseline measurements in the objs/baseline/ directory.
make benchmark To run the benchmarks, use the `make benchmark` command. The results will be stored in the objs/benchmark/ directory. It will copy tohtml.py script to objs/ and generate a html file.
make clean-benchmark To remove all generated benchmark files and clean the objs directory, use the `make clean-benchmark` command.
make benchmark <flags> To run the benchmarks, use the `make benchmark` command.
The results will be stored in the objs/benchmark/ directory.
It will copy tohtml.py script to objs/ and generate a html file.
make clean-benchmark To remove all generated benchmark files and
clean the objs directory, use the `make clean-benchmark` command.