| 5 |
|
.SH SYNOPSIS |
| 6 |
|
.B mkillum |
| 7 |
|
[ |
| 8 |
+ |
.B "\-n nprocs" |
| 9 |
+ |
][ |
| 10 |
|
.B "rtrace options" |
| 11 |
|
] |
| 12 |
|
.B octree |
| 20 |
|
secondary sources whose contributions can be computed more efficiently by |
| 21 |
|
.I rpict(1) |
| 22 |
|
and |
| 23 |
< |
.I rview(1). |
| 23 |
> |
.I rvu(1). |
| 24 |
|
This type of optimization is most useful for windows and skylights which |
| 25 |
|
represent concentrated sources of indirect illumination. |
| 26 |
|
.I Mkillum |
| 29 |
|
These are best handled respectively by the ambient calculation |
| 30 |
|
and the secondary source types in RADIANCE. |
| 31 |
|
.PP |
| 32 |
< |
The arguments to |
| 32 |
> |
If the |
| 33 |
> |
.I \-n |
| 34 |
> |
option is specified with a value greater than 1, multiple |
| 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 |
| 50 |
< |
.I rtrace(1) |
| 59 |
> |
can tell where the rendering arguments |
| 60 |
|
end and its own input files begin. |
| 61 |
|
.SH VARIABLES |
| 62 |
|
.I Mkillum |
| 137 |
|
.TP |
| 138 |
|
.BR n |
| 139 |
|
Do not produce any secondary sources. |
| 140 |
< |
All input will be passed to the output unaffected. |
| 140 |
> |
All input will be passed to the output unaffected, except any |
| 141 |
> |
void surfaces will be removed. |
| 142 |
|
.TP |
| 143 |
|
.BI b =real |
| 144 |
|
Do not produce a secondary source for a surface if its average |
| 192 |
|
as its alternate material. |
| 193 |
|
The default is |
| 194 |
|
.I l-. |
| 195 |
+ |
.SH EXAMPLES |
| 196 |
+ |
The following command generates illum's corresponding to geometry |
| 197 |
+ |
in the files "it1.rad" and "it2.rad": |
| 198 |
+ |
.IP "" .3i |
| 199 |
+ |
mkillum \-ab 2 \-ad 1024 \-av .1 .1 .1 basic.oct "<" it1.rad it2.rad > illums.rad |
| 200 |
+ |
.PP |
| 201 |
+ |
The output file "illums.rad" would then be combined with the original |
| 202 |
+ |
scene geometry to create a more easily rendered composite. |
| 203 |
+ |
.SH ENVIRONMENT |
| 204 |
+ |
RAYPATH the directories to check for auxiliary files. |
| 205 |
|
.SH AUTHOR |
| 206 |
|
Greg Ward |
| 207 |
|
.SH ACKNOWLEDGEMENT |
| 208 |
|
Work on this program was initiated and sponsored by the LESO |
| 209 |
|
group at EPFL in Switzerland. |
| 210 |
|
.SH "SEE ALSO" |
| 211 |
< |
oconv(1), rad(1), rpict(1), rtrace(1), rview(1) |
| 211 |
> |
genBSDF(1), oconv(1), rad(1), rpict(1), rtrace(1), rvu(1) |
