=====================
Installing PyGraphics
=====================

.. topic:: Editors
    
    To edit code and use PyGraphics, you need an editor. The official Python 
    Wiki has a 
    `list of programmer's editors <http://wiki.python.org/moin/PythonEditors>`_
    and a `list of integrated development environments 
    <http://wiki.python.org/moin/IntegratedDevelopmentEnvironments>`_ .

.. toctree::
    :maxdepth: 1

Windows
=======

Download and install the 32bit Python 2.7 installer from `the 2.7 release page <http://www.python.org/download/releases/2.7/>`_ .

Download and install the Python Imaging Library, PyGame, NumPy, Ampy, and PyGraphics:

    * `PIL 1.1.7 <http://effbot.org/downloads/PIL-1.1.7.win32-py2.7.exe>`_
    * `Pygame 1.9.2 <http://pygame.org/ftp/pygame-1.9.2a0.win32-py2.7.msi>`_
    * `Numpy 1.6.1 <http://sourceforge.net/projects/numpy/files/NumPy/1.6.1/numpy-1.6.1-win32-superpack-python2.7.exe/download>`_
    * `Ampy <http://pygraphics.googlecode.com/files/ampy-1.2.3.win32.exe>`_
    * `PyGraphics <http://pypi.python.org/packages/any/P/PyGraphics/PyGraphics-2.1.win32.exe>`_

.. topic:: Nose

    If you wish to use the tests included in the PyGraphics package, you must download and install the Nose package. 
    
    First, `download setuptools <http://pypi.python.org/packages/2.7/s/setuptools/setuptools-0.6c11.win32-py2.7.exe#md5=57e1e64f6b7c7f1d2eddfc9746bbaf20>`_

    Next, open a DOS command prompt, and enter this command::

        C:\Python27\Scripts\easy_install.exe nose
      
    Nose should install automatically. 

Now you should be ready to use the PyGraphics package in your code.

Mac OS X
========

.. todo:: OS X installation guide.

Download and install the 32-bit Mac Installer from `the 2.7 release page <http://www.python.org/download/releases/2.7/>`_ .

Download and install NumPy:

    * `NumPy 1.6.1 <http://sourceforge.net/projects/numpy/files/NumPy/1.6.1/numpy-1.6.1-py2.7-python.org-macosx10.3.dmg/download>`_

Download and install PIL, pygame, ampy, and PyGraphics (all are on a single disk image; make sure to run all four!):

    * `PyGraphics-2.1 <http://pypi.python.org/packages/2.7/P/PyGraphics/PyGraphics-2.1.osx.dmg>`_

.. topic:: Nose

    If you wish to use the tests included in the PyGraphics package, you must download and install the Nose package. 

    First, `download setuptools <http://pypi.python.org/pypi/setuptools>`_

    Next, open /Applications/Utilities/Terminal and enter this command::

        easy_install nose
 
    Nose should install automatically. 

Now you should be ready to use the PyGraphics package in your code.

Linux
=====

.. admonition:: Note

   These instructions are tailored to Ubuntu and Ubuntu derivatives. If you use a different Linux distribution, the commands for installing various dependencies may differ.

Get PyGraphics:

    svn checkout http://pygraphics.googlecode.com/svn/trunk/ pygraphics-read-only

In the main pygraphics folder, run the setup file to install PyGraphics to your local installation directory::

    python setup.py install --user

Download ``ampy-1.2.3.tar.gz`` from the `Downloads page <http://code.google.com/p/pygraphics/downloads/list>`_ , and follow the same procedure to install it as for PyGraphics.

Download and install Python's imaging package, NumPy, and PyGame. They are available via apt-get::

    apt-get install  python-imaging-tk python-numpy python-pygame

If you intend to run PyGraphic's test suite, install Nose::

    apt-get install python-nose

Now you and PyGraphics should be ready to make beautiful music (and pictures!) together.