| 7 |
|
[ |
| 8 |
|
.B "\-n nprocs" |
| 9 |
|
][ |
| 10 |
+ |
.B \-r |
| 11 |
+ |
][ |
| 12 |
|
.B "\-e expr" |
| 13 |
|
][ |
| 14 |
|
.B "\-f source" |
| 16 |
|
.B "\-o ospec" |
| 17 |
|
][ |
| 18 |
|
.B "\-b binv" |
| 19 |
+ |
][ |
| 20 |
+ |
.B "\-bn nbins" |
| 21 |
|
] |
| 22 |
< |
.B "\-m mod .." |
| 22 |
> |
{ |
| 23 |
> |
.B "\-m mod | \-M file" |
| 24 |
> |
} |
| 25 |
> |
.. |
| 26 |
|
[ |
| 27 |
|
.B $EVAR |
| 28 |
|
] |
| 44 |
|
These modifiers are usually materials associated with |
| 45 |
|
light sources or sky domes, and must directly modify some geometric |
| 46 |
|
primitives to be considered in the output. |
| 47 |
+ |
A modifier list may also be read from a file using the |
| 48 |
+ |
.I \-M |
| 49 |
+ |
option. |
| 50 |
+ |
The RAYPATH environment variable determines directories to search for |
| 51 |
+ |
this file. |
| 52 |
+ |
(No search takes place if a file name begins with a '.', '/' or '~' |
| 53 |
+ |
character.)\0 |
| 54 |
+ |
.PP |
| 55 |
|
The output of |
| 56 |
|
.I rtcontrib |
| 57 |
|
has many potential uses. |
| 74 |
|
If a destination begins with an exclamation mark ('!'), then |
| 75 |
|
a pipe is opened to a command and data is sent to its standard input. |
| 76 |
|
Otherwise, the destination is treated as a file. |
| 77 |
< |
(An existing file of the same name is clobbered.)\0 |
| 77 |
> |
An existing file of the same name is clobbered, unless the |
| 78 |
> |
.I \-r |
| 79 |
> |
option is specified, in which case data recovery is attempted. |
| 80 |
|
If an output specification contains a "%s" format, this will be |
| 81 |
|
replaced by the modifier name. |
| 82 |
|
The |
| 87 |
|
specification if present. |
| 88 |
|
The actual bin number is computed at run time based on ray direction |
| 89 |
|
and surface intersection, as described below. |
| 90 |
+ |
If the number of bins is known in advance, it should be specified with the |
| 91 |
+ |
.I \-bn |
| 92 |
+ |
option, and this is critical for output files containing multiple values |
| 93 |
+ |
per record. |
| 94 |
+ |
Since bin numbers start from 0, the bin count is always equal to |
| 95 |
+ |
the last bin plus 1. |
| 96 |
+ |
Set the this value to 0 if the bin count is unknown (the default). |
| 97 |
|
The most recent |
| 98 |
< |
.I \-b |
| 98 |
> |
.I \-b, |
| 99 |
> |
.I \-bn |
| 100 |
|
and |
| 101 |
|
.I \-o |
| 102 |
|
options to the left of each |
| 134 |
|
will search the RADIANCE library directories for each file given in a |
| 135 |
|
.I \-f |
| 136 |
|
option. |
| 112 |
– |
(No search takes place if a file name begins with a '.', '/' or '~' |
| 113 |
– |
character.)\0 |
| 137 |
|
.PP |
| 138 |
|
If no |
| 139 |
|
.I \-o |
| 214 |
|
.PP |
| 215 |
|
To compute an array of illuminance contributions according to a Tregenza sky: |
| 216 |
|
.IP "" .2i |
| 217 |
< |
rtcontrib -b tbin -o sky.dat -m skyglow -b 0 -o ground.dat -m groundglow |
| 217 |
> |
rtcontrib -I+ -b tbin -o sky.dat -m skyglow -b 0 -o ground.dat -m groundglow |
| 218 |
|
@render.opt -f tregenza.cal scene.oct < test.dat |
| 219 |
|
.SH ENVIRONMENT |
| 220 |
< |
RAYPATH path to search for -f files |
| 220 |
> |
RAYPATH path to search for -f and -M files |
| 221 |
|
.SH AUTHOR |
| 222 |
|
Greg Ward |
| 223 |
|
.SH "SEE ALSO" |
