View Source: pnmtops(1) - Waikato Linux Users Group

Edit PageHistory Diff Info LikePages
pnmtops
!!!pnmtops
NAME
SYNOPSIS
DESCRIPTION
OPTIONS
SEE ALSO
AUTHOR
----
!!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__]
[[__-center__|__-nocenter__]
[[''pnmfile'']
!!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 such that 72 pixels of the input image
generate one inch of output image. Except if that would
exceed the default page size (8.5 inches by 11 inches), the
output image is shrunk enough to fit.


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 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.


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__ options,
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 affects the
size of the output image.


The page size has no effect, however, when you specify the
__-imagewidth__, __-imageheight__, or
__-equalpixels__ options.


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 is wider than it is
tall, 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.


__-center__


__-nocenter__ By default, __pnmtops__ centers the
image on the output page. You can specify this explicitly
with the __-center__ option, or cause __pnmtops__ to
instead put the image against the upper left corner of the
page with the __-nocenter__ option. The latter is useful
for programs which can include !PostScript files, but can't
cope with pictures which are not positioned in the upper
left corner.


All options can be abbreviated to their shortest unique
prefix.
!!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
----
8 pages link to pnmtops(1):
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.
Last edited on Tuesday, June 4, 2002 12:22:44 am by "perry"
Edit PageHistory Diff Info LikePages