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 PJL commands at the start of a file are removed. DOS EPS binary files
26 (TN 5002) are supported.
27 If the bounding box in the input is incorrect, of course there will be
29 resulting problems.
30
32 Options may start with either "-" or "--", and may be unambiguously
33 abbreviated. It is best to use the full option name in scripts to
34 avoid possible collisions with new options in the future.
35 General script options:
37 --help display help message and exit
39 --version
41 display version information and exit
42 --outfile=file
44 write result to file. If this option is not given, and --nogs
45 or --filter is specified, write to standard output; otherwise,
46 the default is to construct the output file name by replacing
47 any extension in the input file with `.pdf'.
48 --[no]debug
50 write debugging info (default: false).
51 --[no]exact
53 scan ExactBoundingBox (default: false).
54 --[no]filter
56 read standard input and (unless --outfile is given) write stan‐
57 dard output (default: false).
58 --[no]gs
60 run Ghostscript (default: true). With --nogs, output (to stan‐
61 dard output by default) the PostScript that would normally be
62 converted; that is, the input PostScript as modified by
63 epstopdf.
64 --[no]hires
66 scan HiresBoundingBox (default: false).
67 --restricted=val
69 turn on restricted mode (default: [true for repstopdf, else
70 false]); this forbids the use of --gscmd and other options and
71 imposes restrictions on the input and output file names accord‐
72 ing to the values of openin_any and openout_any (see the Web2c
73 manual, http://tug.org/web2c).
74 Options for Ghostscript (more info below):
76 --gscmd=val
78 pipe output to val (default: [gswin32c on Windows, else gs])
79 --gsopt=val
81 include val as one argument in the gs command (can be repeated).
82 --gsopts=val
84 split val at whitespace and include each resulting word as an
85 argument in the gs command (can be repeated).
86 --autorotate=val
88 set AutoRotatePages (default: None); recognized val choices:
89 None, All, PageByPage. For EPS files, PageByPage is equivalent
90 to All.
91 --[no]compress
93 use compression in the output (default: true); if turned off,
94 passes -dUseFlateCompression=false.
95 --device=dev
97 use -sDEVICE=dev (default: pdfwrite); not allowed in restricted
98 mode.
99 --[no]embed
101 embed fonts (default: true); passes -dMaxSubsetPct=100 -dSubset‐
102 Fonts=true -dEmbedAllFonts=true.
103 --[no]gray
105 grayscale output (default: false); passes -sColorConversion‐
106 Strategy=Gray -dProcessColorModel=/DeviceGray.
107 --pdfsettings=val
109 use -dPDFSETTINGS=/val (default is `prepress' if --embed, else
110 empty); recognized val choices: screen, ebook, printer, pre‐
111 press, default.
112 --[no]quiet
114 use -q, a.k.a. -dQUIET (default: false).
115 --res=dpi, dpixdpi
117 set image resolution (default: [use gs default]); ignored if
118 --debug is set.
119 --[no]safer
121 use -d(NO)QUIET (default: true).
122 In addition to the specific options above, additional options to be
124 used with gs can be specified with either or both of the two cumulative
125 options --gsopts and --gsopt.
126 --gsopts takes a single string of options, which is split at white‐
128 space, each resulting word then added to the gs command line individu‐
129 ally.
130 --gsopt adds its argument as a single option to the gs command line.
132 It can be used multiple times to specify options separately, and is
133 necessary if an option or its value contains whitespace.
134 In restricted mode, options are limited to those with names and values
136 known to be safe. Some options taking booleans, integers or fixed
137 names are allowed, those taking general strings are not.
138
141 These examples all equivalently convert `test.eps' to `test.pdf':
142 epstopdf test.eps
143 epstopdf test.eps test.pdf
144 cat test.eps | epstopdf --filter >test.pdf
145 cat test.eps | epstopdf -f -o=test.pdf
146 Example for using HiResBoundingBox instead of BoundingBox:
148 epstopdf --hires test.eps
149 Example for epstopdf's attempt at correcting PostScript:
151 $program --nogs test.ps >testcorr.ps
152 In all cases, you can add --debug (-d) to see more about what epstopdf
154 is doing.
155
157 The case of "%%BoundingBox: (atend)" when input is not seekable (e.g.,
158 from a pipe) is not supported.
159 Report bugs in the program or this man page to tex-k@tug.org. When
161 reporting bugs, please include an input file and the command line
162 options specified, so the problem can be reproduced.
163
165 gs(1), pdfcrop(1).
166 The epstopdf LaTeX package, part of the oberdiek bundle, which auto‐
168 mates running this script on the fly under TeX:
169 http://ctan.org/pkg/epstopdf-pkg.
170
172 Originally written by Sebastian Rahtz, for Elsevier Science, with sub‐
173 sequent contributions from Thomas Esser, Gerben Wierda, Heiko Oberdiek,
174 and many others. Currently maintained by Karl Berry.
175 Man page originally written by Jim Van Zandt.
177 epstopdf home page: http://tug.org/epstopdf.
179 You may freely use, modify and/or distribute this file.
181 7 January 2017 EPSTOPDF(1)