DragonFly On-Line Manual Pages

TTX(1)       DragonFly General Commands Manual (fonttools manual)       TTX(1)

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.

DragonFly 6.5-DEVELOPMENT        May 18, 2004        DragonFly 6.5-DEVELOPMENT