Provided by: sam2p_0.49.2-3_amd64 bug


       sam2p - program to convert raster images to PostScript, PDF, and other formats


       sam2p [options] infile outfile
       sam2p [options] jobfile


       This  manual  page  documents  briefly  the  sam2p command.  It was written for the Debian
       distribution because the original program does not  have  a  manual  page.   The  complete
       documentation can be found in /usr/share/doc/sam2p/README.gz

       sam2p  is a program that converts many raster (bitmap) image formats into Adobe PostScript
       or PDF files and several other formats.  The images are not vectorized.  sam2p gives  full
       control to the user to specify standards-compliance, compression, and bit depths.

       sam2p  can operate in two modes: one-liner mode and job mode.  In job mode the user has to
       write a ``job'' file which specifies the conversion parameters and allows full control  of
       all  aspects  of  the  final  output.  This  manpage  deals  only with one-liner mode, see
       /usr/share/doc/sam2p/README.gz for details on job mode.


       To convert an image file to EPS, use:

            sam2p infile.gif outfile.eps

       The output format is guessed from the file extension. Optionally, the output  format  also
       can  be  specified  as option or as prefix to the output file.  For example, the following
       commands produce postscript level 3:

            sam2p infile.gif

            sam2p -ps:3 infile.gif

       sam2p can include its own (zip and lzw) decompression filter in Postscript files, allowing
       better compression than normally supported by Postscript level 1:

            sam2p -1 -c:zip infile.gif

            sam2p -1 -c:lzw infile.gif


       -1, -ps:1, psl1:
              produce Postscript Level 1

       -1c, -ps:1c, pslc:
              produce Postscript Level 1 with the CMYK and `colorimage' extension

       -2, -ps:2, psl2:
              produce Postscript Level 2 (default for postscript)

       -3, -ps:3, psl3:
              produce Postscript Level 3

       -pdf:b0, pdfb1.0:
              produce PDF version 1.0 (BI inline image)

       -pdf:b2, pdfb1.2:
              produce PDF version 1.2 (BI inline image) (default for PDF)

       -pdf:0, pdf1.0:
              produce PDF version 1.0 (XObject image)

       -pdf:2, pdf1.2:
              produce PDF version 1.2 (XObject image)

       -e:0, -e:none
              don't scale

       -e, -e:1, -e:scale
              scale image to fit page

       -e:rot, -e:rotate
              scale and rotate image to fit page (default if output filename has .ps extension)

              set all page margins to dimen
              dimen  can have one of the following units (as in TeX): bp, in, pt, pc, dd, cc, sp,
              cm, mm

              set spec margin(s) to dimen (spec can be l,  r, t, b, v (top and bottom),  h  (left
              and right))

              set output EPS or PDF to resolution 72*72/res dpi

              set output EPS or PDF to resolution res dpi

       -c:none, -c:lzw, -c:zip, -c:rle, -c:fax, -c:dct, -c:jpeg
              select compression type (support depends on output format)

              print only error and fatal error messages, suppress warnings, notices etc.  Must be
              put at the beginning of the command line to suppress initial banners, too.

       --     If not the last argument: treat all further  arguments  as  files  (required  if  a
              filename contains a colon or starts with a minus)
              If  the  last argument: use input filename as output filename (i.e. overwrite input


       Input formats:
              PNM, PBM, PGM, PPM, XPM, GIF, LBM, TGA, PCX,
              JPEG (requires djpeg from package libjpeg-progs),
              TIFF (requires tifftopnm from package netpbm),
              PNG (requires pngtopnm from package netpbm),
              PS, EPS, PDF (require ghostscript)

       Output formats:
              XWD, BMP, PNG, TIFF6, JPEG, PNM, GIF89a, XPM, PS (levels 1,2,3), EPS (levels  2,3),
              PDF (1.0 and 1.2)

              For some formats, sam2p supports transparency.  See the README file for more info.


       The program is documented fully in /usr/share/doc/sam2p/README.gz


       sam2p was written by Szabó Péter <>.

       This  manual  page  was written by Stefan Fritsch <>, for the Debian project
       (but may be used by others under the terms of the GNU General Public License, Version 2).

                                         January 23, 2005                                SAM2P(1)