File: ttfautohintGUI.1

package info (click to toggle)
ttfautohint 1.6-1
  • links: PTS, VCS
  • area: main
  • in suites: stretch
  • size: 8,504 kB
  • ctags: 4,347
  • sloc: ansic: 38,386; sh: 5,749; cpp: 4,131; perl: 340; makefile: 309; sed: 39
file content (253 lines) | stat: -rw-r--r-- 7,412 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.3.
.TH TTFAUTOHINTGUI "1" "November 2016" "ttfautohintGUI 1.6" "User Commands"
.SH NAME
ttfautohintGUI \- add new, auto-generated hints to a TrueType font
.SH SYNOPSIS
.B ttfautohintGUI
[\fI\,OPTION\/\fR]...
.SH DESCRIPTION
A GUI application to replace hints in a TrueType font.
.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.
Options not related to Qt or X11 set default values.
.SH OPTIONS
.TP
\fB\-c\fR, \fB\-\-composites\fR
hint glyph composites also
.TP
\fB\-d\fR, \fB\-\-dehint\fR
remove all hints
.TP
\fB\-D\fR, \fB\-\-default\-script\fR=\fI\,S\/\fR
set default OpenType script (default: latn)
.TP
\fB\-f\fR, \fB\-\-fallback\-script\fR=\fI\,S\/\fR
set fallback script (default: none)
.TP
\fB\-F\fR, \fB\-\-family\-suffix\fR=\fI\,S\/\fR
append suffix to the family name string(s)
in the `name' table
.TP
\fB\-G\fR, \fB\-\-hinting\-limit\fR=\fI\,N\/\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\-H\fR, \fB\-\-fallback\-stem\-width\fR=\fI\,N\/\fR
set fallback stem width
(default: 50 font units at 2048 UPEM)
.TP
\fB\-\-help\-all\fR
show Qt and X11 specific options also
.TP
\fB\-i\fR, \fB\-\-ignore\-restrictions\fR
override font license restrictions
.TP
\fB\-I\fR, \fB\-\-detailed\-info\fR
add detailed ttfautohint info
to the version string(s) in the `name' table
.TP
\fB\-l\fR, \fB\-\-hinting\-range\-min\fR=\fI\,N\/\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\-\-adjust\-subglyphs\fR
handle subglyph adjustments in exotic fonts
.TP
\fB\-r\fR, \fB\-\-hinting\-range\-max\fR=\fI\,N\/\fR
the maximum PPEM value for hint sets
(default: 50)
.TP
\fB\-s\fR, \fB\-\-symbol\fR
input is symbol font
.TP
\fB\-S\fR, \fB\-\-fallback\-scaling\fR
use fallback scaling, not hinting
.TP
\fB\-t\fR, \fB\-\-ttfa\-table\fR
add TTFA information table
.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=\fI\,S\/\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=\fI\,N\/\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=\fI\,STRING\/\fR
specify a comma\-separated list of
x\-height snapping exceptions, for example
"\-9, 13\-17, 19" (default: "")
.SS "Qt Options:"
.TP
\fB\-\-graphicssystem\fR=\fI\,SYSTEM\/\fR
select a different graphics system backend
instead of the default one
(possible values: `raster', `opengl')
.TP
\fB\-\-reverse\fR
set layout direction to right\-to\-left
.TP
\fB\-\-session\fR=\fI\,ID\/\fR
restore the application for the given ID
.TP
\fB\-\-style\fR=\fI\,STYLE\/\fR
set application GUI style
(possible values: motif, windows, platinum)
.TP
\fB\-\-stylesheet\fR=\fI\,SHEET\/\fR
apply the given Qt stylesheet
to the application widgets
.SS "X11 options:"
.TP
\fB\-\-background\fR=\fI\,COLOR\/\fR
set the default background color
and an application palette
(light and dark shades are calculated)
.TP
\fB\-\-bg\fR=\fI\,COLOR\/\fR
same as \fB\-\-background\fR
.TP
\fB\-\-btn\fR=\fI\,COLOR\/\fR
set the default button color
.TP
\fB\-\-button\fR=\fI\,COLOR\/\fR
same as \fB\-\-btn\fR
.TP
\fB\-\-cmap\fR
use a private color map on an 8\-bit display
.TP
\fB\-\-display\fR=\fI\,NAME\/\fR
use the given X\-server display
.TP
\fB\-\-fg\fR=\fI\,COLOR\/\fR
set the default foreground color
.TP
\fB\-\-fn\fR=\fI\,FONTNAME\/\fR
set the application font
.TP
\fB\-\-font\fR=\fI\,FONTNAME\/\fR
same as \fB\-\-fn\fR
.TP
\fB\-\-foreground\fR=\fI\,COLOR\/\fR
same as \fB\-\-fg\fR
.TP
\fB\-\-geometry\fR=\fI\,GEOMETRY\/\fR
set the client geometry of first window
.TP
\fB\-\-im\fR=\fI\,SERVER\/\fR
set the X Input Method (XIM) server
.TP
\fB\-\-inputstyle\fR=\fI\,STYLE\/\fR
set X Input Method input style
(possible values: onthespot, overthespot,
offthespot, root)
.TP
\fB\-\-name\fR=\fI\,NAME\/\fR
set the application name
.TP
\fB\-\-ncols\fR=\fI\,COUNT\/\fR
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
.TP
\fB\-\-title\fR=\fI\,TITLE\/\fR
set the application title (caption)
.TP
\fB\-\-visual\fR=\fI\,VISUAL\/\fR
force the application
to use the given visual on an 8\-bit display
(only possible value: TrueColor)
.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 (as given by options \fB\-l\fR and \fB\-r\fR),
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 \fB\-G\fR, which is handled in the bytecode).
Increasing the value of \fB\-G\fR does not increase the output font size.
.PP
Options \fB\-f\fR and \fB\-D\fR take a four\-letter string that identifies a script.
Option \fB\-f\fR sets the script used as a fallback for glyphs that can't be
associated with a known script.  By default, such glyphs are hinted;
if option \fB\-S\fR is set, they are scaled only instead.  Option \fB\-D\fR sets the
default script for handling OpenType features.
.PP
Possible four\-letter string values are
.IP
arab (Arabic),
armn (Armenian),
beng (Bengali),
cher (Cherokee),
cyrl (Cyrillic),
deva (Devanagari),
ethi (Ethiopic),
geor (Georgian (Mkhedruli)),
geok (Georgian (Khutsuri)),
grek (Greek),
gujr (Gujarati),
guru (Gurmukhi),
hebr (Hebrew),
knda (Kannada),
khmr (Khmer),
khms (Khmer Symbols),
lao (Lao),
latn (Latin),
latb (Latin Subscript Fallback),
latp (Latin Superscript Fallback),
mlym (Malayalam),
mymr (Myanmar),
sinh (Sinhala),
taml (Tamil),
telu (Telugu),
thai (Thai),
none (no script).
.PP
A command\-line version of this program is called `ttfautohint'.
.SH "REPORTING BUGS"
Report bugs to: freetype\-devel@nongnu.org
.PP
ttfautohint home page: <http://www.freetype.org/ttfautohint>
.SH COPYRIGHT
Copyright \(co 2011\-2016 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.