Provided by: netpbm_10.0-15_amd64 bug

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)