1EPSTOPDF(1) General Commands Manual EPSTOPDF(1)
2
6 epstopdf, repstopdf - convert an EPS file to PDF
7
9 epstopdf [options] [epsfile [pdffile.pdf]]
10
12 By default, epstopdf converts the input PostScript file to PDF, using
13 Ghostscript.
14 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 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 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 PJL commands at the start of a file are removed. DOS EPS binary files
32 (TN 5002) are supported.
33 If the bounding box in the input is incorrect, of course there will be
35 resulting problems.
36
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 General script options:
43 --help display help message and exit
45 --version
47 display version information and exit
48 --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 --[no]debug
56 write debugging info (default: false).
57 --[no]exact
59 scan ExactBoundingBox (default: false).
60 --[no]filter
62 read standard input and (unless --outfile is given) write stan‐
63 dard output (default: false).
64 --[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 --[no]hires
72 scan HiresBoundingBox (default: false).
73 --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 Options for Ghostscript (more info below):
82 --gscmd=val
84 pipe output to val (default: [gswin32c on Windows, else gs])
85 --gsopt=val
87 include val as one argument in the gs command (can be repeated).
88 --gsopts=val
90 split val at whitespace and include each resulting word as an
91 argument in the gs command (can be repeated).
92 --autorotate=val
94 set AutoRotatePages (default: None); recognized val choices:
95 None, All, PageByPage. For EPS files, PageByPage is equivalent
96 to All.
97 --[no]compress
99 use compression in the output (default: true); if turned off,
100 passes -dUseFlateCompression=false.
101 --device=dev
103 use -sDEVICE=dev (default: pdfwrite); not allowed in restricted
104 mode.
105 --[no]embed
107 embed fonts (default: true); passes -dMaxSubsetPct=100 -dSubset‐
108 Fonts=true -dEmbedAllFonts=true.
109 --[no]gray
111 grayscale output (default: false); passes -sColorConversion‐
112 Strategy=Gray -dProcessColorModel=/DeviceGray.
113 --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 --[no]quiet
120 use -q, a.k.a. -dQUIET (default: false).
121 --res=dpi, dpixdpi
123 set image resolution (default: [use gs default]); ignored if
124 --debug is set.
125 --[no]safer
127 use -d(NO)QUIET (default: true).
128 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 --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 --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 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
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 Example for using HiResBoundingBox instead of BoundingBox:
154 epstopdf --hires test.eps
155 Example for epstopdf's attempt at correcting PostScript:
157 $program --nogs test.ps >testcorr.ps
158 In all cases, you can add --debug (-d) to see more about what epstopdf
160 is doing.
161
163 The case of "%%BoundingBox: (atend)" when input is not seekable (e.g.,
164 from a pipe) is not supported.
165 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
171 gs(1), pdfcrop(1).
172 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
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 Man page originally written by Jim Van Zandt.
183 epstopdf home page: http://tug.org/epstopdf.
185 You may freely use, modify and/or distribute this man page.
187 17 September 2018 EPSTOPDF(1)