2
.\" ttx is not specific to any OS, but contrary to what groff_mdoc(7)
3
.\" seems to imply, entirely omitting the .Os macro causes 'BSD' to
4
.\" be used, so I give a zero-width space as its argument.
6
.\" The "FontTools Manual" argument apparently has no effect in
7
.\" groff 1.18.1. I think it is a bug in the -mdoc groff package.
8
.Dt TTX 1 "FontTools Manual"
11
.Nd tool for manipulating TrueType and OpenType fonts
22
is a tool for manipulating TrueType and OpenType fonts. It can convert
23
TrueType and OpenType fonts to and from an
24
.Tn XML Ns -based format called
35
detects whether it is a
40
file and acts accordingly: if it is a
54
By default, every output file is created in the same directory as the
55
corresponding input file and with the same name except for the
56
extension, which is substituted appropriately.
58
never overwrites existing files; if neccesary, it appends a suffix to
59
the output file name before the extension, as in
62
.Bl -tag -width ".Fl t Ar table"
64
Display usage information.
66
Write the output files to directory
68
instead of writing every output file to the same directory as the
69
corresponding input file.
71
Be verbose. Write more messages to the standard output describing what
74
Allow virtual glyphs ID's on compile or decompile.
77
The following options control the process of dumping font files
78
(TrueType or OpenType) to
81
.Bl -tag -width ".Fl t Ar table"
83
List table information. Instead of dumping the font to a
85
file, display minimal information about each table.
89
This option may be given multiple times to dump several tables at
90
once. When not specified, all tables are dumped.
94
from the list of tables to dump. This option may be given multiple
95
times to exclude several tables from the dump. The
99
options are mutually exclusive.
101
Split tables. Dump each table to a separate
103
file and write (under the name that would have been used for the output
106
option had not been given) one small
108
file containing references to the individual table dump files. This
109
file can be used as input to
111
as long as the referenced files can be found in the same directory.
113
.\" XXX: I suppose OpenType programs (exist and) are also affected.
114
Don't disassemble TrueType instructions. When this option is specified,
115
all TrueType programs (glyph programs, the font program and the
116
pre-program) are written to the
118
file as hexadecimal data instead of
119
assembly. This saves some time and results in smaller
123
Don't ignore decompilation errors, but show a full traceback and abort.
125
.Ss "Compilation options"
126
The following options control the process of compiling
128
files into font files (TrueType or OpenType):
129
.Bl -tag -width ".Fl t Ar table"
139
argument can be specified when this option is used.
141
Don't recalculate glyph bounding boxes. Use the values in the
145
.Sh "THE TTX FILE FORMAT"
146
You can find some information about the
149
.Pa documentation.html .
150
In particular, you will find in that file the list of tables understood by
152
and the relations between TrueType GlyphIDs and the glyph names used in
156
In the following examples, all files are read from and written to the
157
current directory. Additionally, the name given for the output file
158
assumes in every case that it did not exist before
162
Dump the TrueType font contained in
171
into a TrueType or OpenType font file:
177
along with some information:
179
.Dl ttx -l FreeSans.ttf
188
.Dl ttx -t cmap FreeSans.ttf
190
On MS\-Windows and MacOS,
192
is available as a graphical application to which files can be dropped.
194
.Pa documentation.html
205
.An "Just van Rossum" Aq just@letterror.com .
207
This manual page was written by
208
.An "Florent Rougon" Aq f.rougon@free.fr
209
for the Debian GNU/Linux system based on the existing FontTools
210
documentation. It may be freely used, modified and distributed without
215
.\" sentence-end: "[.?!][]\"')}]*\\($\\| $\\| \\| \\)[ \n]*"
216
.\" sentence-end-double-space: t