| 1 |
< |
RCSid "$Id" |
| 1 |
> |
RCSid "$Id$" |
| 2 |
|
|
| 3 |
|
Hello and welcome to the Radiance synthetic imaging system. This is |
| 4 |
< |
the thirteenth release, Version 3.5, and it includes all source files |
| 4 |
> |
the eighteenth release, Version 4.1, and it includes all source files |
| 5 |
|
for local compilation with a standard C compiler. To find out what's |
| 6 |
|
new in this release, check the text file "doc/notes/ReleaseNotes". |
| 7 |
|
|
| 15 |
|
Please read this entire file before sending e-mail asking |
| 16 |
|
how to install this software or what to do with it. Some |
| 17 |
|
frequently asked questions are answered here and also on our |
| 18 |
< |
web site at: |
| 18 |
> |
website at: |
| 19 |
|
|
| 20 |
|
http://radsite.lbl.gov/radiance/ |
| 21 |
|
|
| 22 |
< |
The website above should also have some precompiled Radiance binaries |
| 22 |
> |
The CVS source tree is available, including post-release bug-fixes and |
| 23 |
> |
mailing lists access at: |
| 24 |
> |
|
| 25 |
> |
http://www.radiance-online.org/ |
| 26 |
> |
|
| 27 |
> |
The websites above should also have some precompiled Radiance binaries |
| 28 |
|
and add-ons for common Unix platforms. |
| 29 |
|
|
| 30 |
|
We have attempted to make it easy for you (and for us) to install |
| 31 |
|
the software on differently configured systems using a global make |
| 32 |
|
script. To install the software, just type: |
| 33 |
|
|
| 34 |
< |
makeall install |
| 34 |
> |
./makeall install |
| 35 |
|
|
| 36 |
|
You can clean up the .o files and so forth with: |
| 37 |
|
|
| 38 |
< |
makeall clean |
| 38 |
> |
./makeall clean |
| 39 |
|
|
| 40 |
|
Or, if you are confident you can do both at the same time with: |
| 41 |
|
|
| 42 |
< |
makeall install clean |
| 42 |
> |
./makeall install clean |
| 43 |
|
|
| 44 |
|
You can give other make options at the end of the command as well. For |
| 45 |
|
example, the -n option will tell you what makeall is going to do without |
| 48 |
|
If you downloaded the binaries, so compilation is not necessary, |
| 49 |
|
run the following command to install the library files only: |
| 50 |
|
|
| 51 |
< |
makeall library |
| 51 |
> |
./makeall library |
| 52 |
|
|
| 53 |
|
The makeall may script ask you questions about your system and where you |
| 54 |
|
want to install the executables and library files. The pathnames you |
| 78 |
|
|
| 79 |
|
For complete documentation on the system as of release 3.1, refer to |
| 80 |
|
"Rendering with Radiance" by Larson and Shakespeare, which used to be |
| 81 |
< |
available from Morgan Kauffman Publishing. Unfortunately, the book has |
| 82 |
< |
gone out of print, and the authors are currently looking at alternative |
| 83 |
< |
means of distribution. The first chapter of this book, which includes |
| 79 |
< |
a basic tutorial and serves as a good introduction for new users, may be |
| 80 |
< |
found in "doc/pdf/RwR01.pdf". Keep tuned to the radiance website |
| 81 |
< |
for updates on the full book's availability. |
| 81 |
> |
available from Morgan Kauffman Publishing. Recently, the authors have |
| 82 |
> |
taken over printing of the book, which is now available from booksurge.com. |
| 83 |
> |
You may find it linked to the Radiance website page: |
| 84 |
|
|
| 85 |
+ |
http://radsite.lbl.gov/radiance/book/ |
| 86 |
+ |
|
| 87 |
+ |
The first chapter of this book, which includes a basic tutorial and |
| 88 |
+ |
serves as a good introduction for new users, may be found in |
| 89 |
+ |
"doc/pdf/RwR01.pdf". |
| 90 |
+ |
|
| 91 |
|
Important additions since version 3.1 include the holodeck programs (rholo, |
| 92 |
< |
etc., built in src/hd), glrad, ranimove, and the new "mesh" primitive, |
| 93 |
< |
suported by obj2mesh. |
| 92 |
> |
etc., built in src/hd), glrad, ranimove, the new "mesh" primitive, |
| 93 |
> |
and rtcontrib. Again, check doc/notes/ReleaseNotes for details. |
| 94 |
|
|
| 95 |
|
Individual manual pages may be found in the subdirectory "doc/man". |
| 96 |
|
You may want to copy these to the system manual directory, or add this |
| 117 |
|
|
| 118 |
|
There is a user interface built on top of this using Tcl/Tk, called trad. |
| 119 |
|
If you do not have Tcl/Tk installed on your system, you must do so prior |
| 120 |
< |
to building this distribution if you ant trad to install. (Try a google |
| 120 |
> |
to building this distribution if you want trad to install. (Try a google |
| 121 |
|
search on "Tcl/Tk" or go to "http://www.scriptics.com/software/tcltk/".) |
| 114 |
– |
|
| 115 |
– |
If you have a question, you might start by looking in the Radiance Digest |
| 116 |
– |
archives, accessible from the Radiance web site. For current issues and |
| 117 |
– |
problems with this release, go to the radiance-online list at: |
| 118 |
– |
|
| 119 |
– |
http://www.radiance-online.org |
| 120 |
– |
|
| 121 |
– |
---------------------------------------------------------------------- |
| 122 |
– |
The Radiance Software License, Version 1.0 |
| 123 |
– |
|
| 124 |
– |
Copyright (c) 1990 - 2002 The Regents of the University of California, |
| 125 |
– |
through Lawrence Berkeley National Laboratory. All rights reserved. |
| 126 |
– |
|
| 127 |
– |
Redistribution and use in source and binary forms, with or without |
| 128 |
– |
modification, are permitted provided that the following conditions |
| 129 |
– |
are met: |
| 130 |
– |
|
| 131 |
– |
1. Redistributions of source code must retain the above copyright |
| 132 |
– |
notice, this list of conditions and the following disclaimer. |
| 133 |
– |
|
| 134 |
– |
2. Redistributions in binary form must reproduce the above copyright |
| 135 |
– |
notice, this list of conditions and the following disclaimer in |
| 136 |
– |
the documentation and/or other materials provided with the |
| 137 |
– |
distribution. |
| 138 |
– |
|
| 139 |
– |
3. The end-user documentation included with the redistribution, |
| 140 |
– |
if any, must include the following acknowledgment: |
| 141 |
– |
"This product includes Radiance software |
| 142 |
– |
(http://radsite.lbl.gov/) |
| 143 |
– |
developed by the Lawrence Berkeley National Laboratory |
| 144 |
– |
(http://www.lbl.gov/)." |
| 145 |
– |
Alternately, this acknowledgment may appear in the software itself, |
| 146 |
– |
if and wherever such third-party acknowledgments normally appear. |
| 147 |
– |
|
| 148 |
– |
4. The names "Radiance," "Lawrence Berkeley National Laboratory" |
| 149 |
– |
and "The Regents of the University of California" must |
| 150 |
– |
not be used to endorse or promote products derived from this |
| 151 |
– |
software without prior written permission. For written |
| 152 |
– |
permission, please contact [email protected]. |
| 153 |
– |
|
| 154 |
– |
5. Products derived from this software may not be called "Radiance", |
| 155 |
– |
nor may "Radiance" appear in their name, without prior written |
| 156 |
– |
permission of Lawrence Berkeley National Laboratory. |
| 157 |
– |
|
| 158 |
– |
THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED |
| 159 |
– |
WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES |
| 160 |
– |
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE |
| 161 |
– |
DISCLAIMED. IN NO EVENT SHALL Lawrence Berkeley National Laboratory OR |
| 162 |
– |
ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
| 163 |
– |
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
| 164 |
– |
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF |
| 165 |
– |
USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND |
| 166 |
– |
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, |
| 167 |
– |
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT |
| 168 |
– |
OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF |
| 169 |
– |
SUCH DAMAGE. |
| 170 |
– |
==================================================================== |
| 171 |
– |
|
| 172 |
– |
This software consists of voluntary contributions made by many |
| 173 |
– |
individuals on behalf of Lawrence Berkeley National Laboratory. For more |
| 174 |
– |
information on Lawrence Berkeley National Laboratory, please see |
| 175 |
– |
<http://www.lbl.gov/>. |
| 176 |
– |
|