Section: User Commands (1)
Updated: 25 May 2001Index
Return to Main Contents
pnmtops - convert portable anymap to PostScript
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.
Reads a Netpbm image as input. Produces Encapsulated PostScript as
If the input file is in color (PPM),
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
If you specify no output dimensioning options, the output image is
dimensioned as if you had specified
which means aproximately 72 pixels of the input image generate one
inch of output (if that fits the page).
to adjust that.
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 dimensions.
If these dimensions are greater than the page size, you get Postscript
output that runs off the page.
You cannot use
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
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.
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
then 75 (not 72) pixels of input becomes one inch of output (4 output
pixels for each input pixel). Note that the
how many pixels per inch the output device generates.
If the size so specified does not fit on the page (as measured either
options or the default page size of 8.5 inches by 11 inches),
option, issues a warning, and scales the image to fit on the page.
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
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
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
The default is 8.5 inches by 11 inches.
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
turns the image no matter what its shape; If you specify
turn it no matter what its shape.
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
makes things slower.
centers the image on the output page.
You can cause
to instead put the image against the upper left corner of the page with
option. 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.
For backward compatibility,
accepts the option
but it has no effect.
can generate a "setpagedevice" directive 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
options or defaulted. If you want a "setpagedevice" directive in the
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.
Before release 10.0 the default was to generate the "setpagedevice" directive,
and there is the switch
to supress it, but that's actually a no-op now.
Copyright (C) 1989, 1991 by Jef Poskanzer.
Modified November 1993 by Wolfgang Stuerzlinger, email@example.com
- SEE ALSO