summaryrefslogtreecommitdiff
path: root/support/ps2eps/doc/INSTALL.md
blob: c699dabbda2b008f1f7d6202def5c272168a8cce (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
# INSTALLATION 

## Prerequisites

you need:

* perl (an interpreter for the perl language, see
  http://www.perl.com)

* ghostscript (an interpreter/raster image processor for the
                 PostScript language, see
                 https://www.ghostscript.com/)

* maybe an ANSI-C compiler if the provided binaries for bbox do not
  work for you. Sorry for the inconvenience, but I tried to write a
  bbox equivalent in perl and it was terribly slow. Therefore I stick
  to C, because of much better performance.  *Alternatively* you can
  use ps2eps option -g, then no bbox binary is required.

## How to install

  Please check that you have working
  <kbd>perl</kbd> and <kbd>ghostscript</kbd> packages.

### Linux/UNIX-based platform

1. install bbox

   If a bbox binary is included for your platform you simply move it
   into any directory of the system search path. Otherwise, you have
   to compile bbox.c first by invoking 

   ```
   cc -o bbox bbox.c. 
   ```

   (sometimes "make bbox" also works).
   Please make sure that bbox is executable (chmod a+x bbox).
   If you already have a working perl and a working ghostscript, you're 
   finished here, else you have to install them first.

2. install ps2eps
  
   On Unix platforms you simply move the perl script ps2eps into a
   directory which is included in the system or personal search path
   (e.g., /usr/local/bin, $home/bin). Please make sure that ps2eps is
   executable (chmod a+x ps2eps).

### Windows-based platform

Use the command line interpreter:
Copy bbox.exe into a directory that is 
in your's or the system's search path for executables. Please try 
to invoke bbox -h afterwards.

The best possibility is to use associated file types under 
Windows:
  
1. rename ps2eps to ps2eps.pl and 

2. SET PATHEXT=.pl;%PATHEXT% or use the 
   settings -> control panel -> system -> "advanced" tab -> environment variables
   and edit the PATHEXT entry accordingly.

3. then simply typing ps2eps should invoke ps2eps correctly 

  Another option is to call perl directly:
```
  perl ps2eps ...
```
  
The script assumes that you have "gswin32c" as 
postscript interpreter in your path. Under Windows ps2eps
can perform wildcard expansion on its own.