-
Notifications
You must be signed in to change notification settings - Fork 0
/
INSTALL
207 lines (122 loc) · 5.65 KB
/
INSTALL
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
SUMMON - visualization protyping python module
Copyright 2005-2011 Matt Rasmussen
To install SUMMON, do the following:
1. install third-party libraries
2. install SUMMON by one of these strategies
1. distutils (ex: python setup.py install)
2. binary install (rpm, *.exe)
3. Makefile
For more documentation see doc/summon_manual.pdf
=============================================================================
1. THIRD-PARTY SOFTWARE
The following third party packages are needed for SUMMON:
- SDL
- GLUT
This software is available for all major platforms. See below for platform
specific instructions:
=== 1.1 LINUX (Debian)
On Debian Linux the following apt-get command should install the third-party
packages:
apt-get install libsdl-dev freeglut-dev
Other Linux distributions should have the same packages under similar names
=== 1.2 MAC OS X
On Mac OS X, you can use fink to install third party packages:
/sw/bin/fink install sdl glut
Or if you MacPorts, you can use this command
port install glut libsdl-devel
=== 1.3 WINDOWS (XP, Vista) NATIVE
For your convenience, the ZIP archive of SUMMON includes compiled third-party
libraries. To install them, copy summon/windows/lib/OpenGLUT.DLL and
summon/windows/lib/SDL.DLL to your C:\windows\system32 directory (or wherever
your DLLs are located).
Installation directly from third-party:
If the above instructions do not work for you, you can also install
third-party libraries downloaded directly from third-parties:
1. Download the windows version of GLUT from
http://openglut.sourceforge.net/ Make sure to copy OpenGLUT.dll to your
C:\windows\system32 directory (or wherever your DLLs are located)
2. Download the windows version of SDL from http://www.libsdl.org/ Make sure
to copy SDL.dll to your C:\windows\system32 directory (or wherever your DLLs
are located)
=== 1.4 WINDOWS (XP, Vista) CYGWIN
SUMMON can also be installed in a Cygwin environment. The following packages
can be installed through Cygwin's setup.exe
Python/python
Libs/freeglut
Devel/gcc-g++
Devel/automake
Devel/make
SDL must be compiled and installed manually from http://www.libsdl.org/
=============================================================================
2. CROSSPLATFORM INSTALLATION OF SUMMON WITH DISTUTILS (Ideally)
Download and unzip the archive summon-XXX.tar.gz from
http://people.csail.mit.edu/rasmus/summon
Within the uncompressed directory do one of the following:
=== 2.1 UNIX (ex: Linux)
To install summon with python distutils use the following command:
python setup.py install
NOTE: you may need root permissions for system-wide installation. To install
in your home directory use:
python setup.py install --prefix=$HOME
=== 2.2 MAC OS X
For installing on Mac OS X use the following command:
python setup-macosx.py install
=== 2.3 WINDOWS
It is recommended to use the Windows Install available from the SUMMON website
(see below for more).
However, if you are _really_ interested in using distutils, a windows specific
version of the distutils file (setup-windows.py) is available. It is configured
by default to compile SUMMON with third-party software pre-installed in
summon/windows.
If you have Visual Studio 7.1 (the default windows compiler) the following
command should build and install SUMMON:
python setup-windows.py install
The mingw32 compiler also works very well (and is easier to get). You the
following commands to compile and install:
python setup-windows.py build --compiler=mingw32
python setup-windows.py install
=============================================================================
3. SUMMON BINARY INSTALL
=== 3.1 LINUX RPM
Download the rpm package from the SUMMON website
rpm -i summon-XXX-1.i386.rpm
=== 3.2 WINDOWS
Download from the SUMMON website and run the Installer
summon-XXX.win32-py2.4.exe
For source code examples, you still need to download and unzip the ZIP file,
summon-XXX.zip
=============================================================================
4. SUMMON INSTALL WITH MAKE
=== 4.1 LINUX MAKE
You can also use the Makefiles to install summon in the source directory.
On Linux, you may run:
make
Next, you must add the summon source directory to your python path using:
export PYTHONPATH=$PYTHONPATH:path/to/summon-XXX/lib
export PATH=$PATH:path/to/summon-XXX/bin
NOTE: this assumes you use the bash shell. Add these lines to your ~/.bashrc
startup file
=== 4.2 WINDOWS MAKE
A makefile for compiling SUMMON with mingw for windows is included. The
following command will compile SUMMON:
make -f Makefile.mingw
Be sure to add the following paths to your environment variables.
append to PYTHONPATH path/to/summon-XXX/lib
append to PATH path/to/summon-XXX/bin
=== 4.3 WINDOWS CYGWIN MAKE
I have had trouble using setup.py for installing on CYGWIN, so I made a Makefile
specifically for installing on CYGWIN.
Note: make sure that the *development* packages of freeglut and SDL are
installed first.
Execute make with the following command:
make -f Makefile.cygwin
Next, you must add the summon source directory to your python path using
export PYTHONPATH=$PYTHONPATH:path/to/summon-XXX/lib
export PATH=$PATH:path/to/summon-XXX/bin
NOTE: this assumes you use the bash shell. Add these lines to your ~/.bashrc
startup file
=== 4.3 MAC OS X MAKE
To compile SUMMON for Mac OS X using Make do the following:
make -f Makefile.macosx
You will need freeglut (native Mac OS X GLUT will not work with SUMMON) and
SDL already installed. SUMMON assumes they are installed in /usr/local/.