READMES

===================================================== adeline/README: ADELINE 1.0 A MS-DOS version of Radiance is now available as part of the ADELINE 1.0 software package for a site license fee from Lawrence Berkeley National Laboratory. If anyone has any questions about ADELINE 1.0, please contact me: [email protected] and do NOT bother Greg Ward, the Radiance author. Please read this entire message and the contents of this ftp directory before requesting additional information. The minimum hardware configuration is a 386 pc with math coprocessor (486 highly recommended), DOS 5.0 or higher, standard SVGA graphics with 1MB of video memory (not all graphics modes of all cards are supported), and 4MB of sytem RAM (16MB highly recommended), 15MB or free hard disk space plus additional space for projects and swapfile. A WWW site for ADELINE has been established at: http://radsite.lbl.gov/adeline/HOME.html There you will find a detailed description of ADELINE including a slide-show demo "disk" and graphic examples of its capabilities. For the WWW-impaired a ftp site containing this message and the demo slide-show disk is located at: ftp://hobbes.lbl.gov/pub/adeline This directory contains: README This file announce.txt ADELINE description and announcement adeldemo.zip Slide Show demo diskette (712K) configs.txt config.sys and autoexec.bat requirements license.txt ADELINE Site License Agreement orderfrm.txt ADELINE order form in ASCII (4K) orderfrm.ps ADELINE order form in PostScript (30K) orderfrm.gif ADELINE order form in 200 dpi GIF (140K) radiance.txt Radiance pc description superlite.txt Superlite IEA description ADELINE is a lot more than just Radiance for MSDOS, but if that is what you're looking for, it is there and you can ignore the rest. Source code for the PC version is not available. Licensed users of ADELINE will have the option of participating in an e-mail user support list, but this is the only technical support provided. -Chas Ehrlich [email protected] ===================================================== discuss/README: RADIANCE DISCUSSION GROUP This directory contains mail from the Radiance discussion group, for those who are looking at old questions and answers exchanged among users. The files are organized by date, and all mail including subscription requests is included. In this way, users may at least learn when someone new has signed on. The dates are in simple YY_MM_DD format, for cronological listing, and each file contains all mail between the last date and this one. To subscribe to the Radiance discussion group, please send mail to "[email protected]". DO NOT SEND ADMINISTRATIVE REQUESTS TO THE LIST ITSELF. It makes a very poor introduction, since it says to people, "I don't even know how to use a mailing list." Being a novice is fine and good, but a novice who doesn't read directions is rarely appreciated. Also, just in general it is a good idea to subscribe to a list before you send mail to it -- that way, you can see any responses(!). The mailing list address is "[email protected]". ===================================================== doc/README: DOC This directory contains some useful documentation on Radiance and general Global Illumination references provided by others. Most are Microsoft Word files, as noted. Files ending in .doc are Word for Windows 1.0 or 2.0. Files ending in .rtf are Rich Text Format. brep96.Z - Bibliography on boundary representation cquant96.Z - Bibliography on color quantization algorithms erw91.tar.Z - Adaptive Shadow Testing paper erw92.tar.Z - Irradiance Gradients paper mapping.hqx - Matiu Carr's image mapping guide (binhex'ed MS Word) parallel.txt - Formatted article (text) on parallel rendering RadBib96.Z - Compressed radiosity bibliography report1.doc.Z - Simon Crone's Thesis (MS Word for Windows 2.0) usman1.rtf.Z - Cindy Larson's draft Radiance User's Manual usman1.doc.Z - Cindy Larson's draft Radiance User's Manual usman2.doc.Z - Simon Crone's supplementary Radiance user's guide If you have a submission to make, you can deposit them in the xfer diretory and then please [email protected] to let him know what to look for. ===================================================== generators/README: GENERATOR PROGRAMS A generator program creates a Radiance description of some special shape or object type. Such a program should always write a legal Radiance scene description to the standard output. Usually, the description will be geometry only, and will assume the object generated to be of a single material type given on the command line. This makes it easy to use the generator program as an escape command within a Radiance scene description file. Because an octree created by oconv (without the -f option) relies on the same geometry being there later, a generator must always produce the same exact output from the same input. Thus, using the clock to seed a random number generator (for example) is forbidden. It is OK to have pseudorandom behavior, as long as it is repeatable. (Note that even pseudorandom implementations vary from one machine to another, so using them may render the resulting octree unportable.) A typical example of a generator program is genbox. Genbox takes as arguments the name of the material, the name of the object, and the width, depth and height of the box. The box is always created in the positive octant and must be moved to the desired location with xform. This is preferable to adding complexity to the genbox program itself. As an example, genbox can be used to create a 4x3x5 house out of the material "straw" at (-1,15,3) by including the following line in the scene description file: !genbox straw house 4 3 5 | xform -t -1 15 3 All contributions should be stored as compressed tar files that when unpacked will create a directory with the program's name containing a Makefile, the necessary source modules, and a manual page. Please use the file genbox.tar.Z as a model. ===================================================== iesdata/README: IESDATA This directory contains luminaire output data in standard IES format. These files can be converted to Radiance scene files using ies2rad. Since ies2rad provides a number of options for the translation, it is a good idea to keep the original IES files around. Also, we welcome any IES files you might want to add to our collection. As you can see, our selection could use some fresh blood. emco.tar.Z - EMCO street lights gardco.tar.Z - GARDCO street lights headlight.tar.Z - A few headlights with wide distributions ies.tar.Z - The standard IES luminaire set Bega-ies.tar.gz - GNU-zipped Bega fixtures LiteControl-ies.tar.gz - GNU-zipped LiteControl fixtures ===================================================== libraries/README: LIBRARIES This directory contains favorite library files (a.k.a. auxiliary files) used by Radiance, including procedural patterns and textures, scanned patterns, fonts, compiled objects and so on. Each file in this directory is a compressed tar file with the name of the person or entity who made the contribution. These files should unpack to create a directory by the same name containing the various submission that person or entity has to offer. There should also be included a README file saying what each file is. When naming auxiliary files, the following conventions should be followed as closely as possible. Files with the ".cal" suffix specify procedural patterns, textures and coordinate mappings. Files with the ".fnt" suffix are font descriptions. Files with the ".oct" suffix are compiled scene descriptions for use in instances. Files with the ".pic" suffix are images for patterns. Pictures for use as patterns are normalized to a value of 1 rather than the more usual .5, and must be displayed with the -e -1 option. This is so the material reflectance given in the scene description holds true. The exception to this is pictures that are not meant to be used as repeated patterns, but instead as paintings or pictures to hang on the wall. If you wish to make a contribution to this directory, please look at the tar file gward.tar.Z as a model. ===================================================== models/README: MODELS This directory contains complete Radiance scene descriptions with the necessary makefiles for rebuilding the octrees and rendering the scene with rview from a good viewpoint. These models are stored as compressed tar files that unpack to a directory with all the required input and auxiliary files. Here is a list of models currently offered: bath.tar.Z - Modest bathroom model by Greg Ward conf.tar.Z - LBL conference room by Anat Grynberg and Greg Ward cruiser.tar.Z - Lower deck of US Navy cruiser by Saba Rofchaei & Greg Ward cubspace.tar.Z - Cubicle office space by Anat Grynberg and Greg Ward invplace.tar.Z - Inventure Place model by Charles Ehrlich podlife.tar.Z - Whale sculpture by Cindy Larson and Greg Ward soda.tar.Z - Ice cream store by Greg Ward townhouse.tar.Z - Model of a townhouse by Paul Bourke virtual.tar.Z - Virtual light source example by Greg Ward If you are making a submission, please do what is necessary to make the first paragraph true. Please do not include any octrees or large images of your model, since they require too much storage space. You may follow the example in podlife.tar.Z. ===================================================== objects/README: OBJECTS I have the following suggestions for object coordinates, which should be made more specific with overall dimensions in a comment at the top of each file: Furniture: Units = meters [The following is described looking from "back"] (0,0,0) located at bottom back left corner X-axis directed towards "right" Y-axis directed towards "front" Z-axis directed up Knick-knacks: Units = meters or centimeters Orient the same as furniture except (0,0,0) can be at center of rest point (ie. bottom) if object has high degree of radial symmetry (eg. a vase or cup). Fixtures: Units = meters [Present right-handed version only, ie. hinge on right means pull fixture towards you on left] (0,0,0) at lowest hinge or mount point if there is one, highest mount point if it is a ceiling fixture X-axis in plane of fixture, towards handle side if one Y-axis out of plane Z-axis up Buildings: Units = meters (0,0,0) located at the ground level of SW corner X-axis directed towards "East" Y-axis directed towards "North" Z-axis directed up Plants: Units = meters (0,0,0) located where ground meets plant (ie. the root) Y-axis directed "North" for phototropic plants Z-axis directed up People (standing): Units = meters (0,0,0) located at ground under center of gravity X-axis points to person's right Y-axis points in person's forward direction Z-axis directed up People (sitting): Units = meters (0,0,0) located at rump under center of gravity X-axis points to person's right Y-axis points in person's forward direction Z-axis directed up People (laying): Units = meters (0,0,0) located at back of the head X-axis points to person's right (left if prone) Y-axis points towards feet Z-axis directed up Animals (excl. people) Units = meters (0,0,0) located at rear (ground level if land animal) X-axis pointing to animal's right Y-axis to animals front Z-axis directed up Objects should be collected in compressed tar files, one such file per contributor. It would be too messy to have one tar file for each object, since each person might contribute several objects, and everyone has an object called "chair". ===================================================== patch/README: Radiance 2.5 Patch Directory Install the following files as directed to correct problems with the official 2.5 release. makeall - put in ray/ directory -- minor fixes for Tcl/Tk util.Rmakefile - Replaces src/util/Rmakefile for systems w/o Tcl/Tk tiffio.h - declaration fix, install in src/px/libtiff source.h - put in src/rt, bug fix for large numbers of sources ===================================================== ports/README: PORTS This directory is for ports of Radiance to non-standard or non-UNIX systems that require significant modifications. It is also a good place to put additional graphics drivers and other hardware-specific code supplements. If you have ported Radiance to a specific architecture that is not listed here, please make a new directory for your machine and place your patches and comments in it. Please do not deposit large collections of uncompressed executables, since hobbes does not have a real wealth of disk space. After leaving your files, please make an announcement to the [email protected] mailing list to let folks know about it. Currently in this directory: amiga - Commodore AmigaOS patches and utilities mac - Macintosh (PowerMac running MachTen) executables ===================================================== programs/README: PROGRAMS This directory contains contributed Radiance programs that don't really fit into the generator or input/output translator categories. So far, we have the following contributions: preview.tar.Z - An X11 previewer for Radiance models by Sumanta Pattanaik wireframe.tar.Z - A converter to help create hidden-line Radiance renderings rshow.tar.4.1.2.Z - A GL previewer for Radiance scenes (see rshow.README) These are all compressed tar files that unpack to a directory with the necessary Makefile included. Please do not redistribute any of these programs without getting prior permission from the author(s). ===================================================== translators/README: TRANSLATORS This directory contains contributed CAD translators and image file converters for going to and from Radiance. Most of the programs should be here as compressed tar files that unpack to create a directory with the appropriate Makefile and manual page(s). By convention, CAD format translators are named something like *2rad, and usually do not perform the reverse conversion from Radiance models to the CAD system. Image file converters, on the other hand, should provide a '-r' option to go from the foreign image format to a Radiance floating point pictures. The convention for image converter names is ra_*. The following translators have been contributed so far: archicad.sea.hqx - A converter from ArchiCAD for the Mac archicad2rad.c - C program extracted from above on March 4, 1994 arris2rad.tar.gz - A converter from ARRIS to Radiance by Jean Brange stratastudio.sea.hqx - A converter from StrataStudio for the Mac dem2rad.tar.Z - A translator from Digital Elevation Maps to gensurf input dxf2rad.lisp - An AutoLISP DXF translator [uncompressed] ra2pict.tar.Z - A translator from Radiance to Macintosh PICT (forward only) ra_xim.tar.Z - A translator between Radiance pictures and Ximage format ra_rle.c - A translator from Radiance pictures to Utah RLE format sgirgb.tar.Z - Translators to and from SGI RGB image format torad.tar.Z - An improved AutoLISP translator for Radiance If you are planning to write a CAD format translator for Radiance, please consult the translators file in the ray/doc/notes directory of the standard Radiance distribution. If you wish to write an image converter, please avail yourself of the Radiance scanline color manipulation routines in ray/src/px and ray/src/common: color.h, resolu.h, color.c, colrops.c, header.c and resolu.c. You may use start from the ra_skel.c example converter. If you are converting to 8-bit color, you may also want to use the routines in clrtab.c. You can follow ra_t8.c as an example of 8-bit color conversion. If you are converting to some raw image format, you should check that pvalue doesn't do the conversion already.