summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/support/epspdf/index.html
blob: 4208e73b328ad8b8536dab35f38b1ae393666b57 (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
<!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
 of preserving scalable fonts when converting from pdf to
 ps. Included in TeX Live for Windows.</li>

<li><a href="http://www.tcl.tk/">Tcl/Tk</a> for the GUI
  interface. Versions 8.4 through 8.6 have 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 for precompiled binaries.</li>

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

</ul>

<p>If you have 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.</p>

<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. 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. For version 0.6.1,
the Tcl/Tk 8.5 runtime is from the <a
href="http://tclkits.rkeene.org/fossil/wiki/Downloads"> KitCreator
project</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>.</p>

<h3>Windows zipfile</h3>

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

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

<p>for epspdf.tlu, and a batchfile epspdftk.bat</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>Epspdf[tk] has been tested with Windows XP, Windows 7 and
Windows 8.</p>

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

<ul>

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

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

<li><a href="epspdf.0.6.1.exe">epspdf.0.6.1.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.1 Current version. 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: December 5, 2014</p>
</body></html>