~ubuntu-branches/ubuntu/karmic/pygame/karmic

« back to all changes in this revision

Viewing changes to install.html

  • Committer: Bazaar Package Importer
  • Author(s): Joe Wreschnig
  • Date: 2005-09-15 15:10:45 UTC
  • mfrom: (1.1.2 upstream)
  • Revision ID: james.westby@ubuntu.com-20050915151045-6j7tiaorbf42xqia
Tags: 1.7.1release-1
* New upstream release.
* Remove 64-bit patch from 1.6-0.2, merged upstream.
* Remove SMPEG detection patch from 1.4-1, no longer needed.

Show diffs side-by-side

added added

removed removed

Lines of Context:
5
5
 
6
6
<p>
7
7
Python can be built from source, but the easiest way is to
8
 
get a binary package for your type of system and version of python.
 
8
get a binary package for your type of system and version of Python.
9
9
This document will give you information on either type of installation.
10
10
</p>
11
11
 
17
17
</p><p>
18
18
The first thing you will need is an installation of Python. Python
19
19
binary installers make it easy to get this done. Pygame binaries
20
 
usually come for the latest 2 releases of python, so you'll want to be fairly
 
20
usually come for the latest 2 releases of Python, so you'll want to be fairly
21
21
up to date.
22
22
<p></p>
23
23
Once that is in place, you want to download the appropriate
24
24
windows binary. From the pygame downloads page you can find the .EXE
25
25
file you need. This will automatically install all of pygame and all the SDL
26
 
dependencies. The windows binaries have filenames like this; "pygame-1.3.win32-py2.1.exe".
27
 
This would be the installer for pygame version 1.3, for python version 2.1. You
 
26
dependencies. The windows binaries have filenames like this; "pygame-1.7.1.win32-py2.4.exe".
 
27
This would be the installer for pygame version 1.7.1, for Python version 2.4. You
28
28
shouldn't have trouble finding the correct binary from the "Windows" section
29
29
of the download page.
30
30
<a href=http://www.pygame.org/download.shtml>http://www.pygame.org/download.shtml</a>.
33
33
installation package. This will add easy links to the different documentation
34
34
and games that come with pygame. The installer for this is found
35
35
next to the other windows binary downloads. The filename looks like this;
36
 
"pygame-docs-1.6.exe". And this would install the documentation and
37
 
examples for pygame-1.6.
 
36
"pygame-docs-1.7.1.exe". And this would install the documentation and
 
37
examples for pygame-1.7.1
38
38
</p><p>
39
39
One other thing the windows binaries are missing is the Numeric Python
40
40
package. You can easily install this separately and it will allow you to use
68
68
<a href=http://www.gentoo.org/dyn/pkgs/dev-python/pygame.xml>http://www.gentoo.org/dyn/pkgs/dev-python/pygame.xml</a>
69
69
</p></blockquote><br>
70
70
 
71
 
<big><b><u>Macintosh Binaries</u></b></big><blockquote><p>
72
 
For OSX 10.2 and aboce, binary packages are availaboe from Bob Ippolito's
73
 
Package Manager repository. This package requires python 2.3, and does
74
 
not work with the 'Fink' version of Python. The package and instructions
75
 
are at <a href="http://undefined.org/python/pimp/">http://undefined.org/python/pimp/</a> and will automatically
76
 
install dependencies.  Instructions for making application bundles
77
 
for OS X that use pygame are forthcoming, but read up on
78
 
bundlebuilder in the meantime.
79
 
</p><p>
80
 
For MacOS 9.x, binaries are available on the pygame downloads page.
81
 
<a href=http://www.pygame.org/download.shtml>http://www.pygame.org/download.shtml</a>.
82
 
Unfortunately the binaries are stuck at pygame version-1.1. This also only works with
83
 
an old copy of <tt>MacPython 2.1</tt>.
 
71
<big><b><u>Mac OS X Binaries</u></b></big><blockquote><p>
 
72
For Mac OS X 10.3 and above, binary packages are available from
 
73
pythonmac.org packages: <a href="http://pythonmac.org/packages/">http://pythonmac.org/packages/</a>
 
74
</p><p>
 
75
This package includes almost of the dependencies required for pygame
 
76
(SDL, SDL_image, etc.), but you need PyObjC 1.2 or later, and may
 
77
also want to get Numeric and PyOpenGL.
 
78
</p><p>
 
79
To build self-contained pygame applications, you should use py2app.
 
80
There is an example in:
 
81
<a href="file:///Developer/Python/pygame/Examples/macosx/aliens_app_example">/Developer/Python/pygame/Examples/macosx/aliens_app_example</a>
84
82
</p></blockquote><br>
85
83
 
86
84
<hr><br>
131
129
to do. If you are using Borland's free compiler or cygwin, you will
132
130
need an extra step. You need to convert the VisualC style .LIB files
133
131
into the format used by your compiler. Both Borland and Cygwin include
134
 
a command to do this. To convert the python library the command looks
 
132
a command to do this. To convert the Python library the command looks
135
133
like this with Borland: <tt>COFF2OMF python22.lib python22_bcpp.lib</tt>.
136
134
For Cygwin, this is the command you need: <tt>DLLTOOL --dllname python15.dll --def python15.def --output-lib
137
135
libpython15.a</tt>. You will also need to do this conversion on all the
139
137
Note that with cygwin you should replace the <tt>--def</tt> flag and argument
140
138
with <tt>--export-all-symbols</tt> since they do not come with .def files.
141
139
</p><p>
142
 
Mingw is well supported by SDL, but a little rougher for python extensions.
 
140
Mingw is well supported by SDL, but a little rougher for Python extensions.
143
141
Here is a link with more information to compiling with non-ms compilers.
144
142
<a
145
143
href=http://www.python.org/doc/current/inst/non-ms-compilers.html>http://www.python.org/doc/current/inst/non-ms-compilers.html</a>
166
164
is "<tt>LOCALBASE=/usr/local python setup.py install</tt>".
167
165
</blockquote><br>
168
166
 
169
 
<big><b><u>OS X Compiling Info</u></b></big><blockquote><p>
170
 
Make sure to have Numeric, PyObjC, PIL, and the SDL development frameworks
171
 
installed.  Compilation should work just same as the unix compiling
172
 
instructions. Python 2.3 and OSX 10.2 are required.
 
167
<big><b><u>Mac OS X Compiling Info</u></b></big><blockquote><p>
 
168
Make sure to have Numeric, PyObjC 1.3 or later, PIL, and the SDL
 
169
frameworks installed. Compilation should work just same as the unix
 
170
compiling instructions. Python 2.3 and Mac OS X 10.2 or later 
 
171
are required.  To build an installer for Mac OS X that includes
 
172
pygame, the examples, and the SDL frameworks use the following
 
173
command:  <tt>python setup.py bdist_mpkg</tt>
173
174
</p></blockquote><br>
174
175