#Copyright (C) 1998 Tuomas J. Lukka, 2001, 2002, 2005 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.8, with updates current to April 8, 2005. The instructions assume that you are starting with a freshly installed Mac OS system, with an installed FreeWRL package, 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 1: You need to do this ONLY if you wish to change the source code. The "dmg" OS X install installs a functioning system.

NOTE 2: This package compiles the FreeWRL library, which contains 99.9% of the FreeWRL code. The Cocoa and Carbon interface files are not here; please ask us for these files if you wish. The Cocoa and Carbon interfaces mimic the commands found in the CFrontEnd source code files, but with windowing commands suitable for OS X, instead of X-11.

NOTE 2: OSX 10.4 (Tiger) builds will be built when the OS is received.

  1. (if required) enable root password - via finder start Applications/NetInfo manager. First authenticate, then enable root, and give root a password.

  2. Install Xcode-1.2 package from Apple disc. This has has cvs, etc.

  3. Install all software updates from Apple via the "software update" function of OS X.

  4. 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.

  5. 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).

  6. Download the FreeWRL source code. You can download via "cvs", or just download the latest source package. If you are installing from cvs, run the "packagemaker" script, and go to the directory that it makes. (eg, cd ../FreeWRL-1.11-pre5)

  7. Download expat-1.95.8.tar.gz from http://sf.net/projects/expat.

  8. Download XML-Parser-2.31.tar.gz from http://www.cpan.org/modules/01modules.index.html.

  9. For the builds following, make the symbolic link: You can remove this link after successful compiling if you want.

  10. Download libjpeg from http://www.ijg.org/files/jpegsrc.v6b.tar.gz

  11. Download zlib There is already a zlib there, but we need some more files. http://www.gzip.org/zlib/zlib-1.2.2.tar.gz;

  12. Download libpng. http://sf.net/projects/libpng.

  13. Download freetype2. http://sf.net/projects/freetype.

  14. In the FreeWRL source directory: perl Makefile.PL - note, the end has "warnings":

    And, the top will have some warnings about not finding some executables; these are for Unix (non apple) machines only, and can be ignored.

  15. edit /System/Library/Perl/5.8.1/darwin-thread-multi-2level/CORE/sv.h. on line 387, comment out the

  16. edit /System/Library/Perl/5.8.1/darwin-thread-multi-2level/CORE/reentr.h

  17. edit /usr/include/dirent.h

  18. edit /System/Library/Perl/5.8.1/darwin-thread-multi-2level/CORE/proto.h line 915

  19. ranlib /usr/lib/libjpeg.a

  20. The Cocoa frontend needs this path update:

  21. In the FreeWRL Source directory, to make the new OSX FreeWRL backend.