| 32 |
|
If the |
| 33 |
|
.I \-n |
| 34 |
|
option is specified with a value greater than 1, multiple |
| 35 |
< |
.I rtrace(1) |
| 36 |
< |
processes will be used to accelerate computation on a shared |
| 35 |
> |
ray tracing processes will be used to accelerate computation on a shared |
| 36 |
|
memory machine. |
| 37 |
|
Note that there is no benefit to using more processes |
| 38 |
|
than there are local CPUs available to do the work. |
| 39 |
|
.PP |
| 40 |
|
Remaining arguments to |
| 41 |
|
.I mkillum |
| 42 |
< |
are passed directly to |
| 42 |
> |
are interpreted as rendering options for |
| 43 |
|
.I rtrace(1), |
| 44 |
< |
which is used to compute the light distributions for the input surfaces. |
| 44 |
> |
to compute the light distributions for the input surfaces. |
| 45 |
|
These surfaces can be any combination of polygons, spheres and rings. |
| 46 |
|
Other surfaces may be included, but |
| 47 |
|
.I mkillum |
| 56 |
|
(Note that this character must be escaped from most shells.) |
| 57 |
|
This is necessary so |
| 58 |
|
.I mkillum |
| 59 |
< |
can tell where the arguments to |
| 61 |
< |
.I rtrace(1) |
| 59 |
> |
can tell where the rendering arguments |
| 60 |
|
end and its own input files begin. |
| 61 |
|
.SH VARIABLES |
| 62 |
|
.I Mkillum |
| 172 |
|
is zero, then a diffuse source is assumed and no distribution is |
| 173 |
|
created. |
| 174 |
|
.TP |
| 177 |
– |
.BI d =string |
| 178 |
– |
Set the surface Bidirectional Scattering Distribution Function (BSDF) |
| 179 |
– |
to the given file. |
| 180 |
– |
The RADIANCE library path will be searched if the file does not begin |
| 181 |
– |
with a '.' or '~' character. |
| 182 |
– |
This file must contain an LBNL Window 6 XML specification of a valid |
| 183 |
– |
BSDF for the given surface, and all rays will be interpreted through |
| 184 |
– |
this function. |
| 185 |
– |
The orientation of the BSDF may be controlled with the |
| 186 |
– |
.I u |
| 187 |
– |
setting, described below. |
| 188 |
– |
The thickness of the surface may be controlled with the |
| 189 |
– |
.I t |
| 190 |
– |
setting. |
| 191 |
– |
If this variable has no setting or an integer is specified, |
| 192 |
– |
.I mkillum |
| 193 |
– |
returns to the default behavior of computing the output distribution |
| 194 |
– |
directly. |
| 195 |
– |
.TP |
| 175 |
|
.BI s =integer |
| 176 |
|
Set the number of ray samples per direction to |
| 177 |
|
.I integer. |
| 193 |
|
The default is |
| 194 |
|
.I l-. |
| 195 |
|
.TP |
| 217 |
– |
.BI u =[+|-]{X|Y|Z} |
| 218 |
– |
The given axis will be considered "up" for the purposes of interpreting |
| 219 |
– |
BSDF data specified with the |
| 220 |
– |
.I d |
| 221 |
– |
variable. |
| 222 |
– |
The BSDF will be reoriented relative to the surface as necessary to keep |
| 223 |
– |
the up vector in the vertical plane that contains this axis and the |
| 224 |
– |
surface normal, corresponding to an azimuth of 90 degrees. |
| 225 |
– |
The default up vector is +Z. |
| 226 |
– |
.TP |
| 196 |
|
.BI t =real |
| 197 |
|
Set the surface thickness to |
| 198 |
|
.I real |
| 199 |
|
in world coordinates. |
| 200 |
|
This value is used for determining where to start rays that need to begin |
| 201 |
< |
on the opposite side of the surface, specifically to compute the incoming |
| 202 |
< |
distribution for a BSDF computation. |
| 203 |
< |
The default value is 0. |
| 201 |
> |
on the opposite side of a fenestration system, specifically |
| 202 |
> |
to compute the incoming distribution for a BSDF computation. |
| 203 |
> |
If the thickness is set to 0 and a BSDF contains detailed geometry, |
| 204 |
> |
it will be translated and output as part of the new description, provided the |
| 205 |
> |
.I l- |
| 206 |
> |
option is also in effect. |
| 207 |
> |
(This currently works only for rectangular polygons.)\0 |
| 208 |
> |
The default thickness is 0. |
| 209 |
|
.SH EXAMPLES |
| 210 |
|
The following command generates illum's corresponding to geometry |
| 211 |
|
in the files "it1.rad" and "it2.rad": |
| 222 |
|
Work on this program was initiated and sponsored by the LESO |
| 223 |
|
group at EPFL in Switzerland. |
| 224 |
|
.SH "SEE ALSO" |
| 225 |
< |
oconv(1), rad(1), rpict(1), rtrace(1), rvu(1) |
| 225 |
> |
genBSDF(1), oconv(1), rad(1), rpict(1), rtrace(1), rvu(1) |
