Spaces:
Running
Running
.Dd May 18, 2004 | |
.\" ttx is not specific to any OS, but contrary to what groff_mdoc(7) | |
.\" seems to imply, entirely omitting the .Os macro causes 'BSD' to | |
.\" be used, so I give a zero-width space as its argument. | |
.Os \& | |
.\" The "FontTools Manual" argument apparently has no effect in | |
.\" groff 1.18.1. I think it is a bug in the -mdoc groff package. | |
.Dt TTX 1 "FontTools Manual" | |
.Sh NAME | |
.Nm ttx | |
.Nd tool for manipulating TrueType and OpenType fonts | |
.Sh SYNOPSIS | |
.Nm | |
.Bk | |
.Op Ar option ... | |
.Ek | |
.Bk | |
.Ar file ... | |
.Ek | |
.Sh DESCRIPTION | |
.Nm | |
is a tool for manipulating TrueType and OpenType fonts. It can convert | |
TrueType and OpenType fonts to and from an | |
.Tn XML Ns -based format called | |
.Tn TTX . | |
.Tn TTX | |
files have a | |
.Ql .ttx | |
extension. | |
.Pp | |
For each | |
.Ar file | |
argument it is given, | |
.Nm | |
detects whether it is a | |
.Ql .ttf , | |
.Ql .otf | |
or | |
.Ql .ttx | |
file and acts accordingly: if it is a | |
.Ql .ttf | |
or | |
.Ql .otf | |
file, it generates a | |
.Ql .ttx | |
file; if it is a | |
.Ql .ttx | |
file, it generates a | |
.Ql .ttf | |
or | |
.Ql .otf | |
file. | |
.Pp | |
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. | |
.Nm | |
never overwrites existing files; if necessary, it appends a suffix to | |
the output file name before the extension, as in | |
.Pa Arial#1.ttf . | |
.Ss "General options" | |
.Bl -tag -width ".Fl t Ar table" | |
.It Fl h | |
Display usage information. | |
.It Fl d Ar dir | |
Write the output files to directory | |
.Ar dir | |
instead of writing every output file to the same directory as the | |
corresponding input file. | |
.It Fl o Ar file | |
Write the output to | |
.Ar file | |
instead of writing it to the same directory as the | |
corresponding input file. | |
.It Fl v | |
Be verbose. Write more messages to the standard output describing what | |
is being done. | |
.It Fl a | |
Allow virtual glyphs ID's on compile or decompile. | |
.El | |
.Ss "Dump options" | |
The following options control the process of dumping font files | |
(TrueType or OpenType) to | |
.Tn TTX | |
files. | |
.Bl -tag -width ".Fl t Ar table" | |
.It Fl l | |
List table information. Instead of dumping the font to a | |
.Tn TTX | |
file, display minimal information about each table. | |
.It Fl t Ar table | |
Dump table | |
.Ar table . | |
This option may be given multiple times to dump several tables at | |
once. When not specified, all tables are dumped. | |
.It Fl x Ar table | |
Exclude table | |
.Ar table | |
from the list of tables to dump. This option may be given multiple | |
times to exclude several tables from the dump. The | |
.Fl t | |
and | |
.Fl x | |
options are mutually exclusive. | |
.It Fl s | |
Split tables. Dump each table to a separate | |
.Tn TTX | |
file and write (under the name that would have been used for the output | |
file if the | |
.Fl s | |
option had not been given) one small | |
.Tn TTX | |
file containing references to the individual table dump files. This | |
file can be used as input to | |
.Nm | |
as long as the referenced files can be found in the same directory. | |
.It Fl i | |
.\" XXX: I suppose OpenType programs (exist and) are also affected. | |
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 | |
.Tn TTX | |
file as hexadecimal data instead of | |
assembly. This saves some time and results in smaller | |
.Tn TTX | |
files. | |
.It Fl y Ar n | |
When decompiling a TrueType Collection (TTC) file, | |
decompile font number | |
.Ar n , | |
starting from 0. | |
.El | |
.Ss "Compilation options" | |
The following options control the process of compiling | |
.Tn TTX | |
files into font files (TrueType or OpenType): | |
.Bl -tag -width ".Fl t Ar table" | |
.It Fl m Ar fontfile | |
Merge the input | |
.Tn TTX | |
file | |
.Ar file | |
with | |
.Ar fontfile . | |
No more than one | |
.Ar file | |
argument can be specified when this option is used. | |
.It Fl b | |
Don't recalculate glyph bounding boxes. Use the values in the | |
.Tn TTX | |
file as is. | |
.El | |
.Sh "THE TTX FILE FORMAT" | |
You can find some information about the | |
.Tn TTX | |
file format in | |
.Pa documentation.html . | |
In particular, you will find in that file the list of tables understood by | |
.Nm | |
and the relations between TrueType GlyphIDs and the glyph names used in | |
.Tn TTX | |
files. | |
.Sh 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 | |
.Nm | |
was invoked. | |
.Pp | |
Dump the TrueType font contained in | |
.Pa FreeSans.ttf | |
to | |
.Pa FreeSans.ttx : | |
.Pp | |
.Dl ttx FreeSans.ttf | |
.Pp | |
Compile | |
.Pa MyFont.ttx | |
into a TrueType or OpenType font file: | |
.Pp | |
.Dl ttx MyFont.ttx | |
.Pp | |
List the tables in | |
.Pa FreeSans.ttf | |
along with some information: | |
.Pp | |
.Dl ttx -l FreeSans.ttf | |
.Pp | |
Dump the | |
.Sq cmap | |
table from | |
.Pa FreeSans.ttf | |
to | |
.Pa FreeSans.ttx : | |
.Pp | |
.Dl ttx -t cmap FreeSans.ttf | |
.Sh NOTES | |
On MS\-Windows and MacOS, | |
.Nm | |
is available as a graphical application to which files can be dropped. | |
.Sh SEE ALSO | |
.Pa documentation.html | |
.Pp | |
.Xr fontforge 1 , | |
.Xr ftinfo 1 , | |
.Xr gfontview 1 , | |
.Xr xmbdfed 1 , | |
.Xr Font::TTF 3pm | |
.Sh AUTHORS | |
.Nm | |
was written by | |
.An -nosplit | |
.An "Just van Rossum" Aq [email protected] . | |
.Pp | |
This manual page was written by | |
.An "Florent Rougon" Aq [email protected] | |
for the Debian GNU/Linux system based on the existing FontTools | |
documentation. It may be freely used, modified and distributed without | |
restrictions. | |
.\" For Emacs: | |
.\" Local Variables: | |
.\" fill-column: 72 | |
.\" sentence-end: "[.?!][]\"')}]*\\($\\| $\\| \\| \\)[ \n]*" | |
.\" sentence-end-double-space: t | |
.\" End: |