ttfautohintGUI(1) add new, auto-generated hints to a TrueType font


ttfautohintGUI [,OPTION/]...


A GUI application to replace hints in a TrueType font.

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 not related to Qt or X11 set default values.


-c, --composites
hint glyph composites also
-d, --dehint
remove all hints
-D, --default-script=,S/
set default OpenType script (default: latn)
-f, --fallback-script=,S/
set fallback script (default: none)
-F, --family-suffix=,S/
append suffix to the family name string(s) in the `name' table
-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
-H, --fallback-stem-width=,N/
set fallback stem width (default: 50 font units at 2048 UPEM)
show Qt and X11 specific options also
-i, --ignore-restrictions
override font license restrictions
-I, --detailed-info
add detailed ttfautohint info to the version string(s) in the `name' table
-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, --adjust-subglyphs
handle subglyph adjustments in exotic fonts
-r, --hinting-range-max=,N/
the maximum PPEM value for hint sets (default: 50)
-s, --symbol
input is symbol font
-t, --ttfa-table
add TTFA information table
-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: "")

Qt Options:

select a different graphics system backend instead of the default one (possible values: `raster', `opengl')
set layout direction to right-to-left
restore the application for the given ID
set application GUI style (possible values: motif, windows, platinum)
apply the given Qt stylesheet to the application widgets

X11 options:

set the default background color and an application palette (light and dark shades are calculated)
same as --background
set the default button color
same as --btn
use a private color map on an 8-bit display
use the given X-server display
set the default foreground color
set the application font
same as --fn
same as --fg
set the client geometry of first window
set the X Input Method (XIM) server
set X Input Method input style (possible values: onthespot, overthespot, offthespot, root)
set the application name
limit the number of colors allocated in the color cube on an 8-bit display, if the application is using the QApplication::ManyColor color specification
set the application title (caption)
force the application to use the given visual on an 8-bit display (only possible value: TrueColor)

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 (as given by options -l and -r), the more hint sets get computed, usually increasing the output font size. The `gasp' table of the output file always enables grayscale hinting for all sizes (limited by option -G, which is handled in the bytecode). Increasing the value of -G does not increase the output font size.

Options -f and -D take a four-letter string that identifies a script. Option -f sets the script used as a fallback for glyphs that have character codes outside of known script ranges. Option -D sets the default script for handling OpenType features. Possible values are

arab (Arabic), beng (Bengali), cyrl (Cyrillic), deva (Devanagari), grek (Greek), hebr (Hebrew), khmr (Khmer), khms (Khmer Symbols), lao (Lao), latn (Latin), latb (Latin Subscript Fallback), latp (Latin Superscript Fallback), mymr (Myanmar), telu (Telugu), thai (Thai), none (no script).

A command-line version of this program is called `ttfautohint'.


Report bugs to: [email protected]

ttfautohint home page: <>


Copyright © 2011-2016 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.