'\"macro stdmacro
.if n .pH g1.convfont @(#)convfont	40.2 of 12/29/89
.ig
Revised: D. Bodnar 9/8/89
format -dqm4 -man6 -rs1 convertfont.1
..
.\" @(#)convertfont.1 9.7 89/01/13 SMI; 
.ds Sd \s-2Ne\h'-0.2n'WS\s+2
.\" .ds Xn X11/Ne\h'-0.2n'WS
.ds Xn \s-2X11/N\s+2e\h'-0.2n'\s-2WS\s+2
.ds Ps P\s-2OST\s+2S\s-2CRIPT\s+2
.nr X
.if \nX=0 .ds x} CONVERTFONT 1 "15 June 1989" "\&"
.if \nX=1 .ds x} CONVERTFONT 1 "15 June 1989"
.if \nX=2 .ds x} CONVERTFONT 1 "" "\&"
.if \nX=3 .ds x} CONVERTFONT "" "" "\&"
.TH \*(x}
.IX fonts convertfont#(1) "" \fLconvertfont\fP(1)
.\" .IX convertfont#(1) "" "\fLconvertfont\fP(1) \(em dump font in another format"
.IX convertfont#(1) "" "\fLconvertfont\fP(1)"
.IX fonts dumpfont "" "" PRINT "see \fIconvertfont\fP"
.IX dumpfont "" "" "" PRINT "see \fIconvertfont\fP"
.SH NAME
convertfont \- dump font out in some other format
.SH SYNOPSIS
.B convertfont
[
.\" .BR \-a | \-b | \-v | \-vf | \-x
.BR \-a \||\|\c
.BR \-b \||\|\c
.BR \-v \||\|\c 
.BR \-vf \||\|\c
.BR \-x
] 
[
.B \-c
.I comment
] 
[
.B \-d
.I dirname
]
[
.B \-f
.I n
]
[
.B \-n
.I fontname
]
[
.B \-S
]
[
.B \-s
.I n
]
[
.B \-t
] 
[
.B \-tv
] 
[
.B \-ta
] 
.I filenames
.SH DESCRIPTION
.LP
.B convertfont
reads in the set of named font files and dumps them out again according to
the specified options, effectively converting the files from one font
format to another.
.B convertfont
is typically used to generate fonts for use with the \*(Xn window system.
.LP
There are five types of font file that
.B convertfont
can read:
Sun standard vfont format,
Adobe 
.SM ASCII 
bitmap format,
Adobe 
.SM ASCII 
metric format,
\*(Sd font format,
and 
.SM CMU 
(Andrew) format.
The format of the input font is determined automatically
by inspecting the file.
It can write fonts out in one of three formats:
Adobe 
.SM ASCII , 
\*(Sd, and vfont.  The default output format is \*(Sd.
.SH OPTIONS
.IP "\fB\-a\fR" 1i
Selects Adobe 
.SM ASCII 
output format.  This is the format that you should use
when transporting fonts from one machine architecture to another.  The
output file extension will be \fB.afb\fP or \fB.afm\fP.
.sp
.IP "\f3\-b\fR" 1i
Selects \*(Sd output format (the default).  The output file extension
will be \fB.fb\fP.  If the input file is an Adobe 
.SM ASCII 
metrics file, the extension will be \fB.fm\fP.
.sp
.IP "\fB\-v\fR" 1i
Selects vfont output format.  The output file extension will be \fB.vft\fP.
.sp
.IP "\fB\-vf\fR" 1i
Selects vfont output format.  The output file extension will be \fB.vft\fP.
Forces the characters to be fixed width.
.sp
.IP "\f3\-c \fIcomment\fR" 1i
Sets the
.I comment
field of the font.  The Adobe 
.SM ASCII 
and \*(Sd font formats support an
internal comment that accompanies the font.  This is usually used to contain
copyright or history information.  It is normally propagated automatically.
.sp
.IP "\fB\-d \fIdirname\fR" 1i
Specifies the directory into which the font files will be written.  If the
.B FONTDIR 
environment variable is set, it is used as the default value.
Otherwise, if the 
.B OPENWINHOME 
environment variable is set,
\fB\s-1$OPENWINHOME\s+1/fonts\fP
is used as the default value.
Otherwise `.' is used.
.sp
.IP "\f3\-f \fIn\fR" 1i
Sets the maximum length of an output filename (excluding extension) to \fIn\fP.
When writing \*(Sd format files, \*(Sd normally constructs the output filename
from the name of the font and its scaling factors.  Some systems cannot cope
with long file names, so this option can be used to squeeze
the name heuristically.  The default value is 8.
.sp
.IP "\fB\-n\fI name\fR" 1i
Forces the output font name to be
.I "name\fP."
It is important to not confuse the name of the font with the name of the file
that contains it.  Some font formats (Adobe 
.SM ASCII 
and \*(Sd) contain the name
of the font internally.  So, given a 10-point Times-Roman font,
its font name will be \fBTimes-Roman\fP,
but its file name might be \fBTmsR10.fb\fP.
.sp
.IP "\fB\-S\fR" 1i
Attempts to determine the size information of fonts by inspecting the
bitmaps and applying some heuristics.  This is useful when reading vfonts
(particularly those intended for printers like the Versatec) that are
missing or have incorrect size information.
.sp
.IP "\fB\-s \fIn\fR" 1i
Sets the point size of the font to \fIn\fP.
Overrides any internal size specification.
.sp
.IP "\fB\-t\fR" 1i
Prints a short description of the fonts on standard output; a reformatted
font file is not dumped.
.sp
.IP "\fB\-tv\fR" 1i
Prints a more verbose description of the fonts on standard output; a
reformatted font file is not dumped.
.sp
.IP "\fB\-ta\fR" 1i
Prints a long description of the fonts on standard output; a reformatted
font file is not dumped.  
.sp
.IP "\fB\-x\fR" 1i
Selects Adobe/\s-1MIT\s+1 X11 \s-1BDF\s+1 2.1 output format.  This is the format that 
you should use
when transporting fonts between X11 servers. The output file extension will 
be \fB.bdf\fP.
.sp
.SH "SEE ALSO"
\fBbldfamily\fP(1)
.sp
.SH DIAGNOSTICS
.TP 20n
\fBBad flag: -C\fP
Unknown command line option
.TP 20n
\fBCouldn't write ...\fP
Error writing font file
.TP 20n
\fIf\fR: \fBnot a valid font.\fP
Unknown input file format
