INSTALL.txt

HOW TO RUN/BUILD LFDISPLAY FROM SOURCE

Dependences: 
 * Python 
 * QCam for Python (included)
 * FreeImage 
 * PyQt 
 * setuptools 
 * numpy 
 * PyOpenGL3

Optional: 
 * drivers for QImaging cameras (not needed for build, just at runtime) 
 * py2app (for packaging into standalone)
 * py2exe (for packaging into standalone)

Building on Mac
 * Install QCam for Python 
 * Install FreeImage (into /usr/local/lib, etc. as a shared library) 
 * Install PyQt 
 * Install setuptools (using ez_setup.py to bootstrap initially) 
   (http://peak.telecommunity.com/dist/ez_setup.py)
 * Install numpy using setuptools 
 * Install PyOpenGL using setuptools 
 * Install py2app using setuptools 
 * Delete the contents of the dist directory if necessary 
   (script will fail to overwrite some files) 
 * Run the package.py script 

Building on Windows

 * If you are using Python 2.6 or later, MSVC2008 redistrib libraries are needed for PyQt4, so install those 
    * Python 2.6 comes with MSVCR90.DLL, but PyQt4 needs the MSVCP90.DLL
     for the C++ stuff 
    * Copy MSVCP90.DLL from 
      C:\Windows\WinSxS\x86_Microsoft.VC90.CRT_1fc8b3b9a1e18e3b_9.0.21022.8_x-ww_d08d0375 
      (or wherever the redist package installed the DLLs) 
      into the directory where package.py is 
 * If Python 2.6+ is to be installed, make sure to install "for
   yourself" so that it leaves the SxS libraries in the Python base 
   directory (not available for Vista, so recommend Python 2.5 for Vista) 
 * Install QCam for Python 
 * Install FreeImage (stick .dll somewhere in your path) 
 * Install PyQt 
 * Install setuptools (using ez_setup.py to bootstrap initially) 
   (http://peak.telecommunity.com/dist/ez_setup.py)
 * Install PyOpenGL using setuptools 
 * Install numpy 
 * Install py2exe 
 * Delete the contents of the dist directory if necessary 
   (script will fail to overwrite files) 
 * Run the package.py script 

Tested Mac Configurations
 * Mac OSX 10.5.8 
 * Python 2.6.2 (official distribution from python.org, r262:71600, April 16, 2009) 
 * FreeImage 3.12.0 (build as fat (universal) binary) 
 * PyQt4 mac-gpl-4.5.2-snapshot-20090627 
 * setuptools 0.6c11 
 * numpy 1.3.0 
 * PyOpenGL 3.0.1b1 
 * py2app 0.4.3 

Tested Windows Configurations
 * Windows XP Professional Version 2002 Service Pack 3 
 * Python 2.6.2 (official Windows .msi from python.org) 
 * FreeImage 3.1.20 (from FreeImage3120Win32.zip) 
 * PyQt GPL 4.6.2-2 (PyQt-Py2.6-gpl-4.6.2-2.exe) 
 * setuptools 0.6c11 
 * PyOpenGL 3.0.1b1 
 * numpy 1.3.0 (numpy-1.3.0-win32-superpack-python2.6.exe) 
 * py2exe 0.6.9 (py2exe-0.6.9.win32-py2.6.exe)