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       PJL commands at the start of a file are removed.  DOS EPS binary  files
26       (TN 5002) are supported.
27
28       If  the bounding box in the input is incorrect, of course there will be
29       resulting problems.
30

OPTIONS

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
36       General script options:
37
38       --help display help message and exit
39
40       --version
41              display version information and exit
42
43       --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
49       --[no]debug
50              write debugging info (default: false).
51
52       --[no]exact
53              scan ExactBoundingBox (default: false).
54
55       --[no]filter
56              read  standard input and (unless --outfile is given) write stan‐
57              dard output (default: false).
58
59       --[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
65       --[no]hires
66              scan HiresBoundingBox (default: false).
67
68       --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
75       Options for Ghostscript (more info below):
76
77       --gscmd=val
78              pipe output to val (default: [gswin32c on Windows, else gs])
79
80       --gsopt=val
81              include val as one argument in the gs command (can be repeated).
82
83       --gsopts=val
84              split  val  at  whitespace and include each resulting word as an
85              argument in the gs command (can be repeated).
86
87       --autorotate=val
88              set AutoRotatePages (default:  None);  recognized  val  choices:
89              None,  All, PageByPage.  For EPS files, PageByPage is equivalent
90              to All.
91
92       --[no]compress
93              use compression in the output (default: true);  if  turned  off,
94              passes -dUseFlateCompression=false.
95
96       --device=dev
97              use  -sDEVICE=dev (default: pdfwrite); not allowed in restricted
98              mode.
99
100       --[no]embed
101              embed fonts (default: true); passes -dMaxSubsetPct=100 -dSubset‐
102              Fonts=true -dEmbedAllFonts=true.
103
104       --[no]gray
105              grayscale  output  (default:  false);  passes -sColorConversion‐
106              Strategy=Gray -dProcessColorModel=/DeviceGray.
107
108       --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
113       --[no]quiet
114              use -q, a.k.a. -dQUIET (default: false).
115
116       --res=dpi, dpixdpi
117              set image resolution (default: [use  gs  default]);  ignored  if
118              --debug is set.
119
120       --[no]safer
121              use -d(NO)QUIET (default: true).
122
123       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
127       --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
131       --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
135       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
139

EXAMPLES

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
147       Example for using HiResBoundingBox instead of BoundingBox:
148       epstopdf --hires test.eps
149
150       Example for epstopdf's attempt at correcting PostScript:
151       $program --nogs test.ps >testcorr.ps
152
153       In  all cases, you can add --debug (-d) to see more about what epstopdf
154       is doing.
155

BUGS

157       The case of "%%BoundingBox: (atend)" when input is not seekable  (e.g.,
158       from a pipe) is not supported.
159
160       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

SEE ALSO

165       gs(1), pdfcrop(1).
166
167       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

AUTHOR

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
176       Man page originally written by Jim Van Zandt.
177
178       epstopdf home page: http://tug.org/epstopdf.
179
180       You may freely use, modify and/or distribute this file.
181
182
183
184                                7 January 2017                     EPSTOPDF(1)
Impressum