ttf2tfm.1

字体缩放显示

.\" man page for ttf2tfm
.
.TH TTF2TFM 1 10-Jan-2002 "FreeType version 1.5"
.SH NAME
ttf2tfm \- build TeX metric files from a TrueType font
.SH SYNOPSIS
.na
.nh
.B ttf2tfm
'in +\n(.ku
.IR ttffile [ .ttf | .ttc ]
[\c
.BI \-c \ \%caps-height-factor\c
]
[\c
.BI \-e \ \%extension-factor\c
]
[\c
.BI \-E \ \%encoding-id\^\c
]
[\c
.BI \-f \ \%font-index\c
]
[\c
.B \-l\c
]
[\c
.B \-L\ \c
.IR \%ligature-file [ .sfd ]\c
]
[\c
.B \-n\c
]
[\c
.B \-N\c
]
[\c
.B \-O\c
]
[\c
.B \-p\ \c
.IR \%inencfile [ .enc ]\c
]
[\c
.BI \-P \ \%platform-id\^\c
]
[\c
.B \-q\c
]
[\c
.BI \-r \ \%old-glyphname\ \%new-glyphname\c
]
[\c
.B \-R\ \c
.IR \%replacement-file [ .rpl ]\c
]
[\c
.BI \-s \ \%slant-factor\c
]
[\c
.B \-t\ \c
.IR \%outencfile [ .enc ]\c
]
[\c
.B \-T\ \c
.IR \%inoutencfile [ .enc ]\c
]
[\c
.B \-u\c
]
[\c
.B \-v\ \c
.IR \%vplfile [ .vpl ]\c
]
[\c
.B \-V\ \c
.IR \%scvplfile [ .vpl ]\c
]
[\c
.B \-w\c
]
[\c
.B \-x\c
]
[\c
.BI \-y \ \%vertical-shift-factor\c
]
[\c
.IR \%tfmfile [ .tfm ]\c
]
.br
.in
.B "ttf2tfm \-\^\-version"
|
.B \-\^\-help
.ad
.hy
.
.
.
.\" ====
.\" ==== macro definitions
.\" ====
.
.\" here we define \TeX for troff and nroff
.if t .ds TX T\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X
.if n .ds TX TeX
.
.\" and here the same for \LaTeX
.if t \{\
.ie '\*(.T'dvi' \
.ds LX L\h'-0.36m'\v'-0.15v'\s-3A\s0\h'-0.15m'\v'0.15v'\*(TX
.el .ds LX L\h'-0.36m'\v'-0.22v'\s-2A\s0\h'-0.15m'\v'0.22v'\*(TX
.\}
.if n .ds LX LaTeX
.
.\" \LaTeXe
.\" note that we need \vareps for TeX instead of \eps which can only be
.\" accessed with the \N escape sequence (in the Math Italic font)
.if t \{\
.ie '\*(.T'dvi' .ds LE \*(LX\h'0.15m'2\v'0.20v'\f(MI\N'34'\fP\v'-0.20v'
.el .ds LE \*(LX\h'0.15m'2\v'0.20v'\(*e\v'-0.20v'
.\}
.if n .ds LE LaTeX\ 2e
.
.\" a typewriter font
.if t \{\
.de C
\fC\\$1\fP\\$2\fC\\$3\fP\\$4
..
.\}
.if n \{\
.de C
\\$1\\$2\\$3\\$4
..
.\}
.
.\" ====
.\" ==== end of macro definitions
.\" ====
.
.
.
.SH DESCRIPTION
This program extracts the metric and kerning information of a TrueType
font and converts it into metric files usable by \*(TX
(quite similar to
.B afm2tfm
which is part of the
.B dvips
package; please consult its info files for more details on the various
parameters (especially encoding files).
.PP
Since a TrueType font often contains more than 256\ glyphs, some means
are necessary to map a subset of the TrueType glyphs onto a \*(TX
font.
To do this, two mapping tables are needed: the first (called `input' or
`raw' encoding) maps the TrueType font to a raw \*(TX font (this mapping
table is used by both
.B ttf2tfm
and
.BR ttf2pk ),
and the second (called `output' or `virtual' encoding) maps the raw \*(TX
font to another (virtual) \*(TX
font, providing all kerning and ligature information needed by \*(TX.
.PP
This two stage mapping has the advantage that one raw font can be
accessed with various \*(LX
encodings (e.g.\ T1 and OT1) via the virtual font mechanism, and just
one
.C PK
file is necessary.
.PP
For CJKV (Chinese/Japanese/Korean/old Vietnamese) fonts, a different
mechanism is provided (see
.B "SUBFONT DEFINITION FILES"
below).
.
.
.SH PARAMETERS
Most of the command line switch names are the same as in
.B afm2tfm
for convenience.
One or more space characters between an option and its value is mandatory;
options can't be concatenated.
For historical reasons, the first parameter can
.I not
be a switch but must be the font name.
.TP
.BI \-c \ caps-height-factor
The height of small caps made with the
.B \-V
switch.
Default value of this real number is\ 0.8 times the height of uppercase
glyphs.
.IP
Will be ignored in subfont mode.
.TP
.BI \-e \ extension-factor
The extension factor to stretch the characters horizontally.
Default value of this real number is\ 1.0; if less than\ 1.0, you get a
condensed font.
.TP
.BI \-E \ encoding-id
The TrueType encoding ID.
Default value of this non-negative integer is\ 1.
.IP
Will be ignored if
.B \-N
is used.
.TP
.BI \-f \ font-index
The font index in a TrueType Collection.
Default is the first font (index\ 0).
[TrueType collections are usually found in some CJK fonts; e.g.\ the first
font index specifies glyphs and metrics for horizontal writing, and the
second font index does the same for vertical writing.
TrueType collections usually have the extension `\c
.C \&.ttc '.]
.IP
Will be ignored for ordinary TrueType fonts.
.TP
.B \-l
Create ligatures in subfonts between first and second bytes of all the
original character codes.
Example:  Character code\ 0xABCD maps to character position\ 123 in
subfont\ 45.
Then a ligature in subfont\ 45 between position 0xAB and\ 0xCD pointing
to character\ 123 will be produced.
The fonts of the Korean H\*(LX
package use this feature.
Note that this option generates correct ligatures only for TrueType fonts
where the input cmap is identical to the output encoding.
In case of H\*(LX, TTFs must have platform ID\ 3 and encoding ID\ 5.
.IP
Will be ignored if not in subfont mode.
.TP
.BI \-L \ ligature-file
Same as
.BR \-l ,
but character codes for ligatures are specified in
.IR \%ligature-file .
For example, `\c
.C \-L\ \%KS-HLaTeX '
generates correct ligatures for the Korean H\*(LX
package regardless of the platform and encoding ID of the used TrueType
font (the file
.C KS-HLaTeX.sfd
is part of the ttf2pk package).
.IP
Ligature files have the same format and extension as
.C SFD
files.
This option will be ignored if not in subfont mode.
.TP
.B \-n
Use PS names (of glyphs) of the TrueType font.
Only glyphs with a valid entry in the selected cmap are used.
.IP
Will be ignored in subfont mode.
.TP
.B \-N
Use only PS names of the TrueType font.
No cmap is used, thus the switches
.B \-E
and
.B \-P
have no effect, causing a warning message.
.IP
Will be ignored in subfont mode.
.TP
.B \-O
Use octal values for all character codes in the
.C VPL
file rather than names; this is useful for symbol or CJK fonts where
character names such as `A' are meaningless.
.TP
.BI \-p \ inencfile
The input encoding file name for the TTF\(->raw\ \*(TX
mapping.
This parameter has to be specified in a map file
(default:
.C \%ttfonts.map )
recorded in
.C \%ttf2pk.cfg
for successive
.B ttf2pk
calls.
.IP
Will be ignored in subfont mode.
.TP
.BI \-P \ platform-id
The TrueType platform ID.
Default value of this non-negative integer is\ 3.
.IP
Will be ignored if
.B \-N
is used.
.TP
.B \-q
Make
.B ttf2tfm
quiet.
It suppresses any informational output except warning and error
messages.
For CJK fonts, the output can get quite large if you don't specify
this switch.
.TP
.BI \-r \ old-glyphname\ new-glyphname
Replaces
.I \%old-glyphname
with
.IR \%new-glyphname .
This switch is useful if you want to give an unnamed glyph (i.e., a glyph
which can be represented with `.gXXX' or `.cXXX' only) a name or if you want
to rename an already existing glyph name.
You can't use the `.gXXX' or `.cXXX' glyph name constructs for
.IR \%new-glyphname ;
multiple occurrences of
.B \-r
are possible.
.IP
If in subfont mode or if no encoding file is specified, this switch is
ignored.
.TP
.BI \-R \ replacement-file
Use this switch if you have many replacement pairs; they can be  collected
in a file which should have `\c
.C \&.rpl '
as extension.
The syntax used in such replacement files is simple: Each non-empty
line must contain a pair `\c
.IR "\%old-glyphname \%new-glyphname" '
separated by whitespace (without the quotation marks).
A percent sign starts a line comment; you can continue a line on the next
line with a backslash as the last character.
.IP
If in subfont mode or if no encoding file is specified, this switch is
ignored.
.TP
.BI \-s \ slant-factor
The obliqueness factor to slant the font, usually much smaller than\ 1.
Default of this real number is\ 0.0; if the value is larger than zero,
the characters slope to the right, otherwise to the left.
.TP
.BI \-t \ outencfile
The output encoding file name for the virtual font(s).
Only characters in the raw \*(TX
font are used.
.IP
Will be ignored in subfont mode.
.TP
.BI \-T \ inoutencfile
This is equivalent to
.RB ` \-p
.I inoutencfile
.B \-t
.IR inoutencfile '.
.IP
Will be ignored in subfont mode.
.TP
.B \-u
Use only those characters specified in the output encoding, and no
others.
By default,
.B ttf2tfm
tries to include all characters in the virtual font, even those not
present in the encoding for the virtual font (it puts them into
otherwise-unused positions, rather arbitrarily).
.IP
Will be ignored in subfont mode.
.TP
.BI \-v \ vplfile
Output a
.C VPL
file in addition to the
.C TFM
file.
If no output encoding file is specified,
.B ttf2tfm
uses a default font encoding (cmtt10).
.B Note:
Be careful to use different names for the virtual font and the raw font!
.IP
Will be ignored in subfont mode.
.TP
.BI \-V \ scvplfile
Same as
.BR \-v ,
but the virtual font generated is a pseudo small caps font obtained by
scaling uppercase letters by\ 0.8 (resp. the value specified with
.BR \-c )
to typeset lowercase.
This font handles accented letters and retains proper kerning.
.IP
Will be ignored in subfont mode.
.TP
.B \-w
Generate PostScript encoding vectors containing glyph indices, primarily
used to embed TrueType fonts in pdf\*(TX.
.B ttf2tfm
takes the
.C TFM
names and replaces the suffix with
.C \&.enc ;
that is, for files
.C foo01.tfm ,
.C foo02.tfm ,\ \&.\|.\|.\&
it creates
.C foo01.enc ,
.C foo02.enc ,\ \&.\|.\|.\|\&
at the same place.
.IP
Will be ignored if not in subfont mode.
.TP
.B \-x
Rotate all glyphs by 90 degrees counter-clockwise.
If no
.B \-y
parameter is given, the rotated glyphs are shifted down vertically
by\ 0.25em.
.IP
Will be ignored if not in subfont mode.
.TP
.BI \-y \ vertical-shift-factor
Shift down rotated glyphs by the given amount (the unit is
.IR em ).
.IP
Ignored if not in subfont mode or glyphs are not rotated.
.TP
.B \-\^\-version
Shows the current version of
.B ttf2tfm
and the used file search library (e.g.
.BR kpathsea ).
.TP
.B \-\^\-help
Shows usage information.
.PP
If no
.C TFM
file name is given, the name of the
.C TTF
file is used, including the full path and replacing the extension with `\c
.C \&.tfm '.
.
.
.SH CMAPS
Contrary to Type\ 1 PostScript fonts (but similar to the new CID
PostScript font format), most TrueType fonts have more than one native
mapping table, also called `cmap', which maps the (internal) TTF glyph
indices to the (external) TTF character codes.
Common examples are a mapping table to Unicode encoded character
positions, and the standard Macintosh mapping.

To specify a TrueType mapping table, use the options
.B \-P
and
.BR \-E .
With
.B \-P
you specify the platform ID; defined values are:
.PP
.in +4m
.ta 3iC
.br
.I "platform	platform ID (pid)"
.sp
.ta 3iR
Apple Unicode	0
.br
Macintosh	1
.br
ISO	2
.br
Microsoft	3
.PP
The encoding ID depends on the platform.
For pid=0, we ignore the
.B \-E
parameter (setting it to zero) since the mapping table is always
Unicode version\ 2.0.
For pid=1, the following table lists the defined values:
.PP
.in +2m
platform ID = 1
.in
.in +4m
.ta 3iC
.sp
.I "script	encoding ID (eid)"
.sp
.ta 3iR
Roman	0
.br
Japanese	1
.br
Chinese	2
.br
Korean	3
.br
Arabic	4
.br
Hebrew	5
.br
Greek	6
.br
Russian	7
.br
Roman Symbol	8
.br
Devanagari	9
.br
Gurmukhi	10
.br
Gujarati	11
.br
Oriya	12
.br
Bengali	13
.br
Tamil	14
.br
Telugu	15
.br
Kannada	16
.br
Malayalam	17
.br
Sinhalese	18
.br
Burmese	19
.br
Khmer	20
.br
Thai	21
.br
Laotian	22
.br
Georgian	23
.br
Armenian	24
.br
Maldivian	25
.br
Tibetan	26
.br
Mongolian	27
.br
Geez	28
.br
Slavic	29
.br
Vietnamese	30
.br
Sindhi	31
.br
Uninterpreted	32
.PP
Here are the ISO encoding IDs:
.PP
.in +2m
platform ID = 2
.in
.in +4m
.ta 3iC
.sp
.I "encoding	encoding ID (eid)"
.sp
.ta 3iR
ASCII	0
.br
ISO 10646	1
.br
ISO 8859-1	2
.PP
And finally, the Microsoft encoding IDs:
.PP
.in +2m
platform ID = 3
.in
.in +4m
.ta 3iC
.sp
.I "encoding	encoding ID (eid)"
.sp
.ta 3iR
Symbol	0
.br
Unicode 2.0	1
.br
Shift JIS	2
.br
GB 2312 (1980)	3
.br
Big 5	4
.br