\
.\" 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 "Pbmtextps User Manual" 0 "09 December 2007" "netpbm documentation"

.SH NAME
pbmtextps - render text into a PBM image using a postscript interpreter

.UN synopsis
.SH SYNOPSIS

\fBpbmtextps\fP
[\fB-font\fP \fIfontname\fP]
[\fB-fontsize\fP \fIfontsize\fP]
[\fB-resolution\fP \fIresolution\fP]
[\fB-stroke\fP \fIstrokesize\fP]
\fItext\fP

.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR Netpbm (1)
.
.PP
\fBpbmtextps\fP takes a single line of text from the command line
and renders it into a PBM image.  The image is of a single line of text;
newline characters in the input have no effect.
.PP
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\fP to crop it all the
way.
.PP
See \fBpbmtext\fP for a more sophisticated generator of text, but
using less common font formats.  \fBpbmtext\fP can generate multiple
lines of text.
.PP
The \fB-plain\fP 
.UR index.html#commonoptions
common option
.UE
\& has no effect before Netpbm 10.42 (March 2008).  The output
is always raw PBM.

.UN options
.SH OPTIONS


.TP
\fB-font\fP
By default, \fBpbmtextps\fP uses TimesRoman.
.sp
You can specify the font to use with the \fB-font\fP option.
This is the name of any valid postscript font which is installed on your
system.

.TP
\fB-fontsize\fP
Size of font in points.  See the \fB-resolution\fP option for information
on how to interpret this size.
.sp
Default is 24 points.

.TP
\fB-resolution\fP
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.
.sp
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.
.sp
Default is 150 dpi.

.TP
\fB-stroke\fP
Width of line to use for stroke font.  There is no default stroke width
because the characters are solid by default.


.UN usage
.SH USAGE

You can generate antialiased text by using a larger resolution than the
default and scaling the image down using \fBpamscale\fP.
.PP
See the manual for the similar \fBpbmtext\fP for more advice on
usage.

.UN history
.SH HISTORY
.PP
\fBpbmtextps\fP was added to Netpbm in Release 10.0 (June 2002).


.UN seealso
.SH SEE ALSO
.BR pbmtext (1)
,
.BR pamcut (1)
,
.BR pnmcrop (1)
,
.BR pamcomp (1)
,
.BR ppmchange (1)
,
.BR pnmrotate (1)
,
.BR pamscale (1)
,
.BR ppmlabel (1)
,
.BR pbm (5)


.UN author
.SH AUTHOR

Copyright (C) 2002 by James McCann