Kevin Matthews with Artifice staff.
By using the Radiance Online automated Radiance rendering service provided by Artifice, you can access the power of Radiance without confronting the complexity of Unix. However, there is no question that the ultimate in control and performance can be achieved by running your own Radiance rendering machine, with a Unix operating system.
The instructions below are specific to installing Radiance on an MkLinux system. Artifice also provides instructions for installing Radiance on a Power MachTen system, as well as notes on which Unix for Radiance might best fit your needs.
Here is a functional draft outline of how to get going with Radiance at native speed on Power Macintosh, using available tools exactly as they exist right now. It is aimed primarily at people who want to be able to use Radiance for rendering and lighting simulation with architectural models built using DesignWorkshop.
1) Download MkLinux for Power Macintosh from Apple Computer, Inc. or purchase it on a low-cost CD-ROM, and install it on your Power Macintosh, with 32MB RAM as a preferred minimum. With 300MB of disk space available, you can comfortably install both MachTen and Radiance, and still have file space for a few medium rendering projects.
Note: The specific details of the MkLinux installation and setup process are beyond the scope of these pages. The best information resources are Apple itself, plus the many independent supports of the Linux freeware Unix movement.
Learn a bit about MkLinux from the documentation that comes with it, and get some kind of internet connection established to your MkLinux Power Mac.
2) Create a new user account for yourself, following available instructions, and use it to learn how to perform basic file operations within the MkLinux filesystem, and how to edit MkLinux text files using Pico or vi, or by editing on another Mac in the Mac OS, and then uploading the results by ftp using Fetch.
(BTW, I personally like to use NCSA Telnet to log on to the MkLinux system for general use, treating it as a remote host. )
As long as your MkLinux Unix system configuration remains intact, you don't need to learn a lot of Unix in order to just use Radiance as a power rendering system. But it will still be necessary to get acquainted with some basic Unix commands.
3) Download the Radiance installation archive.
Connect to the Radiance FTP site across the Internet, using UNIX-style ftp, to download the current Radiance installation archive into the root directory ("/") of the Unix file system.
4) Download the Radiance installation archive, and then build Radiance on your MkLinux system. This section is the heart of the installation process.
However you choose to download the current Radiance archive, you should end up with the compressed binary download package in a convenient Unix directory such as /tmp.
Log in to UNIX using the "root" account, go to the directory containing the downloaded archive file "Radiance3R1P4.tar.Z" (or newer), and use the command "uncompress Radiance3R1P4.tar.Z" to decompress the archive file of the main Radiance distribution.
We had to edit two build-related files for the install command to work successfully on our MkLinux test system:
I) First, edit the file /usr/local/bin/rmake so it reads exactly like this:
#!/bin/sh exec make "SPECIAL=" \ "OPT=-O -DSPEED=120" \ "MACH= -Dvoid=char -DDCL_ATOF -DALIGN=double -DBIGMEM -I/usr/X11/include /X11 -L/usr/X11/lib"\ ARCH=PowerPC \ "COMPAT=bmalloc.o erf.o strcmp.o" \ INSTDIR=/usr/local/bin \ LIBDIR=/usr/local/lib/ray \ CC=gcc "$@" -f RmakefileThere may be some modifications to be made to this file for further improvements, but a file like this works (though it gives lots of errors). II) Second, exactly one line of the file ray/src/common/error.c must be edited.
extern char *sys_errlist; /* system error list */Should be:
/*extern char *sys_errlist; --980406.maw*/ /* system error list */
After making those edits, the Radiance build and install process should run and complete properly.
5) Log in to your MkLinux user account (not root), and edit the ".login" file for the account, so Radiance can find all the things it needs from within the account:
You may want to compare your completed edits to a complete example of a good Unix ".login" file (also suitable for use as the user account template file (in MachTen, "/usr/share/skel/dot.login")).
6) Working from your user account, test the system. If you have a proven combination of geometry and .rif file from previous work with Radiance, use that for your first test renderings. Otherwise, create a new scene description for rendering from DesignWorkshop:
Export 3D > Radiance Scenecommand to create the Radiance geometry, material, and command files for rendering.
To begin learning Radiance if you're a new user, follow the more detailed online instructions for running Radiance itself, and for building the "rif" file to go with your exported DW model.
7) Then you're done! and you have one of the world's finest rendering tools, running on your own friendly Macintosh.
When you've got the system working smoothly for rendering basic images of simple models, you may wish to explore the various kinds of Radiance information linked at the UO Architecture Rendering page. . You can also follow the sequence of projects in the Radiance lighting simulation seminar at the University of Oregon to gradually build your knowledge of more advanced Radiance features. These pages at the Uniersity of Oregon also include links to the main Radiance site at LBL, which holds the offical general information on Radiance, technical papers detailing how Radiance works, international discussion archives, links to other Radiance web sites, etc.
- There are probably a number of unknown problems with these procedures.
- Reports of verifiable problems are greatly appreciated.
Feedback by E-mail
Additional Desirable Content for This Page
- Other suggestions?
Feedback by E-mail
Radiance Quick Start Notes , Radiance Materials Overview , Example Simple Image
Posted 98.05.02 KMM, rev. 98.08.20