1EPSTOPDF(1)                 General Commands Manual                EPSTOPDF(1)
2
3
4

NAME

6       epstopdf, repstopdf - convert an EPS file to PDF
7

SYNOPSIS

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

DESCRIPTION

12       By  default,  epstopdf converts the input PostScript file to PDF, using
13       Ghostscript.
14
15       Epstopdf transforms the Encapsulated PostScript file epsfile (or  stan‐
16       dard  input)  so  that it is guaranteed to start at the 0,0 coordinate,
17       and it sets a page  size  exactly  corresponding  to  the  BoundingBox.
18       Thus, the result needs no cropping, and the PDF MediaBox is correct.
19
20       By  default,  the  output  name  is  the  input name with any extension
21       replaced by .pdf.  An output name ending with .pdf can also be given as
22       a second argument on the command line, or the --outfile (-o) option can
23       be used with any name.
24
25       The output is PDF 1.5 by default; use, e.g.,
26       --gsopt=-dCompatibilityLevel=1.7
27       to change this. (Until epstopdf 2.28 (released September 2018), the PDF
28       version  was  whatever  the underlying Ghostscript or other interpreter
29       produced by default.)
30
31       PJL commands at the start of a file are removed.  DOS EPS binary  files
32       (TN 5002) are supported.
33
34       If  the bounding box in the input is incorrect, of course there will be
35       resulting problems.
36

OPTIONS

38       Options may start with either "-" or "--",  and  may  be  unambiguously
39       abbreviated.   It  is  best  to  use the full option name in scripts to
40       avoid possible collisions with new options in the future.
41
42       General script options:
43
44       --help display help message and exit
45
46       --version
47              display version information and exit
48
49       --outfile=file
50              write result to file.  If this option is not given,  and  --nogs
51              or  --filter  is specified, write to standard output; otherwise,
52              the default is to construct the output file  name  by  replacing
53              any extension in the input file with `.pdf'.
54
55       --[no]debug
56              write debugging info (default: false).
57
58       --[no]exact
59              scan ExactBoundingBox (default: false).
60
61       --[no]filter
62              read  standard input and (unless --outfile is given) write stan‐
63              dard output (default: false).
64
65       --[no]gs
66              run Ghostscript (default: true).  With --nogs, output (to  stan‐
67              dard  output  by  default) the PostScript that would normally be
68              converted;  that  is,  the  input  PostScript  as  modified   by
69              epstopdf.
70
71       --[no]hires
72              scan HiresBoundingBox (default: false).
73
74       --restricted=val
75              turn  on  restricted  mode  (default:  [true for repstopdf, else
76              false]); this forbids the use of --gscmd and other  options  and
77              imposes  restrictions on the input and output file names accord‐
78              ing to the values of openin_any and openout_any (see  the  Web2c
79              manual, http://tug.org/web2c).
80
81       Options for Ghostscript (more info below):
82
83       --gscmd=val
84              pipe output to val (default: [gswin32c on Windows, else gs])
85
86       --gsopt=val
87              include val as one argument in the gs command (can be repeated).
88
89       --gsopts=val
90              split  val  at  whitespace and include each resulting word as an
91              argument in the gs command (can be repeated).
92
93       --autorotate=val
94              set AutoRotatePages (default:  None);  recognized  val  choices:
95              None,  All, PageByPage.  For EPS files, PageByPage is equivalent
96              to All.
97
98       --[no]compress
99              use compression in the output (default: true);  if  turned  off,
100              passes -dUseFlateCompression=false.
101
102       --device=dev
103              use  -sDEVICE=dev (default: pdfwrite); not allowed in restricted
104              mode.
105
106       --[no]embed
107              embed fonts (default: true); passes -dMaxSubsetPct=100 -dSubset‐
108              Fonts=true -dEmbedAllFonts=true.
109
110       --[no]gray
111              grayscale  output  (default:  false);  passes -sColorConversion‐
112              Strategy=Gray -dProcessColorModel=/DeviceGray.
113
114       --pdfsettings=val
115              use -dPDFSETTINGS=/val (default is `prepress' if  --embed,  else
116              empty);  recognized  val  choices:  screen, ebook, printer, pre‐
117              press, default.
118
119       --[no]quiet
120              use -q, a.k.a. -dQUIET (default: false).
121
122       --res=dpi, dpixdpi
123              set image resolution (default: [use  gs  default]);  ignored  if
124              --debug is set.
125
126       --[no]safer
127              use -d(NO)QUIET (default: true).
128
129       In  addition  to  the  specific options above, additional options to be
130       used with gs can be specified with either or both of the two cumulative
131       options --gsopts and --gsopt.
132
133       --gsopts  takes  a  single  string of options, which is split at white‐
134       space, each resulting word then added to the gs command line  individu‐
135       ally.
136
137       --gsopt  adds  its  argument as a single option to the gs command line.
138       It can be used multiple times to specify  options  separately,  and  is
139       necessary if an option or its value contains whitespace.
140
141       In  restricted mode, options are limited to those with names and values
142       known to be safe.  Some options  taking  booleans,  integers  or  fixed
143       names are allowed, those taking general strings are not.
144
145

EXAMPLES

147       These examples all equivalently convert `test.eps' to `test.pdf':
148       epstopdf test.eps
149       epstopdf test.eps test.pdf
150       cat test.eps | epstopdf --filter >test.pdf
151       cat test.eps | epstopdf -f -o=test.pdf
152
153       Example for using HiResBoundingBox instead of BoundingBox:
154       epstopdf --hires test.eps
155
156       Example for epstopdf's attempt at correcting PostScript:
157       $program --nogs test.ps >testcorr.ps
158
159       In  all cases, you can add --debug (-d) to see more about what epstopdf
160       is doing.
161

BUGS

163       The case of "%%BoundingBox: (atend)" when input is not seekable  (e.g.,
164       from a pipe) is not supported.
165
166       Report  bugs  in  the  program or this man page to tex-k@tug.org.  When
167       reporting bugs, please include an  input  file  and  the  command  line
168       options specified, so the problem can be reproduced.
169

SEE ALSO

171       gs(1), pdfcrop(1).
172
173       The  epstopdf  LaTeX  package, part of the oberdiek bundle, which auto‐
174       mates    running    this    script    on    the    fly    under    TeX:
175       http://ctan.org/pkg/epstopdf-pkg.
176

AUTHOR

178       Originally  written by Sebastian Rahtz, for Elsevier Science, with sub‐
179       sequent contributions from Thomas Esser, Gerben Wierda, Heiko Oberdiek,
180       and many others.  Currently maintained by Karl Berry.
181
182       Man page originally written by Jim Van Zandt.
183
184       epstopdf home page: http://tug.org/epstopdf.
185
186       You may freely use, modify and/or distribute this man page.
187
188
189
190                               17 September 2018                   EPSTOPDF(1)
Impressum