Obsolete. Radiance is now available as a binary tarball at the official radiance site. Just grab your copy from there.
These notes describe how to compile and install Radiance on MacOS X. This is tested with MacOS X 10.0.1 and 10.0.3, but should also work on 10.0.0 and 10.0.2. For instructions on using Radiance, see the Radiance documentation.
If you have questions or corrections, plase mail me at ray@deleet.de.I can't spare you from fiddling with the shell. I could create a script which does the whole process automagically, but as Radiance itself is a collection of command line tools, you have to face Terminal.app sooner or later.
I compiled three patches:
(Note: You get all of the Radiance tools except trad, a graphical frontend to Radiance. It is based on TCL/TK, so you'd have to install that toolkit, too. I don't cover that here. Therefore, I disabled compilation of trad. You don't miss much, trad is not that earth-shattering.)
June 19, 2001
June 9, 2001
Please pick a local mirror for the XFree distribution. You don't have to download the whole directory, see the file Install.
We assume that the Radiance tarball rad3r1p8.tar.Z and the Radiance patches reside in /Users/gromit and that the XFree files sit in /Users/gromit/XFree86-4.1.0-Darwin-ppc.
Install XFree86. This should be as easy as starting the install script Xinstall.sh and answering 'yes' a few times. Open a terminal window, cd to the XFree distribution and execute the install script:
su [enter root password] cd /Users/gromit/XFree86-4.1.0-Darwin-ppc sh Xinstall.sh
Be sure to answer 'y' when the script prompts for XDarwin (it's the default anyway). XFree is now installed in /usr/X11. Some tools expect it to be in /usr/X11R6, so we just create a link:
ln -s /usr/X11R6 /usr/X11
You can launch XDarwin now, either from the console (startx -- -quartz) or by double-clicking the XDarwin icon in '/Applications'. For further info on XDarwin, look here.
During installation, Radiance uses /usr/tmp as storage for temporary files. I prefer to keep the Radiance binaries separate from the rest of the command line tools, so I create a dedicated radiance directory in /usr/local. Oh, the C compiler from the developer tools is called 'cc'. Radiance looks for 'gcc', so we just create a link.
ln -s /tmp /usr/tmp ln -s /usr/bin/cc /usr/bin/gcc mkdir /usr/local/radiance [optional, see 4.]
Radiance expects the X11 library in /usr/lib/libX11.a, but it's in /usr/X11/lib. Time for another link:
ln -s /usr/X11/lib/libX11.a /usr/lib/libX11.a
We don't want to be root for the following few steps:
exit
Now we expand the radiance sources and apply the patch.
cd /Users/gromit/ tar xvfz rad3r1p8.tar.Z patch -p0 -i radiance3r1p8-darwin.diff
We have to be root again to install radiance:
su [enter root password] cd ray/ ./makeall install
Answer the following questions. I prefer to keep radiance in /usr/local/radiance/, so I tell makeall to install the binaries in /usr/local/radiance/bin and the libs in /usr/local/radiance/lib. When asked about the system type, answer 'PowerPC running Darwin/MacOS X'. The build process may take several minutes. If everything worked out ok, makeall should display 'Done.' in the last line. You can do a makeall clean to save disk space; this removes the object files created during compilation. You're done.
Most radiance tools don't use the X11 server, so you can just start them from Terminal.app. Others, most prominently rview (for scene previews) and ximage (for displaying radiance images) need X11, so you have to start it (see above).