TTFDUMP(1) General Commands Manual TTFDUMP(1)NAME
ttfdump - Dumping the contents of a TrueType Font file
SYNOPSIS
ttfdump [-h] [-t tablename] [-g glyphnumber] [-c collection] [-o dumpfile] [-i] ttfile
DESCRIPTION
ttfdump dumps the contents of a TrueType font file in ASCII form. A TrueType font file is consist of various tables. Those table are
divided into two categories - Required Tables and Optional Tables. Mulitiple TrueType fonts can be merged to a TrueType Collection.
Options
-h Print a help message on standard output and exit.
-t tablename
If this option is specified then dump the table "tablename", otherwise dump every tables in ttfile. Tablename can be one of the
following:
Required Tables
cmap character to glyph mapping table
glyf glyph data
head font header
hhea horizontal header
hmtx horizontal metrics
loca index to location
maxp maximum profile
name naming table
post PostScript information
OS/2 OS/2 and windows specific metrics
Optional Tables
cvt control value table
fpgm font program; not implemented yet.
gasp grid-fitting and scan conversion procedure (grayscale)
hdmx horizontal device metrics
kern kerning table
LTSH Linear threshold table
prep CVT program; not implemented yet
PCLT PCL5 table
VDMX Vertical Device Metrics table
vhea vertical metrics header
vmtx vertical metrics
Additional OpenType Tables
GPOS glyph positioning table
GSUB glyph substitution table
-g glyphnumber
If this option is specified then dump the glyph with index glyphnumber, otherwise dump all glyphs in ttfile.
-c collection
Select a TrueType font in a TrueType Collection.
-o dumpfile
Output of the dump. If this option is not specified, dump to stdout.
-i ttfile
TrueType font file to be dumped.
EXAMPLE
To dump all information in the TrueType font file times.ttf:
ttfdump times.ttf
To dump the required table cmap in the file:
ttfdump -t cmap times.ttf
To dump a single glyph with index 50:
ttfdump -g 50 times.ttf
SEE ALSO
TrueType 1.0 Font Files, Technical Specification Revision 1.66 November 1995
NOTE
Instruction disassembler in not implemented.
AUTHOR
Li-Da Lho, ollie@ms1.hinet.net
ILX Project 14 November 2011 TTFDUMP(1)
Check Out this Related Man Page
TTX(1) BSD General Commands 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 exten-
sion, which is substituted appropriately. ttx never overwrites existing files; if neccesary, 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.
-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 documenta-
tion. It may be freely used, modified and distributed without restrictions.
May 18, 2004