TTX(1)

🌸 NAME 🌸

ttx — bestie's fave little tool for manipulating TrueType and OpenType fonts 💖

✨ SYNOPSIS ✨

ttx [option ...] file ...

🦋 DESCRIPTION 🦋

okay so. 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. no cap. 🎀

For each file argument it is given, ttx detects whether it is a .ttf, .otf or .ttx file and acts accordingly: if it's a .ttf or .otf file, it generates a .ttx file; if it's a .ttx file, it generates a .ttf or .otf file. it just knows. main character energy fr fr 💅

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. so polite. so respectful of your files. 🫶

🌈 General options 🌈

• -h — Display usage information. little help menu moment ✨
• -d dir — Write the output files to directory dir instead of writing every output file to the same directory as the corresponding input file. basically "put it over there please" 📁
• -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. she's yapping (affectionate) 🗣️💖
• -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. this is the "font goes OUT" direction, iykyk 🧚

• -l — List table information. Instead of dumping the font to a TTX file, display minimal information about each table. just the receipts, not the whole story 📋
• -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. pick your faves bestie ⭐
• -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 — you literally cannot have both, it's giving toxic situationship 💀
• -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. it's a whole friend group of files 🎀
• -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. lowkey efficient 🔥
• -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). and now the "font comes BACK" direction 🦋

• -m fontfile — Merge the input TTX file file with fontfile. No more than one file argument can be specified when this option is used. one at a time, bestie, one at a time ✋
• -b — Don't recalculate glyph bounding boxes. Use the values in the TTX file as is. trust the process, leave it alone 🙈

📖 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. go read it, it's giving required reading 📚✨

🍓 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. drag and drop queen 👑

👑 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>. icon behavior tbh ⭐

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. slay, no restrictions, free to use 💅🫶

and that's the whole page bestie!! this is the LOCAL TTX(1) page, dated May 18, 2004 — yes she's vintage, she's an elder, and she still ate 🌸✨ go dump some fonts, ily, bye!! 🎀