| /1.0 |
Instructions for old release Vision Egg 1.0
Leopard, OSX 10.5.1 or 10.5.2
VisionEgg installs (without any problems reported) on both desktop and laptop Intel machines as well as a PowerPC tower. First, install all the necessary packages (Numeric, PIL, PyOpenGL, pygame, pyobjc) from here. The preferred version of python currently is 2.4, so ensure that when you type "python" at a Terminal, you get 2.4. If that command starts a different version, install MacPython2.4 and change the "Current" aliases in the Frameworks directories to 2.4. Then make sure you have Xcode so that after downloading visionegg source, you can install it by typing "python setup.py install" from the "visionegg-1.0" directory. ~Alex Holcombe
Instructions for Tiger, 10.4
I (Alex Holcombe) installed VisionEgg using the following procedure. Each of the following packages were downloaded from here . These are Universal versions, and worked on my 2.33 GHz Intel MacBook Pro, as well as a G5 non-Intel PowerPC.
1. I installed Xcode 2.4 (free Apple compiler)
2. "Universal-MacPython-2.4.3-2006-04-07" was installed by double-clicking.
3. I removed all Python 2.3 references that were on my machine (this step should be unnecessary)
4. "Numeric-24.2-py2.4-macosx10.4" installed by double-clicking.
5. "PIL-1.1.5-py2.4-macosx10.4" installed by double-clicking.
6. "PyOpenGL-2.0.2.01-py2.4-macosx10.4" installed by double-clicking.
7. "pygame-1.8.0pre-py2.4-macosx10.4a" installed by double-clicking.
8. "pyobjc-1.4-python2.4-macosx10.4.dmg" installed by double-clicking.
9. The VisionEgg source, visionegg-1.0.tar.gz file was downloaded and unpacked.
10. "python setup.py install" was executed from Terminal.app when in the "visionegg-1.0" directory
COMPLICATION. In my case, for some reason PIL was installed in step 4 with the wrong file permissions. This caused check-config.py to complain that it could not import Image. Once I changed all file permissions so all could read and execute ("chmod +rx") for all the PIL files and directories (at /Library/Frameworks/Python.framework/Versions/2.4/lib/python2.4/site-packages/), then everything worked. Hopefully this was caused by me switching to superuser at some point and forgetting to exit or something, let the mailing list or this wiki know if you run into this problem yourself.
More details about the new Universal Python2.4 packages used above.
See also the Kubovy Lab setup page, who are no longer using VisionEgg per se but are using most of the same libraries.
Abbreviated Instructions for Tiger, Python 2.5
Ensure the XCode development tools are installed. Download and install SDL, SDL_ttf, SDL_mixer, and SDL_image BINARIES from www.libsdl.org (drag them into /Library/Frameworks). Download and install all dependencies from SOURCE: PIL, Numeric (NOT numarray), pygame, PyOpenGL 3, pyobjc. Download VisionEgg source. grep for instances of Colorf in the Python source and change each instance to Color4f Install the source
Old Instructions for Panther, 10.3
(See this message to the mailing list for an approach other than that described below.)
Download and install MacEnthon.
DownloadAndInstall the Vision Egg disk image (.dmg) for Mac OS X. This does not include the demos, so you'll have to get the .zip or .tar.gz file with the demos.
These instructions will not work if your computer accesses the net through a proxy server. Ask the mailing list for help or install from source.
Use the MacEnthon notes above if at all possible! These instructions are left here until I'm convinced that the new way is working.
Happily, Mac OS X 10.3 ships with Python 2.3. You can use the built-in version of Python to run the Vision Egg by installing some additional modules.
Get and install MacPython 2.3 for Panther addons.
From http://www.maths.mq.edu.au/~steffen/tcltk/TclTkAqua/ download TclTkAqua-8.4.7.dmg. Double-click on ''TclTkAqua.mpkg'' to install.
From the command line, run the following commands:
sudo chgrp admin /System/Library/Frameworks/Python.framework/Versions/2.3 sudo chmod g+w /System/Library/Frameworks/Python.framework/Versions/2.3
Open the newly installed /Applications/MacPython-2.3/PackageManager.
If you get an error about the database not being available, go to File->Open URL (cmd-D) and enter http://www.python.org/packman/version-0.3/darwin-7.0.0-Power_Macintosh.plist
Install: _tkinter-2.3-binary
Go to File->Open URL (cmd-D) and enter http://undefined.org/python/pimp/darwin-7.0.0-Power_Macintosh.plist
Install: PyOpenGL-2.0.1.07-binary
Attempt to install pygame-1.6-binary (this should bring up an error about WriteableBin)
Click: Show Hidden
Click: WritableBin and follow the instructions
Click: WritableInclude and follow the instructions
Install: PIL-1.1.4-binary
Install: pygame-1.6-binary (it should work this time)
Install the Vision Egg
This is much the same as installing the other Python packages. Using Package Manager again, go to the Vision Egg package repository:
http://www.visionegg.org/pimp/darwin-7.0.0-Power_Macintosh.plist
Install: visionegg-x.x.x-binary
That's it! The Vision Egg should now be installed. You may now Install and run the demos (instructions below).
Installing Python and modules
Mac OS X 10.2 comes with Python 2.2. Unfortunately, this version of Python unsuitable for many purposes, including running the Vision Egg. The Vision Egg is only supported for MacPython 2.3 on the Mac OS X platform.
It's a good idea to remove any previously installed Python in /Applications.
Download and install Python 2.3: http://ftp.cwi.nl/jack/python/mac/MacPython-OSX-2.3-1.dmg (5.8 MB)
Download and install Tcl and Tk 8.4.2: http://belnet.dl.sourceforge.net/sourceforge/tcl/TclTkAqua-8.4.2.dmg (5.1 MB)
Now you're ready to install the dependencies. Use the ''Package Manager'' application that comes with MacPython to download from Bob Ippolito's unofficial (but top quality) Mac Python package repository.
Open up /Applications/MacPython-2.3/PackageManager
Install: _tkinter-2.3-binary
Now get some packages kindly packaged by Bob Ippolito. Go to File -> Open URL (cmd-D), and enter the URL of Bob's database:
http://undefined.org/python/pimp/darwin-6.6-Power_Macintosh.plist
Install: pygame-x.x.x-binary (this may fetch many MB of dependencies)
Install: PyOpenGL-x.x.x.x-binary
Optional: Pyro-x.x-binary
Install the Vision Egg
This is much the same as installing the other Python packages. Using Package Manager again, go to the Vision Egg package repository:
http://www.visionegg.org/pimp/darwin-6.6-Power_Macintosh.plist
Install: visionegg-x.x.x-binary
That's it! The Vision Egg should now be installed. You may now Install and run the demos (instructions below).
Install and run the demos
Download the Vision Egg demos from the downloads page. Expand the .tar.gz files and double click on the .py python scripts to run. (You may have to change the default application by using ''Get Info'' in the finder and changing the files to open with Python Launcher.)
If you want to run scripts from the command line, use ''open demo/multi_stim.py'' or ''pythonw demo/multi_stim.py''. (The later requires python to be on your path.)
Putting Python on your command line path
Python is already on your path in Mac OS X 10.3. For OS X 10.2 only, use these instructions to add the Python you just installed to the path.
If you're likely to ever use Terminal to access the command-line and run Python, I suggest doing the following:
By default, /usr/local/bin is not on the path. To put /usr/local/bin on your path, your need to create a file called environment.plist in the directory ~/.MacOSX (The ~ character represents your home directory, such as /Users/astraw) You may need to create this directory yourself.
The contents of this environment.plist file should be as below (this is a text file which was created with ''Property List Editor'', a program that comes with the Mac OS X Developer Tools, but you can simply copy and paste this text file)
Logout and login again for this to take effect.
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>path</key>
<string>$path:/usr/local/bin</string>
</dict>
</plist>