.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.40.12.
.TH TTFAUTOHINT "1" "November 2013" "ttfautohint 0.97" "User Commands"
.SH NAME
ttfautohint \- add new, auto-generated hints to a TrueType font
.SH SYNOPSIS
.B ttfautohint
[\fIOPTION\fR]... [\fIIN-FILE \fR[\fIOUT-FILE\fR]]
.SH 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.
.PP
The new hints are based on FreeType's auto\-hinter.
.PP
This program is a simple front\-end to the `ttfautohint' library.
.PP
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'.
.PP
Mandatory arguments to long options are mandatory for short options too.
.SH OPTIONS
.TP
\fB\-\-debug\fR
print debugging information
.TP
\fB\-c\fR, \fB\-\-composites\fR
hint glyph composites also
.TP
\fB\-d\fR, \fB\-\-dehint\fR
remove all hints
.TP
\fB\-f\fR, \fB\-\-fallback\-script\fR=\fIS\fR
set fallback script (default: dflt)
.TP
\fB\-G\fR, \fB\-\-hinting\-limit\fR=\fIN\fR
switch off hinting above this PPEM value
(default: 200); value 0 means no limit
.TP
\fB\-h\fR, \fB\-\-help\fR
display this help and exit
.TP
\fB\-i\fR, \fB\-\-ignore\-restrictions\fR
override font license restrictions
.TP
\fB\-l\fR, \fB\-\-hinting\-range\-min\fR=\fIN\fR
the minimum PPEM value for hint sets
(default: 8)
.TP
\fB\-n\fR, \fB\-\-no\-info\fR
don't add ttfautohint info
to the version string(s) in the `name' table
.TP
\fB\-p\fR, \fB\-\-pre\-hinting\fR
apply original hints in advance
.TP
\fB\-r\fR, \fB\-\-hinting\-range\-max\fR=\fIN\fR
the maximum PPEM value for hint sets
(default: 50)
.TP
\fB\-s\fR, \fB\-\-symbol\fR
input is symbol font
.TP
\fB\-v\fR, \fB\-\-verbose\fR
show progress information
.TP
\fB\-V\fR, \fB\-\-version\fR
print version information and exit
.TP
\fB\-w\fR, \fB\-\-strong\-stem\-width\fR=\fIS\fR
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)
.TP
\fB\-W\fR, \fB\-\-windows\-compatibility\fR
add blue zones for `usWinAscent' and
`usWinDescent' to avoid clipping
.TP
\fB\-x\fR, \fB\-\-increase\-x\-height\fR=\fIN\fR
increase x height for sizes in the range
6<=PPEM<=N; value 0 switches off this feature
(default: 14)
.TP
\fB\-X\fR, \fB\-\-x\-height\-snapping\-exceptions\fR=\fISTRING\fR
specify a comma\-separated list of
x\-height snapping exceptions, for example
"\-9, 13\-17, 19" (default: "")
.PP
The program accepts both TTF and TTC files as input.
Use option \fB\-i\fR only if you have a legal permission to modify the font.
The used PPEM value for option \fB\-p\fR is FUnits per em, normally 2048.
With option \fB\-s\fR, use default values for standard stem width and height,
otherwise they are derived from script\-specific characters
resembling the shape of character `o'.
.PP
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 \fB\-G\fR, which is handled in the bytecode).
.PP
Option \fB\-f\fR 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
.IP
cyrl (Cyrillic),
dflt (no script),
grek (Greek),
hebr (Hebrew),
latn (Latin).
.PP
If no option \fB\-f\fR is given, or if its value is `dflt',
no fallback script is used.
.PP
A GUI version of this program is called `ttfautohintGUI'.
.SH "REPORTING BUGS"
Report bugs to: freetype\-devel@nongnu.org
ttfautohint home page: <http://www.freetype.org/ttfautohint>
.SH COPYRIGHT
Copyright \(co 2011\-2013 Werner Lemberg <wl@gnu.org>.
License: FreeType License (FTL) or GNU GPLv2.
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.