pnmtops(1)pnmtops(1)NAMEpnmtops - convert portable anymap to PostScript
SYNOPSISpnmtops [-scale s] [-dpi n] [-imagewidth n] [-imageheight
n] [-width=N] [-height=N] [-equalpixels] [-turn|-noturn]
[-rle|-runlength] [-nocenter] [-nosetpage] [pnmfile]
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.
DESCRIPTION
Reads a Netpbm image as input. Produces Encapsulated
PostScript as output.
If the input file is in color (PPM), pnmtops generates a
color PostScript file. Some PostScript interpreters can't
handle color PostScript. If you have one of these you
will need to run your image through ppmtopgm first.
If you specify no output dimensioning options, the output
image is dimensioned as if you had specified -scale=1.0,
which means aproximately 72 pixels of the input image gen
erate one inch of output (if that fits the page).
Use -imagewidth, -imageheight, -equalpixels, -width,
-height, and -scale to adjust that.
OPTIONS-imagewidth
-imageheight Tells how wide and high you want the
image on the page, in inches. The aspect ratio of
the image is preserved, so if you specify both of
these, the image on the page will be the largest
image that will fit within the box of those dimen
sions.
If these dimensions are greater than the page size,
you get Postscript output that runs off the page.
You cannot use imagewidth or imageheight with
-scale or -equalpixels.
-equalpixels
This option causes the output image to have the
same number of pixels as the input image. So if
the output device is 600 dpi and your image is 3000
pixels wide, the output image would be 5 inches
wide.
You cannot use -equalpixels with -imagewidth,
-imageheight, or -scale.
-scale tells how big you want the image on the page. The
value is the number of inches of output image that
you want 72 pixels of the input to generate.
But pnmtops rounds the number to something that is
an integral number of output device pixels. E.g.
if the output device is 300 dpi and you specify
-scale=1.0, then 75 (not 72) pixels of input
becomes one inch of output (4 output pixels for
each input pixel). Note that the -dpi option tell
pnmtops how many pixels per inch the output device
generates.
If the size so specified does not fit on the page
(as measured either by the -width and -height
options or the default page size of 8.5 inches by
11 inches), pnmtops ignores the -scale option,
issues a warning, and scales the image to fit on
the page.
-dpi This option specifies 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.
Also this option is crucial to the working of the
equalpixels option.
-width
-height These options specify the dimensions of the
page on which the output is to be printed. This
can affect the size of the output image.
The page size has no effect, however, when you
specify the -imagewidth, -imageheight, or
-equalpixels options.
These options may also affect positioning of the
image on the page and even the paper selected (or
cut) by the printer/plotter when the output is
printed. See the -nosetpage option.
The default is 8.5 inches by 11 inches.
-turn-noturn These options control whether the image
gets turned 90 degrees. Normally, if an image fits
the page better when turned (e.g. the image is
wider than it is tall, but the page is taller than
it is wide), it gets turned automatically to better
fit the page. If you specify the -turn option,
pnmtops turns the image no matter what its shape;
If you specify -noturn, pnmtops does not turn it no
matter what its shape.
-rle-runlength These identical options specify run-
length compression. This may save time if the
host-to-printer link is slow; but normally the
printer's processing time dominates, so -rle makes
things slower.
-nocenter
By default, pnmtops centers the image on the output
page. You can cause pnmtops to instead put the
image against the upper left corner of the page
with the -nocenter option. This is useful for pro
grams which can include PostScript files, but can't
cope with pictures which are not positioned in the
upper left corner.
For backward compatibility, pnmtops accepts the
option -center, but it has no effect.
-nosetpage
pnmtops normally generates a "setpagedevice" direc
tive to tell the printer/plotter what size paper to
use (or cut). The dimensions it specifies on this
directive are those selected or defaulted by the
width and height options or defaulted. If you
don't want a "setpagedevice" directive in the out
put, specify -nosetpage. This can be useful if
your printer chokes on this directive, which has
not always been defined in Postscript, or you want
to fake out the printer and print on one size paper
as if you're printing on another.
SEE ALSOpnm(5), gs(1), psidtopgm(1), pstopnm(1), pbmtolps(1), pbm
toepsi(1), pbmtopsg3(1), ppmtopgm(1),
AUTHOR
Copyright (C) 1989, 1991 by Jef Poskanzer.
Modified November 1993 by Wolfgang Stuerzlinger,
wrzl@gup.uni-linz.ac.at
25 May 2001 pnmtops(1)