summaryrefslogtreecommitdiff
path: root/support/purifyeps/README
blob: 7c0893da267af4437ee3947960a45f603a8ad25d (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
           +---------------------------------------------+
           |                  PURIFYEPS                  |
           |                                             |
           | Convert an ordinary Encapsulated PostScript |
           | file (.eps) into one that works with both   |
           | LaTeX+dvips and pdfLaTeX.                   |
           |                                             |
           |     By Scott Pakin, scott+peps@pakin.org    |
           +---------------------------------------------+


Description
-----------

While pdfLaTeX has a number of nice features, its primary shortcoming
relative to standard LaTeX+dvips is that it is unable to read ordinary
Encapsulated PostScript (EPS) files, the most common graphics format
in the LaTeX world.  purifyeps converts EPS files into a "purified"
form that can be read by *both* LaTeX+dvips and pdfLaTeX.  The trick
is that the standard LaTeX2e graphics packages can parse
MetaPost-produced EPS directly.  Hence, purifyeps need only convert an
arbitrary EPS file into the same stylized format that MetaPost
outputs.

Documentation is provided in Unix man-page format and in PDF
(U.S. letter-sized).  In addition, executing "purifyeps --help" gives
basic command-line usage.


Requirements
------------

To run purifyeps, you will need the following:

   * Perl     (http://www.cpan.org)

   * pstoedit (http://www.pstoedit.net/pstoedit)

   * a LaTeX distribution that includes MetaPost (mpost)

purifyeps itself is a Perl script.  On certain operating systems, you
may need to rename purifyeps (e.g., to purifyeps.pl) to notify the
system that purifyeps is, in fact, a Perl script.


Copyright and license
---------------------

Copyright (C) 2010 by Scott Pakin

This file may be distributed and/or modified under the conditions of
the LaTeX Project Public License, either version 1.3c of this license
or (at your option) any later version.  The latest version of this
license is in:

   http://www.latex-project.org/lppl.txt

and version 1.3c or later is part of all distributions of LaTeX
version 2006/05/20 or later.