xenial (1) sam2p.1.gz

Provided by: sam2p_0.49.2-3+deb8u3build0.16.04.1_amd64 bug

NAME

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

SYNOPSIS

       sam2p [options] infile outfile
       sam2p [options] jobfile

DESCRIPTION

       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.

EXAMPLES

       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 psl3:outfile.ps

            sam2p -ps:3 infile.gif outfile.ps

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

            sam2p -1 -c:lzw infile.gif outfile.ps

OPTIONS

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

       -m:dimen
              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

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

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

       -m:dpi:-res
              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)

       -j:quiet
              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 file).

SUPPORTED FILE FORMATS

       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.

SEE ALSO

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

AUTHOR

       sam2p was written by Szabó Péter <pts@fazekas.hu>.

       This manual page was written by Stefan Fritsch <sf@sfritsch.de>, 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)