1TTFAUTOHINTGUI(1) User Commands TTFAUTOHINTGUI(1)
2
3
4
6 ttfautohintGUI - add new, auto-generated hints to a TrueType font
7
9 ttfautohintGUI [OPTION]...
10
12 A GUI application to replace hints in a TrueType font.
13
14 The new hints are based on FreeType's auto-hinter.
15
16 This program is a simple front-end to the `ttfautohint' library.
17
18 Long options can be given with one or two dashes, and with and without
19 equal sign between option and argument. This means that the following
20 forms are acceptable: `-foo=bar', `--foo=bar', `-foo bar', `--foo bar'.
21
22 Mandatory arguments to long options are mandatory for short options
23 too. Options not related to Qt or X11 set default values.
24
26 -a, --stem-width-mode=S
27 select stem width mode for grayscale, GDI ClearType, and DW
28 ClearType, where S is a string of three letters with possible
29 values `n' for natural, `q' for quantized, and `s' for strong
30 (default: qsq)
31
32 -c, --composites
33 hint glyph composites also
34
35 -d, --dehint
36 remove all hints
37
38 -D, --default-script=S
39 set default OpenType script (default: latn)
40
41 -f, --fallback-script=S
42 set fallback script (default: none)
43
44 -F, --family-suffix=S
45 append suffix to the family name string(s) in the `name' table
46
47 -G, --hinting-limit=N
48 switch off hinting above this PPEM value (default: 200); value 0
49 means no limit
50
51 -h, --help
52 display this help and exit
53
54 -H, --fallback-stem-width=N
55 set fallback stem width (default: 50 font units at 2048 UPEM)
56
57 --help-all
58 show Qt and X11 specific options also
59
60 -i, --ignore-restrictions
61 override font license restrictions
62
63 -I, --detailed-info
64 add detailed ttfautohint info to the version string(s) in the
65 `name' table
66
67 -l, --hinting-range-min=N
68 the minimum PPEM value for hint sets (default: 8)
69
70 -n, --no-info
71 don't add ttfautohint info to the version string(s) in the
72 `name' table
73
74 -p, --adjust-subglyphs
75 handle subglyph adjustments in exotic fonts
76
77 -r, --hinting-range-max=N
78 the maximum PPEM value for hint sets (default: 50)
79
80 -s, --symbol
81 input is symbol font
82
83 -S, --fallback-scaling
84 use fallback scaling, not hinting
85
86 -t, --ttfa-table
87 add TTFA information table
88
89 -v, --verbose
90 show progress information
91
92 -V, --version
93 print version information and exit
94
95 -W, --windows-compatibility
96 add blue zones for `usWinAscent' and `usWinDescent' to avoid
97 clipping
98
99 -x, --increase-x-height=N
100 increase x height for sizes in the range 6<=PPEM<=N; value 0
101 switches off this feature (default: 14)
102
103 -X, --x-height-snapping-exceptions=STRING
104 specify a comma-separated list of x-height snapping exceptions,
105 for example "-9, 13-17, 19" (default: "")
106
107 Qt Options:
108 --reverse
109 set layout direction to right-to-left
110
111 --style=STYLE
112 set application GUI style (available values like `windows' or
113 `gtk' depend on Qt version and installed plug-ins)
114
115 --stylesheet=SHEET
116 apply the given Qt stylesheet to the application widgets
117
118 The program accepts both TTF and TTC files as input. Use option -i
119 only if you have a legal permission to modify the font. The used PPEM
120 value for option -p is FUnits per em, normally 2048. With option -s,
121 use default values for standard stem width and height, otherwise they
122 are derived from script-specific characters resembling the shape of
123 character `o'.
124
125 A hint set contains the optimal hinting for a certain PPEM value; the
126 larger the hint set range (as given by options -l and -r), the more
127 hint sets get computed, usually increasing the output font size. The
128 `gasp' table of the output file always enables grayscale hinting for
129 all sizes (limited by option -G, which is handled in the bytecode).
130 Increasing the value of -G does not increase the output font size.
131
132 Options -f and -D take a four-letter string that identifies a script.
133 Option -f sets the script used as a fallback for glyphs that can't be
134 associated with a known script. By default, such glyphs are hinted; if
135 option -S is set, they are scaled only instead. Option -D sets the de‐
136 fault script for handling OpenType features.
137
138 Possible four-letter string values are
139
140 adlm (Adlam), arab (Arabic), armn (Armenian), avst (Avestan),
141 bamu (Bamum), beng (Bengali), buhd (Buhid), cakm (Chakma), cans
142 (Canadian Syllabics), cari (Carian), cher (Cherokee), copt (Cop‐
143 tic), cprt (Cypriot), cyrl (Cyrillic), deva (Devanagari), dsrt
144 (Deseret), ethi (Ethiopic), geor (Georgian (Mkhedruli)), geok
145 (Georgian (Khutsuri)), glag (Glagolitic), goth (Gothic), grek
146 (Greek), gujr (Gujarati), guru (Gurmukhi), hebr (Hebrew), hmnp
147 (Nyiakeng Puachue Hmong), kali (Kayah Li), khmr (Khmer), khms
148 (Khmer Symbols), knda (Kannada), lao (Lao), latn (Latin), latb
149 (Latin Subscript Fallback), latp (Latin Superscript Fallback),
150 lisu (Lisu), mlym (Malayalam), medf (Medefaidrin), mong (Mongo‐
151 lian), mymr (Myanmar), nkoo (N'Ko), olck (Ol Chiki), orkh (Old
152 Turkic), osge (Osage), osma (Osmanya), rohg (Hanifi Rohingya),
153 saur (Saurashtra), shaw (Shavian), sinh (Sinhala), sund (Sun‐
154 danese), taml (Tamil), tavt (Tai Viet), telu (Telugu), tfng (Ti‐
155 finagh), thai (Thai), vaii (Vai), yezi (Yezidi), none (no
156 script).
157
158 A command-line version of this program is called `ttfautohint'.
159
161 Report bugs to: freetype-devel@nongnu.org
162
163 ttfautohint home page: <https://www.freetype.org/ttfautohint>
164
166 Copyright © 2011-2021 Werner Lemberg <wl@gnu.org>. License: FreeType
167 License (FTL) or GNU GPLv2.
168 This is free software: you are free to change and redistribute it.
169 There is NO WARRANTY, to the extent permitted by law.
170
171
172
173ttfautohintGUI 1.8.4 August 2021 TTFAUTOHINTGUI(1)