####################### Designer's RADIANCE  ##############################

Installation instructions:
	
A small script is provided for installation. To work properly, some steps 
have to be taken in advance:

1) - it is assumed, that a standard RADIANCE installation is already present, 
     including the source files, normally located in ../ray/src.
     Create a new subdirectory within the ../ray/src directory named 
     ../ray/src/desrad and copy in all files of the archive.
     
     (Everything was developed for Radiance Version 3.4. And it is necessary
     that the official 3R4patch release (but no other patches) is already
     applied)  
     
2) - change dir to ../ray/src/desrad and start "drinst". The script 
     patches some source files and backups them in *.c.org.
     After that, the library (librt.a) and the following executives 
     are rebuild:
     
         rpict        genbox      gensurf      oconv
         rview        genprism    genrev       ra_t16
	 rtrace       genworm     xform
     
	 genmaptab (new)
     
     Recompiling oconv and the generators is necessary because of the 
     activation of integer arguments for the handling of exclusions, see the 
     direct cache manual. For this, the corresponding compiler-flag "-DIARGS" 
     has to be set, the script will remind you to edit your 'rmake'-script before 
     the compiling starts. 'genmaptab' is a experimeantal mapping table generator
     needed for hermite mapping, see the section 'texture hints' in the workshop
     contribution. 
     
     The 'rmake' used here is the same which is generated and used during the 
     standard installation procedure, and it normally resides in the same directory 
     where all RADIANCE executives can be found
     Compiling with -DINFO will activate some statistics output at the end of 
     each run informing about used memory for the direct cache. 
     
     You will be asked for a directory to move the new executives to, so it
     is assured that the standard ones are not automatically overwritten.
     
     
Normally, this should work ...  but what is normal nowadays :) Good Luck!

Concerning the use of the new features, consult the HTML documentation
on the workshop CD, which is intended to serve as a manual, too. 


!!!!!  Important notes  !!!!! 


-- 1 --   compiling

- versions -

the "Designers Radiance" changes affect - amongst others - one file which was
recently changed during the 3R4p1 patch release (data.c in ..ray/src/rt), so it 
is important to have the official patches applied to make the new version work.
(Of course, this means no backward compatibility, it is a pity, as the change
in data.c is only a very small one, but, on the other hand, it is generally adviseable
to use the newest version available, so if you didn't update already, here's the
final kick to do so)


- the malloc business -

the versions pre 3R4 used special Radiance-specific malloc modules, these are
still present in the code but (at least for LINUX compilations) are not used
anymore in the 3R4 version. Strangely, side-effects and errors are now occuring
in conjunction with the new add-ons which did not happen before, so I reactivated
the Radiance malloc modules in the Rmakefile. (Maybe, this is Linux-specific, 
I cannot say much more on it, self-evidently I don't have the means to track down 
the real problem lying behind this matter.) 



-- 2 --   running


- instances/frozen octrees -

because of changes in the object definitions (integ. args, secondary ambient 
material) frozen octrees from former versions may not work properly. So reconvert
the corresponding files with the new oconv.

	    	      	       
- the DC preview mode -

somehow this mode does not work well with a background ambient term, I still 
haven't found out why this is so, it seems that a lot of direct cache subcubes 
get assigned only this background term and not the real direct value. Setting 
-av to zero however produces images comparable to those rendered without 
direct cache. All is still a work in progress ...   


- rtrace -

the direct cache originally was developed for rpict and rview only. I ignored rtrace, 
as tracing one ray only does not benefit at all from any value caching. In this 
compilation, I did integrate it into rtrace as well, but this is just formally,
meaning that the compiling works. I had no time to check it, and, moreover, to make 
it exact, some changes are necessary, so keep in mind that direct caching 
together with rtrace is just preliminary   
      
     
    
            