NAME

       epstopdf, repstopdf - convert an EPS file to PDF

SYNOPSIS

       epstopdf [options] [epsfile]

DESCRIPTION

       By default, epstopdf converts the input PostScript file to PDF, using Ghostscript.

       Epstopdf  transforms  the Encapsulated PostScript file epsfile (or standard input) so that
       it is guaranteed to start at  the  0,0  coordinate,  and  it  sets  a  page  size  exactly
       corresponding  to  the  BoundingBox.   Thus,  the  result  needs  no cropping, and the PDF
       MediaBox is correct.

       PJL commands at the start of a file are removed.  DOS  EPS  binary  files  (TN  5002)  are
       supported.

       If the bounding box in the input is incorrect, of course there will be resulting problems.

OPTIONS

       Options  may  start  with either "-" or "--", and may be unambiguously abbreviated.  It is
       best to use the full option name in scripts, though, to avoid possible collisions with new
       options in the future.

       General script options:

       --help display help message and exit

       --version
              display version information and exit

       --outfile=file
              write  result  to  file.   If  this  option is not given, and --nogs or --filter is
              specified, write to standard output; otherwise, the default  is  to  construct  the
              output file name by replacing any extension in the input file with `.pdf'.

       --[no]debug
              write debugging info (default: off).

       --[no]exact
              scan ExactBoundingBox (default: off).

       --[no]filter
              read standard input and (unless --outfile is given) write standard output (default:
              off).

       --[no]gs
              run Ghostscript (default: on).  With --nogs, output (to standard output by default)
              the  PostScript  that would normally be converted; that is, the input PostScript as
              modified by epstopdf.

       --[no]hires
              scan HiresBoundingBox (default: off).

       --restricted=val
              turn on restricted mode (default: [on for repstopdf, else off]); this  forbids  the
              use  of  --gscmd  and --gsopt and imposes restrictions on the input and output file
              names according to the values of openin_any and openout_any (see the Web2c  manual,
              http://tug.org/web2c).

       Options for Ghostscript (more info below):

       --gscmd=val
              pipe output to val (default: [gswin32c on Windows, else gs])

       --gsopt=val
              include val as one argument in the gs command (can be repeated),

       --gsopts=val
              split  val  at  whitespace,  include  each  resulting word as an argument in the gs
              command (can be repeated)

       --autorotate=val
              set AutoRotatePages (default: None); recognized val choices: None, All, PageByPage.
              For EPS files, PageByPage is equivalent to All.

       --[no]compress
              use compression in the output (default: on).

       --device=dev
              use  -sDEVICE=dev  (default:  pdfwrite);  not all devices are allowed in restricted
              mode.

       --[no]embed
              embed fonts (default: on).

       --pdfsettings=val
              use -dPDFSETTINGS=/val (default is `prepress' if --embed, else  empty);  recognized
              val choices: screen, ebook, printer, prepress, default.

       --[no]quiet
              use -q, a.k.a. -dQUIET (default: off).

       --res=dpi, dpixdpi
              set image resolution (default: [use gs default]); ignored if --debug is set.

       --[no]safer
              use -d(NO)QUIET (default: true).

       In  addition  to  the specific options above, additional options to be used with gs can be
       specified with either or both of the two cumulative options --gsopts and --gsopt.

       --gsopts takes a single string of options, which is split at  whitespace,  each  resulting
       word then added to the gs command line individually.

       --gsopt  adds  its  argument  as  a  single option to the gs command line.  It can be used
       multiple times to specify options separately, and is necessary if an option or  its  value
       contains whitespace.

       In  restricted  mode, options are limited to those with names and values known to be safe;
       some options taking booleans, integers or fixed names are allowed,  those  taking  general
       strings are not.

EXAMPLES

       Examples all equivalently converting `test.eps' to `test.pdf':
       epstopdf test.eps
       cat test.eps | epstopdf --filter >test.pdf
       cat test.eps | epstopdf -f -o=test.pdf

       Example for using HiResBoundingBox instead of BoundingBox:
       epstopdf --hires test.eps

       Example for producing epstopdf's attempt at corrected PostScript:
       $program --nogs test.ps >testcorr.ps

       In all cases, you can add --debug (-d) to see more about what epstopdf is doing.

BUGS

       The case of "%%BoundingBox: (atend)" when input is not seekable (e.g., from a pipe) is not
       supported.

       Report bugs in the program or this man page to tex-k@tug.org.  When reporting bugs, please
       include  an  input  file  and  the  command  line options specified, so the problem can be
       reproduced.

SEE ALSO

       gs(1), pdfcrop(1).

       The epstopdf LaTeX package, part of the oberdiek  bundle,  which  automates  running  this
       script on the fly under TeX: http://ctan.org/pkg/epstopdf-pkg.

AUTHOR

       Originally written by Sebastian Rahtz, for Elsevier Science, with subsequent contributions
       from Thomas Esser, Gerben Wierda, Heiko Oberdiek, and many others.   Currently  maintained
       by Karl Berry.

       Man page originally written by Jim Van Zandt.

       epstopdf home page: http://tug.org/epstopdf.

       You may freely use, modify and/or distribute this file.

                                         17 January 2014                              EPSTOPDF(1)