b47d70
.TH TTMKFDIR 1 "March 28, 2013"
b47d70
.SH NAME
b47d70
\fBttmkfdir\fR\ - Utility to create fonts.scale files for truetype fonts 
b47d70
.SH SYNOPSIS
b47d70
.B ttmkfdir
b47d70
.RB [OPTION]
b47d70
.SH DESCRIPTION
b47d70
.PP
b47d70
    Originally written by Joerg Pommnitz, ttmkfdir is a tool to create valid and complete fonts.scale file from TrueType fonts. It is very useful when you plan to use a TrueType enabled font server that is based on the X11R6 sample implementation (xfsft for instance). Great care has been taken to correctly identify the encodings that a given TrueType font supports.
b47d70
b47d70
The ttmkfdir comes with Red Hat Linux has experienced quite some modifications or improvements, include:
b47d70
b47d70
\fR\- migration to FreeType 2 library
b47d70
.TP
b47d70
\fR\- more accurate checking for big font files
b47d70
.TP
b47d70
\fR\- support for both two X core font backends, Freetype and XTT
b47d70
.TP
b47d70
\fR\- Truetype collection(ttc) font file support
b47d70
.TP
b47d70
\fR\- additional CJK friendly features
b47d70
.TP
b47d70
\fR\- bug fixes
b47d70
b47d70
 
b47d70
.SH OPTIONS
b47d70
Here is the detailed usage of Red Hat version of ttmkfdir.
b47d70
.TP
b47d70
.B -h, --help 
b47d70
It shows the menus and combo box in iok UI
b47d70
.TP
b47d70
.B -e, --encoding <encodings.dir>
b47d70
ttmkfdir is doing its job by checking each TrueType font file against fontenc layer, please refer www.xfree86.org/current/fonts.html for details. Default encodings.dir file is /usr/X11R6/lib/X11/fonts/encodings/encodings.dir
b47d70
.TP
b47d70
.B -o, --output
b47d70
Specify output, default is fonts.scale in the current directory
b47d70
.TP
b47d70
.B -d, --font-dir
b47d70
Specify TrueType font directory, default is the current directory
b47d70
.TP
b47d70
.B -f, --default-foundry
b47d70
Specify name of the default font foundry, default is "misc"
b47d70
.TP
b47d70
.B -m, --max-missing
b47d70
Specify the maximum number of missing characters per encoding, default is 5. This option applies to the encoding that has less than 256 codepoint definitions.
b47d70
.TP
b47d70
.B -a,  --max-missing-percentage
b47d70
Specify the maximum percentage of missing characters per encoding, default is 2. This option applies to the encoding that has more than 256 codepoint definitions.
b47d70
.TP
b47d70
.B -b, --font-backend
b47d70
For X FreeType backend, use value "1", for XTT backend use value "2", default value is 1. When you have TrueType Collection font(.ttc), you need to use this option.
b47d70
.TP
b47d70
.B -x, --additional-entries
b47d70
Additional entries mean those extra TTCaps stuff for XTT backend, mainly for bold and italic font support. Or for FreeType backend, because FreeType still doesn't support bold and italic font, ttmkfdir can generate extra "dummy" XLFDs, so applications who asking those fonts won't complain.
b47d70
b47d70
Default value is "0" means off,otherwise use "1" to switch it on.
b47d70
.TP
b47d70
.B -c, --completeness
b47d70
use less strict completeness tests for encoding tables
b47d70
.TP
b47d70
.B -p, --panose
b47d70
use panose information
b47d70
b47d70
.SH AUTHOR
b47d70
Yu Shao <yshao@redhat.com> and Pravin Satpute <psatpute@redhat.com>
b47d70
.PP
b47d70
.SH LICENSE
b47d70
GNU Library General Public License