1TTX(1) BSD General Commands Manual TTX(1)
2
4 ttx — tool for manipulating TrueType and OpenType fonts
5
7 ttx [option ...] file ...
8
10 ttx is a tool for manipulating TrueType and OpenType fonts. It can con‐
11 vert TrueType and OpenType fonts to and from an XML-based format called
12 TTX. TTX files have a ‘.ttx’ extension.
13 For each file argument it is given, ttx detects whether it is a ‘.ttf’,
15 ‘.otf’ or ‘.ttx’ file and acts accordingly: if it is a ‘.ttf’ or ‘.otf’
16 file, it generates a ‘.ttx’ file; if it is a ‘.ttx’ file, it generates a
17 ‘.ttf’ or ‘.otf’ file.
18 By default, every output file is created in the same directory as the
20 corresponding input file and with the same name except for the extension,
21 which is substituted appropriately. ttx never overwrites existing files;
22 if necessary, it appends a suffix to the output file name before the
23 extension, as in Arial#1.ttf.
24 General options
26 -h Display usage information.
27 -d dir Write the output files to directory dir instead of writing
29 every output file to the same directory as the corresponding
30 input file.
31 -o file Write the output to file instead of writing it to the same
33 directory as the corresponding input file.
34 -v Be verbose. Write more messages to the standard output
36 describing what is being done.
37 -a Allow virtual glyphs ID's on compile or decompile.
39 Dump options
41 The following options control the process of dumping font files (TrueType
42 or OpenType) to TTX files.
43 -l List table information. Instead of dumping the font to a TTX
45 file, display minimal information about each table.
46 -t table Dump table table. This option may be given multiple times to
48 dump several tables at once. When not specified, all tables
49 are dumped.
50 -x table Exclude table table from the list of tables to dump. This
52 option may be given multiple times to exclude several tables
53 from the dump. The -t and -x options are mutually exclusive.
54 -s Split tables. Dump each table to a separate TTX file and write
56 (under the name that would have been used for the output file
57 if the -s option had not been given) one small TTX file con‐
58 taining references to the individual table dump files. This
59 file can be used as input to ttx as long as the referenced
60 files can be found in the same directory.
61 -i Don't disassemble TrueType instructions. When this option is
63 specified, all TrueType programs (glyph programs, the font pro‐
64 gram and the pre-program) are written to the TTX file as hexa‐
65 decimal data instead of assembly. This saves some time and
66 results in smaller TTX files.
67 -y n When decompiling a TrueType Collection (TTC) file, decompile
69 font number n, starting from 0.
70 Compilation options
72 The following options control the process of compiling TTX files into
73 font files (TrueType or OpenType):
74 -m fontfile
76 Merge the input TTX file file with fontfile. No more than one
77 file argument can be specified when this option is used.
78 -b Don't recalculate glyph bounding boxes. Use the values in the
80 TTX file as is.
81
83 You can find some information about the TTX file format in
84 documentation.html. In particular, you will find in that file the list
85 of tables understood by ttx and the relations between TrueType GlyphIDs
86 and the glyph names used in TTX files.
87
89 In the following examples, all files are read from and written to the
90 current directory. Additionally, the name given for the output file
91 assumes in every case that it did not exist before ttx was invoked.
92 Dump the TrueType font contained in FreeSans.ttf to FreeSans.ttx:
94 ttx FreeSans.ttf
96 Compile MyFont.ttx into a TrueType or OpenType font file:
98 ttx MyFont.ttx
100 List the tables in FreeSans.ttf along with some information:
102 ttx -l FreeSans.ttf
104 Dump the ‘cmap’ table from FreeSans.ttf to FreeSans.ttx:
106 ttx -t cmap FreeSans.ttf
108
110 On MS-Windows and MacOS, ttx is available as a graphical application to
111 which files can be dropped.
112
114 documentation.html
115 fontforge(1), ftinfo(1), gfontview(1), xmbdfed(1), Font::TTF(3pm)
117
119 ttx was written by Just van Rossum <just@letterror.com>.
120 This manual page was written by Florent Rougon <f.rougon@free.fr> for the
122 Debian GNU/Linux system based on the existing FontTools documentation.
123 It may be freely used, modified and distributed without restrictions.
124 May 18, 2004