SYNOPSIS

ttfautohintGUI [OPTION]...

DESCRIPTION

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.

OPTIONS

-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

--help-all

show Qt and X11 specific options also

-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: "")

Qt Options:

--graphicssystem=SYSTEM

select a different graphics system backend instead of the default one (possible values: `raster', `opengl')

--reverse

set layout direction to right-to-left

--session=ID

restore the application for the given ID

--style=STYLE

set application GUI style (possible values: motif, windows, platinum)

--stylesheet=SHEET

apply the given Qt stylesheet to the application widgets

X11 options:

--background=COLOR

set the default background color and an application palette (light and dark shades are calculated)

--bg=COLOR

same as --background

--btn=COLOR

set the default button color

--button=COLOR

same as --btn

--cmap

use a private color map on an 8-bit display

--display=NAME

use the given X-server display

--fg=COLOR

set the default foreground color

--fn=FONTNAME

set the application font

--font=FONTNAME

same as --fn

--foreground=COLOR

same as --fg

--geometry=GEOMETRY

set the client geometry of first window

--im=SERVER

set the X Input Method (XIM) server

--inputstyle=STYLE

set X Input Method input style (possible values: onthespot, overthespot, offthespot, root)

--name=NAME

set the application name

--ncols=COUNT

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

--title=TITLE

set the application title (caption)

--visual=VISUAL

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, 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 command-line version of this program is called `ttfautohint'.

REPORTING BUGS

Report bugs to: [email protected] ttfautohint home page: <http://www.freetype.org/ttfautohint>

COPYRIGHT

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.