h1 Installing VRUI On Mac OS X To install VRUI on Mac OS X is fairly straightforward.
h2 Requirements Mac OS X 10.4 (Tiger) is required for VRUI to run.
h2 Overview # [Install X11|#x11] # [Install XCode and X11 SDK|#xcode] # [Install libpng (optional)|#libpng] # [Install libjpeg (optional)|#libjpeg] # [Install VRUI|#vrui]
h2 {anchor:x11}{anchor}Install X11 X11 can be installed from your Mac OS X install disk by using the “Optional Installs” installer.
h2 {anchor:xcode}{anchor} Install XCode XCode can be downloaded from {link:text=Apple's developer site|url=http://developer.apple.com/tools/download/}. When you install XCode, be sure that the X11 SDK is also selected to be installed (if X11 is installed already, this should be the default).
If you installed XCode previously without having X11, then you will need to run the installer again after having installed X11 so that the X11 SDK can be installed.
h2 {anchor:libpng}{anchor} Install libpng (optional) Install libpng if you'd like VRUI's builtin image handling to be able to read PNGs.
There are various ways you could install libpng, but these instructions are only for compiling and installing from the source. # Download the libpng source code from the {link:text=libpng home page|url=http://www.libpng.org/pub/png/libpng.html}. Be sure to get the version with the config script. # Unpack the source code somewhere, and go into the unpacked directory using a terminal program. # Execute the following command to compile and install: {code:none}./configure && make && sudo make install{code}
libpng is now installed under /usr/local/
h2 {anchor:libjpeg}{anchor} Install libjpeg (optional) Install libjpeg if you'd like VRUI's builtin image handling to be able to read JPEGs.
There are various ways you could install libjpeg, but these instructions are only for compiling and installing from the source. It is slightly more involved than installed libpng. # Download the libjpeg source from {link:text=Independent JPEG Group site|url=http://www.ijg.org/}. # Unpack the source code somewhere, and go into the unpacked directory using a terminal program. # Execute the following commands to compile and install: {code:none} % ln -s /usr/bin/glibtool libtool % ./configure –enable-shared –enable-static % MACOSX_DEPLOYMENT_TARGET=10.4 make % sudo make install {code} # Edit /usr/local/include/jpeglib.h with your favorite plain text editor (TextEdit is fine) to encapsulate the file's contents with the following:{code:none} #ifdef \cplusplus extern “C” { #endif […interior of header file…] #ifdef \cplusplus } #endif{code}
libjpeg is now installed under /usr/local/
h2 {anchor:vrui}{anchor} Install VRUI You are now finally ready to compile and install VRUI itself.
# Download the {link:text=VRUI source code|url=http://stout.idav.ucdavis.edu/Vrui-1.0-045.tar.gz}, and unpack it somewhere. # In the unpacked directory, open the makefile in a plain text editor (TextEdit is fine). # In the makefile, change INSTALLDIR to where you'd like to keep the VRUI installation. For Mac OS X, it is suggested this be in $(HOME)/Library/Vrui-1.0 for a personal install, or /usr/local/Vrui-1.0 for a system-wide install. # In the makefile, you must set VRDEVICES_USE_INPUT_ABSTRACTION to 0. # In the makefile, if you did not install libpng, set IMAGES_USE_PNG and VRUI_USE_PNG to 0. # in the makefile, if you did not install libjpeg, set IMAGES_USE_JPEG to 0. # Save the makefile and exit. # Using a terminal program, go to the VRUI source directory. # For a personal install, execute: {code:none}make && make install{code} or for a system-wide install, execute: {code:none}make && sudo make install{code}
Congratulations, you have now installed VRUI. Remember where you installed it, as typically VRUI applications will need to be told where VRUI is before they can compile.
