pnmtops(1)pnmtops(1)NAMEpnmtops - convert portable anymap to PostScript
SYNOPSISpnmtops [-scale s] [-turn|-noturn] [-rle|-runlength] [-dpi
n] [-width n] [-height n] [-center|-nocenter] [pnmfile]
DESCRIPTION
Reads a portable anymap as input. Produces Encapsulated
PostScript as output.
If the input file is in color (PPM), a color PostScript
file gets written. Some PostScript interpreters can't
handle color PostScript. If you have one of these you
will need to run your image through ppmtopgm first.
Note that there is no pstopnm tool - this transformation
is one-way, because a pstopnm tool would be a full-fledged
PostScript interpreter, which is beyond the scope of this
package. However, see the psidtopgm tool, which can read
grayscale non-runlength PostScript image data. Also, if
you're willing to install the fairly large GhostScript
package, it comes with a pstoppm script.
OPTIONS
The -scale flag controls the scale of the result. The
default scale is 1, which on a 300 dpi printer such as the
Apple LaserWriter makes the output look about the same
size as the input would if it was displayed on a typical
72 dpi screen. To get one PNM pixel per 300 dpi printer
pixel, use "-scale 0.25".
The -turn and -noturn flags control whether the image gets
turned 90 degrees. Normally, if an image is wider than it
is tall, it gets turned automatically to better fit the
page. If the -turn flag is specified, it will be turned
no matter what its shape; and if the -noturn flag is spec-
ified, it will not be turned no matter what its shape.
The -rle or -runlength flag specifies run-length compres-
sion. This may save time if the host-to-printer link is
slow; but normally the printer's processing time domi-
nates, so -rle makes things slower.
The -dpi flag lets you specify the dots per inch of your
output device. The default is 300 dpi. In theory
PostScript is device-independent and you don't have to
worry about this, but in practice its raster rendering can
have unsightly bands if the device pixels and the image
pixels aren't in sync.
The -width and -height flags let you specify the size of
the page. The default is 8.5 inches by 11 inches.
26 October 1991 1
pnmtops(1)pnmtops(1)
With the -nocenter flag, the output is not centered on the
page, i.e. it appears in the upper left corner. This is
useful for programs which can include PostScript files,
but can't cope with pictures which are not positioned in
the upper left corner. The default is -center i.e. the
image is centered on the page.
All flags can be abbreviated to their shortest unique pre-
fix.
SEE ALSOpnm(5), psidtopgm(1)AUTHOR
Copyright (C) 1989, 1991 by Jef Poskanzer.
Modified November 1993 by Wolfgang Stuerzlinger,
wrzl@gup.uni-linz.ac.at
26 October 1991 2
