NAME¶

ttfautohint - add new, auto-generated hints to a TrueType font

SYNOPSIS¶

ttfautohint [ OPTION]... [IN-FILE [OUT-FILE]]

DESCRIPTION¶

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.

OPTIONS¶

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

REPORTING BUGS¶

Report bugs to: freetype-devel@nongnu.org ttfautohint home page: <http://www.freetype.org/ttfautohint>

COPYRIGHT¶

Copyright © 2011-2013 Werner Lemberg <wl@gnu.org>. 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.