371 lines
7.7 KiB
HTML
371 lines
7.7 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of pnmtops</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>pnmtops</H1>
|
|
Section: User Commands (1)<BR>Updated: 25 May 2001<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="ixAAB"></A>
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
pnmtops - convert portable anymap to PostScript
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>pnmtops</B>
|
|
|
|
[<B>-scale</B>
|
|
|
|
<I>s</I>]
|
|
|
|
[<B>-dpi</B>
|
|
|
|
<I>n</I>]
|
|
|
|
[<B>-imagewidth</B>
|
|
|
|
<I>n</I>]
|
|
|
|
[<B>-imageheight</B>
|
|
|
|
<I>n</I>]
|
|
|
|
[<B>-width=</B><I>N</I>]
|
|
|
|
[<B>-height=</B><I>N</I>]
|
|
|
|
[<B>-equalpixels</B>]
|
|
|
|
[<B>-turn</B>|<B>-noturn</B>]
|
|
|
|
[<B>-rle</B>|<B>-runlength</B>]
|
|
|
|
[<B>-nocenter</B>]
|
|
|
|
[<B>-setpage</B>]
|
|
|
|
[<B>-nosetpage</B>]
|
|
|
|
[<I>pnmfile</I>]
|
|
|
|
<P>
|
|
<P>
|
|
|
|
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.
|
|
<P>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
Reads a Netpbm image as input. Produces Encapsulated PostScript as
|
|
output.
|
|
<A NAME="ixAAC"></A>
|
|
<P>
|
|
|
|
If the input file is in color (PPM),
|
|
<B>pnmtops</B>
|
|
|
|
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
|
|
<B>ppmtopgm</B>
|
|
|
|
first.
|
|
<P>
|
|
If you specify no output dimensioning options, the output image is
|
|
dimensioned as if you had specified
|
|
<B>-scale=1.0</B>,
|
|
|
|
which means aproximately 72 pixels of the input image generate one
|
|
inch of output (if that fits the page).
|
|
<P>
|
|
Use
|
|
<B>-imagewidth</B>,
|
|
|
|
<B>-imageheight</B>,
|
|
|
|
<B>-equalpixels</B>,
|
|
|
|
<B>-width</B>,
|
|
|
|
<B>-height</B>,
|
|
|
|
and
|
|
<B>-scale</B>
|
|
|
|
to adjust that.
|
|
<P>
|
|
<P>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-imagewidth</B>
|
|
|
|
<DD>
|
|
<B>-imageheight</B>
|
|
|
|
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.
|
|
<P>
|
|
If these dimensions are greater than the page size, you get Postscript
|
|
output that runs off the page.
|
|
<P>
|
|
You cannot use
|
|
<B>imagewidth</B>
|
|
|
|
or
|
|
<B>imageheight</B>
|
|
|
|
with
|
|
<B>-scale</B>
|
|
|
|
or
|
|
<B>-equalpixels</B>.
|
|
|
|
<P>
|
|
<DT id="2"><B>-equalpixels</B>
|
|
|
|
<DD>
|
|
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.
|
|
<P>
|
|
You cannot use
|
|
<B>-equalpixels</B>
|
|
|
|
with
|
|
<B>-imagewidth</B>,
|
|
|
|
<B>-imageheight</B>,
|
|
|
|
or
|
|
<B>-scale</B>.
|
|
|
|
<P>
|
|
<DT id="3"><B>-scale</B>
|
|
|
|
<DD>
|
|
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.
|
|
<P>
|
|
But
|
|
<B>pnmtops </B>
|
|
|
|
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
|
|
<B>-scale=1.0</B>,
|
|
|
|
then 75 (not 72) pixels of input becomes one inch of output (4 output
|
|
pixels for each input pixel). Note that the
|
|
<B>-dpi</B>
|
|
|
|
option tell
|
|
<B>pnmtops</B>
|
|
|
|
how many pixels per inch the output device generates.
|
|
<P>
|
|
If the size so specified does not fit on the page (as measured either
|
|
by the
|
|
<B>-width</B>
|
|
|
|
and
|
|
<B>-height</B>
|
|
|
|
options or the default page size of 8.5 inches by 11 inches),
|
|
<B>pnmtops</B>
|
|
|
|
ignores the
|
|
<B>-scale</B>
|
|
|
|
option, issues a warning, and scales the image to fit on the page.
|
|
<P>
|
|
<DT id="4"><B>-dpi</B>
|
|
|
|
<DD>
|
|
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.
|
|
<P>
|
|
Also this option is crucial to the working of the
|
|
<B>equalpixels</B>
|
|
|
|
option.
|
|
<P>
|
|
<DT id="5"><B>-width</B>
|
|
|
|
<DD>
|
|
<BR>
|
|
|
|
<B>-height</B>
|
|
|
|
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.
|
|
<P>
|
|
The page size has no effect, however, when you specify the
|
|
<B>-imagewidth</B>,
|
|
|
|
<B>-imageheight</B>,
|
|
|
|
or
|
|
<B>-equalpixels</B>
|
|
|
|
options.
|
|
<P>
|
|
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
|
|
<B>-nosetpage</B>
|
|
|
|
option.
|
|
<P>
|
|
The default is 8.5 inches by 11 inches.
|
|
<P>
|
|
<DT id="6"><B>-turn</B>
|
|
|
|
<DD>
|
|
<B>-noturn</B>
|
|
|
|
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
|
|
<B>-turn</B>
|
|
|
|
option,
|
|
<B>pnmtops </B>
|
|
|
|
turns the image no matter what its shape; If you specify
|
|
<B>-noturn</B>,
|
|
|
|
<B>pnmtops</B>
|
|
|
|
does
|
|
<I>not</I>
|
|
|
|
turn it no matter what its shape.
|
|
<DT id="7"><B>-rle</B>
|
|
|
|
<DD>
|
|
<B>-runlength</B>
|
|
|
|
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
|
|
<B>-rle</B>
|
|
|
|
makes things slower.
|
|
<DT id="8"><B>-nocenter</B>
|
|
|
|
<DD>
|
|
By default,
|
|
<B>pnmtops</B>
|
|
|
|
centers the image on the output page.
|
|
You can cause
|
|
<B>pnmtops</B>
|
|
|
|
to instead put the image against the upper left corner of the page with
|
|
the
|
|
<B>-nocenter </B>
|
|
|
|
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.
|
|
<P>
|
|
For backward compatibility,
|
|
<B>pnmtops</B>
|
|
|
|
accepts the option
|
|
<B>-center</B>,
|
|
|
|
but it has no effect.
|
|
<P>
|
|
<DT id="9"><B>-setpage</B>
|
|
|
|
<DD>
|
|
<B>pnmtops </B>
|
|
|
|
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
|
|
<B>width</B>
|
|
|
|
and
|
|
<B>height</B>
|
|
|
|
options or defaulted. If you want a "setpagedevice" directive in the
|
|
output, specify
|
|
<B>-setpage</B>.
|
|
|
|
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.
|
|
<P>
|
|
Before release 10.0 the default was to generate the "setpagedevice" directive,
|
|
and there is the switch
|
|
<B>-nosetpage</B>
|
|
|
|
to supress it, but that's actually a no-op now.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+pnm">pnm</A></B>(5),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+gs">gs</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+psidtopgm">psidtopgm</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+pstopnm">pstopnm</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+pbmtolps">pbmtolps</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+pbmtoepsi">pbmtoepsi</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+pbmtopsg3">pbmtopsg3</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+ppmtopgm">ppmtopgm</A></B>(1),
|
|
|
|
<P>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
Copyright (C) 1989, 1991 by Jef Poskanzer.
|
|
<BR>
|
|
|
|
Modified November 1993 by Wolfgang Stuerzlinger, <A HREF="mailto:wrzl@gup.uni-linz.ac.at">wrzl@gup.uni-linz.ac.at</A>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="10"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="11"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="12"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="13"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="14"><A HREF="#lbAF">SEE ALSO</A><DD>
|
|
<DT id="15"><A HREF="#lbAG">AUTHOR</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:24 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|