\
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Pamtompfont User Manual" 1 "18 May 2008" "netpbm documentation"

.SH NAME
pamtompfont - Convert Netpbm image to Mplayer bitmap font file

.UN synopsis
.SH SYNOPSIS
\fBpamtompfont\fP
[\fInetpbmfile\fP]
.PP
All options can be abbreviated to their shortest unique prefix.
You may use two hyphens instead of one.  You may separate an option
name and its value with white space instead of an equals sign.

.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR "Netpbm" (1)\c
\&.
.PP
\fBpamtompfont\fP reads a Netpbm image (PNM or PAM) and converts it
to an Mplayer bitmap font raster file.
.PP
This is the original font format used by Mplayer (for subtitles,
on-screen messages, etc.), before it had the ability to use Freetype
to access standard fonts.
.PP
The format was apparently an image format before Mplayer adopted it
for fonts, but I have no idea where it came from or where else it might
be used.
.PP
An Mplayer bitmap font consists of a font descriptor file and
raster files.  The font descriptor file identifies the raster files by
file name.  A raster file contains a single rectangular raster image
which contains an arrangement of a bunch of glyphs.  Each glyph is a
rectangular image and the font descriptor indicates where in the image
the glyph for each codepoint is.  Every glyph in the font has the same
height, so the font descriptor just indicates the file position in the
raster file of the to left corner of the glyph, and the width of the
glyph in pixels.


.UN options
.SH OPTIONS
.PP
There are no command line options defined specifically
for \fBpamtompfont\fP, but it recognizes the options common to all
programs based on libnetpbm (See 
.UR index.html#commonoptions
 Common Options
.UE
\&.)

.UN seealso
.SH SEE ALSO
.BR "pam" (1)\c
\&

.UN history
.SH HISTORY
.PP
\fBpamtompfont\fP was added to Netpbm in Release 10.43 (June 2008).
.SH DOCUMENT SOURCE
This manual page was generated by the Netpbm tool 'makeman' from HTML
source.  The master documentation is at
.IP
.B http://netpbm.sourceforge.net/doc/pamtompfont.html
.PP