NAME

     ttx — tool for manipulating TrueType and OpenType fonts

SYNOPSIS

     ttx [option ...] file ...

DESCRIPTION

     ttx is a tool for manipulating TrueType and OpenType fonts.  It can convert TrueType and
     OpenType fonts to and from an XML-based format called TTX.  TTX files have a ‘.ttx’
     extension.

     For each file argument it is given, ttx detects whether it is a ‘.ttf’, ‘.otf’ or ‘.ttx’
     file and acts accordingly: if it is a ‘.ttf’ or ‘.otf’ file, it generates a ‘.ttx’ file; if
     it is a ‘.ttx’ file, it generates a ‘.ttf’ or ‘.otf’ file.

     By default, every output file is created in the same directory as the corresponding input
     file and with the same name except for the extension, which is substituted appropriately.
     ttx never overwrites existing files; if necessary, it appends a suffix to the output file
     name before the extension, as in Arial#1.ttf.

   General options
     -h        Display usage information.

     -d dir    Write the output files to directory dir instead of writing every output file to
               the same directory as the corresponding input file.

     -o file   Write the output to file instead of writing it to the same directory as the
               corresponding input file.

     -v        Be verbose.  Write more messages to the standard output describing what is being
               done.

     -a        Allow virtual glyphs ID's on compile or decompile.

   Dump options
     The following options control the process of dumping font files (TrueType or OpenType) to
     TTX files.

     -l        List table information.  Instead of dumping the font to a TTX file, display
               minimal information about each table.

     -t table  Dump table table.  This option may be given multiple times to dump several tables
               at once.  When not specified, all tables are dumped.

     -x table  Exclude table table from the list of tables to dump.  This option may be given
               multiple times to exclude several tables from the dump.  The -t and -x options are
               mutually exclusive.

     -s        Split tables.  Dump each table to a separate TTX file and write (under the name
               that would have been used for the output file if the -s option had not been given)
               one small TTX file containing references to the individual table dump files.  This
               file can be used as input to ttx as long as the referenced files can be found in
               the same directory.

     -i        Don't disassemble TrueType instructions.  When this option is specified, all
               TrueType programs (glyph programs, the font program and the pre-program) are
               written to the TTX file as hexadecimal data instead of assembly.  This saves some
               time and results in smaller TTX files.

     -y n      When decompiling a TrueType Collection (TTC) file, decompile font number n,
               starting from 0.

   Compilation options
     The following options control the process of compiling TTX files into font files (TrueType
     or OpenType):

     -m fontfile
               Merge the input TTX file file with fontfile.  No more than one file argument can
               be specified when this option is used.

     -b        Don't recalculate glyph bounding boxes.  Use the values in the TTX file as is.

THE TTX FILE FORMAT

     You can find some information about the TTX file format in documentation.html.  In
     particular, you will find in that file the list of tables understood by ttx and the
     relations between TrueType GlyphIDs and the glyph names used in TTX files.

EXAMPLES

     In the following examples, all files are read from and written to the current directory.
     Additionally, the name given for the output file assumes in every case that it did not exist
     before ttx was invoked.

     Dump the TrueType font contained in FreeSans.ttf to FreeSans.ttx:

           ttx FreeSans.ttf

     Compile MyFont.ttx into a TrueType or OpenType font file:

           ttx MyFont.ttx

     List the tables in FreeSans.ttf along with some information:

           ttx -l FreeSans.ttf

     Dump the ‘cmap’ table from FreeSans.ttf to FreeSans.ttx:

           ttx -t cmap FreeSans.ttf

NOTES

     On MS-Windows and MacOS, ttx is available as a graphical application to which files can be
     dropped.

SEE ALSO

     documentation.html

     fontforge(1), ftinfo(1), gfontview(1), xmbdfed(1), Font::TTF(3pm)

AUTHORS

     ttx was written by Just van Rossum <just@letterror.com>.

     This manual page was written by Florent Rougon <f.rougon@free.fr> for the Debian GNU/Linux
     system based on the existing FontTools documentation.  It may be freely used, modified and
     distributed without restrictions.

                                           May 18, 2004