pnmtops(1)
NAME
pnmtops - convert portable anymap to PostScript
SYNOPSIS
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.
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 generate 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 dimensions.
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 programs 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.
-setpage
pnmtops 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 width and height options or defaulted. If you want a
"setpagedevice" directive in the output, specify -setpage. 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 -nosetpage to
supress it, but that's actually a no-op now.
SEE ALSO
pnm(5), gs(1), psidtopgm(1), pstopnm(1), pbmtolps(1), pbmtoepsi(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)
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
