.TL
Pbmtextps User Manual
.SH 1
pbmtextps
.LP
Updated: 7 October 2003
.br
Table Of Contents
.SH 2
NAME
.LP
pbmtextps - render text into a PBM image using a postscript interpreter
.SH 2
SYNOPSIS
.LP
\fBpbmtextps\fR
[\fB-font\fR \fIfontname\fR]
[\fB-fontsize\fR \fIfontsize\fR]
[\fB-resolution\fR \fIresolution\fR]
[\fB-stroke\fR \fIstrokesize\fR]
\fItext\fR
.SH 2
DESCRIPTION
.LP
.LP
This program is part of Netpbm.
.LP
\fBpbmtextps\fR takes a single line of text from the command line
and renders it into a PBM image.
.LP
The image is cropped at the top and the right.  It is not cropped
at the left or bottom so that the text begins at the same position
relative to the origin.  You can use \fBpnmcrop\fR to crop it all the
way.
.SH 2
OPTIONS
.LP
.RS
.IP "\fB-font\fR"
By default, \fBpbmtextps\fR uses TimesRoman.
.LP
You can specify the font to use with the \fB-font\fR option.
This is the name of any valid postscript font which is installed on your
system.
.IP "\fB-fontsize\fR"
Size of font in points.  See the \fB-resolution\fR option for information
on how to interpret this size.
.LP
Default is 24 points.
.IP "\fB-resolution\fR"
Resolution in dots per inch of distance measurements pertaining to generation
of the image.  PBM images don't have any inherent resolution, so a distance
such as "1 inch" doesn't mean anything unless you separately specify what
resolution you're talking about.  That's what this option does.
.LP
In particular, the meaning of the font size is determined by this
resolution.  If the font size is 24 points and the resolution is 150
dpi, then the font size is 50 pixels.
.LP
Default is 150 dpi.
.IP "\fB-stroke\fR"
Width of line to use for stroke font.  There is no default stroke width
because the letters are solid by default.
.RE
.SH 2
USAGE
.LP
You can generate antialiased text by using a larger resolution than the
default and scaling the image down using \fBpamscale\fR.
.LP
See the manual for the similar \fBpbmtext\fR for more advice on
usage.
.SH 2
HISTORY
.LP
.LP
\fBpbmtextps\fR was added to Netpbm in Release 10.0 (June 2002).
.SH 2
SEE ALSO
.LP
\fBpbmtext\fR,
\fBpamcut\fR,
\fBpnmcrop\fR,
\fBpamcomp\fR,
\fBppmchange\fR,
\fBpnmrotate\fR,
\fBpamscale\fR,
\fBppmlabel\fR,
\fBpbm\fR
.SH 2
AUTHOR
.LP
Copyright (C) 2002 by James McCann
.br
\l'5i'
.SH 2
Table Of Contents
.LP
.IP \(bu
NAME
.IP \(bu
SYNOPSIS
.IP \(bu
DESCRIPTION
.IP \(bu
OPTIONS
.IP \(bu
USAGE
.IP \(bu
HISTORY
.IP \(bu
SEE ALSO
.IP \(bu
AUTHOR
.LP