#Copyright (C) 1998 Tuomas J. Lukka, 2001, 2002 John Stewart, CRC Canada.
#DISTRIBUTED WITH NO WARRANTY, EXPRESS OR IMPLIED.
#See the GNU Library General Public License (file COPYING in the distribution)
#for conditions of use and redistribution, EXCEPT on the files
#which belong under the mozilla public license.
Macintosh Aqua Installation Instructions
The following instructions are for compiling the FreeWRL rendering engine for use with the FreeWRL Aqua GUI for Mac OSX. The release of Mac OS X used was Mac OS X v 10.3.2. The instructions assume that you are starting with a freshly installed Mac OS system, and all supporting packages required are listed and referenced. You may already have some of these packages installed on your system. If so, you may be able to skip some steps.
NOTE: If you have already installed the FreeWRL for Aqua package and wish to recompile freewrl these instructions are for you. Follow the steps below to make sure that you have the requisite files. Step 6 can be skipped, as you already have the FreeWRL for Aqua package installed on your system.
Step 1. Download and install the developer tools for Mac OS X
from connect.apple.com. This pacakge is self installing. Step 2. Download and install the ImageMagick package from www.entropy.ch/software/macosx/. The package available
from this location is self-installing and requires no tweaking to install on Darwin. Step 3. Download and install the libjpeg package from www.freshmeat.net. This package looks for a man directory as
specified in the Makefile. Edit the makefile to point to a valid directory on your system before running make. Change
into the directory and ./configure make make install Step 4. Download and install the zlib and libpng packages from www.sourceforge.org. Rename the source directories to
simply "zlib" and "libpng" and make sure that they are in the same subdirectory. Install the zlib package first, then the
libpng package. Change into the zlib directory and ./configure make make install Then change into the libpng directory and cp scripts/makefile.macosx makefile make make install Step 5. Download and install Freetype2 version 2.0.9 from freetype.sourceforge.org. You will need to move
/usr/local/include/freetype2/freetype to /usr/local/include/freetype after installation. Change into the freetype directory
and ./configure make make install cp -r /usr/local/include/freetype2/freetype /usr/local/include/freetype rm -r /usr/local/include/freetype2/freetype Step 6. Download and install the FreeWRL for Aqua package from Sourceforge. This package will install the latest functional version of FreeWRL for Aqua on your system. It will also install all needed perl modules and OSX frameworks. This package is self-installing. Double-click to begin the install process and indicate that FreeWRL should be installed on your primary hard drive. (If you have a partitioned drive, or multiple drives, you must install FreeWRL on the same partition as that which contains the /Library/Frameworks directory).
Step 7. Download the FreeWRL source code. This source code is available from sourceforge in the aptly named FreeWRLSource package. This package contains two directories: freewrl, which contains the files needed to recompile the FreeWRL program itself, and freewrlFrontEnd which contains the Project Builder files needed to recompile the GUI. You do not need to recompile the GUI in order to update the FreeWRL program. In most cases, the files in the FreeWRLFrontEnd can be left alone. Should you wish to change the GUI (add controls etc.) you may do so by opening the files in the FreeWRLFrontEnd directory in ProjectBuilder. The following instructions are for recompiling the code in the freewrl directory. Move into the freewrl directory and continue with Step 8. Step 8. Copy the aqua makefiles and configuration files over their linux equivalents . This can be accomplished by issuing the following commands from the freewrl directory: mv vrml.conf.aqua vrml.conf mv Makefile.aqua.PL Makefile.PL mv JS/Makefile.aqua.PL JS/Makefile.PL mv CFrontEnd/Makefile.aqua CFrontEnd/Makefile
Check that the directories for the libaries in the file vrml.conf are
correct. These are dependant on where you installed the libjpeg/libpng/zlib/Freetype packages above. Make any required changes.
Step 9. Make the Makefile perl Makefile.PL Step 10. run ranlib on /usr/local/lib/libpng.a ranlib /usr/local/lib/libpng.a Step 11. Build and install FreeWRL make make install Start the FreeWRL for Aqua GUI interface by double-clicking on the FreeWRL icon (this can be found in the /FreeWRL directory if you chose to install the FreeWRL package into the default directory). The FreeWRL GUI will automatically use the newly compiled version of FreeWRL.