Provided by: netpbm_10.0-12.2_i386 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)