Section: User Commands (1)
Updated: 25 May 2001
pnmtops [-scale s] [-dpi n] [-imagewidth n] [-imageheight n] [-width=N] [-height=N] [-equalpixels] [-turn|-noturn] [-rle|-runlength] [-nocenter] [-setpage] [-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.
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 generate one inch of output (if that fits the page).
Use -imagewidth, -imageheight, -equalpixels, -width, -height, and -scale to adjust that.
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.
You cannot use -equalpixels with -imagewidth, -imageheight, or -scale.
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.
Also this option is crucial to the working of the equalpixels option.
-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.
For backward compatibility, pnmtops accepts the option -center, but it has no effect.
Before release 10.0 the default was to generate the "setpagedevice" directive, and there is the switch -nosetpage 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
Tutoriais de Tecnologia Web