This page describes how to install OpenExposition so that you can use the library in your own code and/or develop the library.
If you just want to download the test examples to try them out, download the pre-compiled (bin) packages from Sourceforge.net. To get the test examples to run, you may still need to download and install FLTK (unless you're on OS X where you can use Cocoa instead) and Python. See Step 1: Download below.
If you're having any problems and the instructions below don't help, please contact me (contact info on http://randomaxis.info/).
OpenExposition requires several other open-source libraries.
- Boost is a collection of extremely useful free peer-reviewed portable C++ source libraries.
- FLTK is one of the GUI libraries used.
- Python is used for a programmatic user interface.
Also, please note that you will most likely need to prepare your development environment to compile and use OpenExposition properly. PLEASE read the platform specific instructions below.
Download the OpenExposition library source and the libraries that OpenExposition uses. Please note that on Mac OS X, you can use Cocoa (part of OS X) instead of FLTK, and that Python already comes with OS X (although OpenExposition has been configured to build with a newer version of Python than currently supplied with OS X, so you may need to tweak a few things, or download the new Python anyway).
To build OpenExposition,
Also, as needed,
OpenExposition comes with project files for OS X Xcode and for Visual Studio .NET 2003, as well as CMake configuration files that can be used on Linux (and other) systems. If you use the project files, you WILL MOST LIKELY need to do some changes to compile on your system.
- Make sure that the lib and include directories for all dependencies are accessible to VS. This may involve building the dependency library files from their source distributions.
To add the paths in Xcode, you can use Get Info on the OpenExposition project from Xcode, and under the Build tab you will find the Search paths. To add the paths in VS, you can go to Tools->Options, choose Projects->VC++ Directories, and add the directories to the Include files and Library files as appropriate.
- Download and build the latest version of Apple's branch of GCC from svn://gcc.gnu.org/svn/gcc/branches/apple/trunk/.
To compile and use the Objective-C based parts of OpenExposition (such as Cocoa support and speech recognition), you should download and build the latest version of Apple's build of GCC directly from the subversion repository, and follow the build instructions in Readme.apple (it's painless).
You should do this because GCC versions that come prebuilt with Xcode 2.2 and 2.3 seem to have occasional issues with combinations of C++ templates and Objective C. I built Build 5403 and it works fine (you can type gcc -v in the terminal to see what build you have).
Otherwise, you can focus on using the ExpositionCPP library which doesn't use any Objective C.
Also, please note that all libraries are built as Universal Binaries. The same is true for the TestCocoa app, but not TestFLTK and TestCPP (these two are compiled for i386 until I figure out how to build FLTK fat). Also, the MAX/MSP externals are being built as PPC binaries until the universal binary SDK becomes available.
(you only need to do this for OpenExposition version 0.1.1 and prior)
Make sure you have CMake (
http://www.cmake.org). Then,
- go into OpenExposition/OpenExposition.CMake, and type "cmake .".
- Open the OpenExposition project/solution from either the OpenExposition.xcodeproj file or the OpenExposition.VSNet2003 folder. You should be able to compile the library and the example projects; or
- Go into OpenExposition.CMake, and type make. This will create the .so shared library and the test application (OpenExpositionTest).
If you'd like to create your own project, the simplest thing would be to copy one of the example projects provided with OpenExposition. If you want to modify another project to use OpenExposition, make sure you include all the necessary libraries.
If you'd like to build MAX/MSP objects using OpenExposition, you'll need to download the MAX/MSP SDK (see
http://www.cycling74.com/downloads/maxmsp). Make sure you include the
max-includes directory in your environment include path, and on Windows, the MaxAPI.lib in your library path (on OS X, you add the /Library/Frameworks/MaxAPI.framework to your project, which is already done in the OpenExposition examples).
All test examples were tested with MAX/MSP 4.5 on OS X and Windows.
- See also:
- MAX/MSP Externals Tutorial
The OpenExposition project files are configured to use the FLTK DLL on Windows. I found this to be the easiest way to use FLTK. Note that compiling FLTK using VSNet 2003 places the link libraries for its DLL (ftlkdll.lib and ftlkdlld.lib) in its test directory, and the actual DLLs in the vsnet directory. You may want to move the .lib files to the OpenExposition/lib directory, and the .dll files to something like /Windows/System.
Since OpenExposition uses cross-platform libraries, it should be possible to compile and use it under other environments/platforms. See the
CMake website for more information.
Documentation generated on 14 Jun 2006 for OpenExposition by
1.4.6>
Development hosted by 
