summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/support/epspdf/index.html
blob: b8ccb57ce908aff74c64059f6a27fa245d893227 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
<!doctype html>

<html>

<head>

<link rel="stylesheet" href="default.css" type="text/css" />

<title>Epspdf and epspdftk</title>

</head><body>

<div id="pagehead">

<h1>Epspdf and epspdftk</h1>

<p>A cross-platform GUI- and command-line converter
for [e]ps and pdf.</p>

<p><i>Siep Kroonenberg,<br /><tt>siepo at cybercomm
dot nl</tt></i></p>

</div>

<p id="logo"><img src="images/epspdf.png" alt="" /></p>

<p><a href="http://tex.aanhet.net/epspdf/">Current online version of
this page</a></p>

<p><a href="http://tex.aanhet.net/epspdf/legacy.html">Legacy
Ruby-based versions</a></p>

<h2>Table of Contents</h2>

<ul>
<li><a href="#features">Features</a></li>
<li><a href="#introduction">Introduction</a></li>
<li><a href="#prerequisites">Prerequisites</a></li>
<li><a href="#install">Installation</a></li>
<li><a href="#files">Files</a></li>
<li><a href="#releases">Releases</a></li>
</ul>

<h2><a name="features" />Features</h2>

<ul>
<li>Distiller</li>
<li>Works both for documents and for graphics</li>
<li>Single-page selection</li>
<li>Also converts from pdf back to PostScript and eps</li>
<li>Removal of preview headers from eps files</li>
<li>Cropping extra whitespace</li>
<li>Grayscaling</li>
<li>GUI- and command-line use</li>
<li>GUI-configurable preferences</li>
<li>Multiplatform: works unchanged on Windows and Unix/Linux</li>
<li>Support for TeX Live and MiKTeX</li>
</ul>

<h2><a name="introduction" />Introduction</h2>

<p>For TeX and its derivatives, eps and pdf are the preferred
graphics formats. Epspdf and epspdftk can convert between these,
with various conversion options, and can also handle PostScript
files which aren't eps files. PSTricks users may appreciate the
capability to go from pdf back to PostScript.</p>

<p>Epspdftk is the GUI component, with buttons to select options and
with file dialogs for opening and saving files.</p>

<p>Epspdf is the command-line component, which is used by epspdftk
but can also be used on its own. It uses Ghostscript, luatex and
optionally pdftops to do the real work. Multistep conversions extend
the possibilities.</p>

<p>Conversion options include grayscaling, page selection, computing
a tight boundingbox and some pdf options.</p>

<p>The third-party LaTeX package epspdfconversion uses epspdf for
  on-the-fly conversion of eps graphics to pdf, with options to
  control grayscaling and boundingbox generation. See CTAN or your
  TeX distribution.</p>

<p>The command-line program epspdf is written in texlua, which is
part of recent versions of MikTeX and TeX Live. Versions <a
href="http://tex.aanhet.net/epspdf/legacy.html">prior to 0.6</a>
were written in Ruby. Epspdftk, its GUI companion, is written in in
Tcl/Tk.</p>

<p>Starting with the 2008 edition, TeX Live includes epspdf in some
form as an optional package.</p>

<h2><a name="prerequisites" />Prerequisites</h2>

<p>These are the required and optional prerequisites, which will be
checked for when epspdf starts:</p>
<ul>

<li>A somewhat recent TeX installation, either <a
  href="http://www.tug.org/texlive/">TeX Live</a> or <a
  href="http://miktex.org/">MiKTeX</a>. If this is not an option,
  get a <a href="http://tex.aanhet.net/epspdf/legacy.html">legacy
  version</a> of epspdf instead.</li>

<li><a href="http://ghostscript.com">Ghostscript</a>. This is
  already part of MiKTeX and of TeX Live for Windows, and packaged
  for most Linux distributions.</li>

<li>Optional: pdftops from
 the <a href="http://www.foolabs.com/xpdf/">xpdf suite</a> or from
 the <a href="http://poppler.freedesktop.org/">Poppler
 utilities</a>, or as a package from your Linux
 distribution. Pdftops may do a better job than Ghostscript of
 preserving scalable fonts when converting from pdf to ps, although
 Ghostscript is steadily improving in this respect. Included in TeX
 Live for Windows and in recent versions of MiKTeX. If you have an
 old MiKTeX and a copy of pdftops.exe, then you can point epspdf to
 this file from within the GUI. You need to do this only once.</li>

<li><a href="http://www.tcl.tk/">Tcl/Tk</a> for the GUI
  interface. Version 8.6 has been tested. Packaged for many or most
  Linux distributions, and also available
  from <a href="http://www.activestate.com/activetcl">ActiveState</a>.
  Alternatively, a single-file TclKit runtime will
  do. The <a href="http://wiki.tcl.tk/52">TclKit</a> page contains
  various links to precompiled binaries.</li>

<li>Optional: viewers for PostScript and pdf</li>

</ul>

<h2><a name="install" />Installation</h2>

<p>If you have a sufficiently recent standalone TeX Live and have a
   Tcl/Tk installation or runtime, just
   install the TeX Live package. Otherwise:</p>

<h3>Unix/Linux</h3>

<p>Unpack the archive somewhere and create symlinks to epspdf.tlu
   and epspdftk.tcl in a directory on your searchpath.</p>

<h3>Windows setup program</h3>

<p>This is a conventional Windows installer. If it does not find
texlua.exe on the searchpath then it gives a warning and a
opportunity to abort. Note though that texlua only needs to be
available at runtime. It creates a shortcut to the epspdftk GUI and
it also creates an uninstaller.</p>

<p>It installs epspdftk in the form of a so-called
<em>starpack</em>, which consists of the epspdftk script and a
Tcl/Tk runtime, combined into a single executable.  The Tcl/Tk 8.6
runtime is from <a href="http://www.patthoyts.tk/tclkit/"> Patrick
Thoyts&rsquo; bleeding edge builds</a>. The command-line
script epspdf.tlu remains a separate file.</p>

<p>This installer has been created
with <a href="http://nsis.sourceforge.net/">NSIS</a> on Linux.</p>

<h3>Windows zipfile</h3>

<p>Download the epspdf zip file, unpack it somewhere and create a
batchfile epspdf.cmd such as</p>

<pre>
texlua "&lt;path_to_epspdf.tlu&gt;" %*
</pre>

<p>for epspdf.tlu, and a batchfile epspdftk.cmd</p>

<pre>
wish "&lt;path_to_epspdftk.tcl&gt;" %1
</pre>

<p>for epspdftk.tcl. The wish executable might also be named
  wish85[.exe] or wish86[.exe], or tclkit[.exe] if it is a
  single-file Tcl/Tk runtime. The first command-line parameter will
  be interpreted as startup directory for the file browser. Make
  sure that wish and these batchfiles are on your searchpath.</p>

<p>The current epspdf[tk] has been tested with Windows 7 and
Windows 10.</p>

<h2><a name="files" />Files</h2>

<ul>

  <li><a href="epspdf.0.6.3.tgz">epspdf.0.6.3.tgz</a> preferred for Unix
and Mac OS X</li>

<li><a href="epspdf.0.6.3.zip">epspdf.0.6.3.zip</a> preferred for
Windows if you don't want to use the installer below</li>

<li><a href="epspdf.0.6.3.exe">epspdf.0.6.3.exe</a> Windows setup
  program which installs epspdf with a built-in Tcl/Tk runtime: no
  dependencies beyond a TeX Live- or MiKTeX installation.</li>

</ul>

<h2><a name="releases" />Releases</h2>

<ul>

<li>0.6.3 Current version. The LuaTeX code which is generated for
  some pdf-to-pdf conversions (page selection and cropping) is now
  compatible with LaTeX versions through 0.95 and should work with
  TeX Live 2016 and earlier.</li>

<li>0.6.2 Small compatibility fix for luatex &ge;
0.81.</li>

<li>0.6.1 Bug fixes, see Changelog; support for later Ghostscript
  versions.</li>

<li>0.6.0 First release of luatex version.</li>

<li><a href="http://tex.aanhet.net/epspdf/legacy.html">Legacy
Ruby-based versions</a></li>

</ul>

<hr />

<p class="fineprint">Last revised: May 2, 2016</p>
</body></html>