manpagez: man pages & more
man repstopdf(1)
Home | html | info | man
epstopdf(1)                                                        epstopdf(1)




NAME

       epstopdf, repstopdf - convert an EPS file to PDF


SYNOPSIS

       epstopdf [options] [epsfile [pdffile.pdf]]


DESCRIPTION

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

       Epstopdf transforms the Encapsulated PostScript file epsfile (or  stan-
       dard  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.

       By  default,  the  output  name  is  the  input name with any extension
       replaced by .pdf.  An output name ending with .pdf can also be given as
       a second argument on the command line, or the --outfile (-o) option can
       be used with any name.

       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 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: false).

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

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

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

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

       --restricted=val
              turn  on  restricted  mode  (default:  [true for repstopdf, else
              false]); this forbids the use of --gscmd and other  options  and
              imposes  restrictions on the input and output file names accord-
              ing 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 and 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: true); if turned off,
              passes -dUseFlateCompression=false.

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

       --[no]embed
              embed fonts (default: true); passes -dMaxSubsetPct=100 -dSubset-
              Fonts=true -dEmbedAllFonts=true.

       --[no]gray
              grayscale output  (default:  false);  passes  -sColorConversion-
              Strategy=Gray -dProcessColorModel=/DeviceGray.

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

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

       --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  white-
       space,  each resulting word then added to the gs command line individu-
       ally.

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

       These examples all equivalently convert `test.eps' to `test.pdf':
       epstopdf test.eps
       epstopdf test.eps test.pdf
       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 epstopdf's attempt at correcting 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  auto-
       mates    running    this    script    on    the    fly    under    TeX:
       http://ctan.org/pkg/epstopdf-pkg.


AUTHOR

       Originally written by Sebastian Rahtz, for Elsevier Science, with  sub-
       sequent 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.



                                7 January 2017                     epstopdf(1)

texlive-fontutils 44166 - Generated Tue Jun 20 13:48:52 CDT 2017
© manpagez.com 2000-2021
Individual documents may contain additional copyright information.