Add new, auto-generated hints to a truetype font
ttfautohint [OPTION]... [IN-FILE [OUT-FILE]]
Replace hints in TrueType font IN-FILE and write output to OUT-FILE. If OUT-FILE is missing, standard output is used instead; if IN-FILE is missing also, standard input and output are used.
The new hints are based on FreeType's auto-hinter.
This program is a simple front-end to the `ttfautohint' library.
Long options can be given with one or two dashes, and with and without equal sign between option and argument. This means that the following forms are acceptable: `-foo=bar', `--foo=bar', `-foo bar', `--foo bar'.
Mandatory arguments to long options are mandatory for short options too.
--debug
print debugging information
-c, --composites
hint glyph composites also
-d, --dehint
remove all hints
-f, --fallback-script=S
set fallback script (default: dflt)
-G, --hinting-limit=N
switch off hinting above this PPEM value (default: 200); value 0 means no limit
-h, --help
display this help and exit
-i, --ignore-restrictions
override font license restrictions
-l, --hinting-range-min=N
the minimum PPEM value for hint sets (default: 8)
-n, --no-info
don't add ttfautohint info to the version string(s) in the `name' table
-p, --pre-hinting
apply original hints in advance
-r, --hinting-range-max=N
the maximum PPEM value for hint sets (default: 50)
-s, --symbol
input is symbol font
-v, --verbose
show progress information
-V, --version
print version information and exit
-w, --strong-stem-width=S
use strong stem width routine for modes S, where S is a string of up to three letters with possible values `g' for grayscale, `G' for GDI ClearType, and `D' for DirectWrite ClearType (default: G)
-W, --windows-compatibility
add blue zones for `usWinAscent' and `usWinDescent' to avoid clipping
-x, --increase-x-height=N
increase x height for sizes in the range 6<=PPEM<=N; value 0 switches off this feature (default: 14)
-X, --x-height-snapping-exceptions=STRING
specify a comma-separated list of x-height snapping exceptions, for example "-9, 13-17, 19" (default: "")
The program accepts both TTF and TTC files as input. Use option -i only if you have a legal permission to modify the font. The used PPEM value for option -p is FUnits per em, normally 2048. With option -s, use default values for standard stem width and height, otherwise they are derived from script-specific characters resembling the shape of character `o'.
A hint set contains the optimal hinting for a certain PPEM value; the larger the hint set range, the more hint sets get computed, usually increasing the output font size. Note, however, that the `gasp' table of the output file enables grayscale hinting for all sizes (limited by option -G, which is handled in the bytecode).
Option -f takes a four-letter string that identifies the script to be used as a fallback for glyphs that have character codes outside of known script ranges. Possible values are
cyrl (Cyrillic), dflt (no script), grek (Greek), hebr (Hebrew), latn (Latin).
If no option -f is given, or if its value is `dflt', no fallback script is used.
A GUI version of this program is called `ttfautohintGUI'.
Report bugs to: [email protected] ttfautohint home page: <http://www.freetype.org/ttfautohint>
Copyright © 2011-2013 Werner Lemberg <[email protected]>. License: FreeType License (FTL) or GNU GPLv2.
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.