--- ray/doc/man/man1/mkillum.1 2004/01/01 19:31:45 1.3 +++ ray/doc/man/man1/mkillum.1 2007/12/13 07:03:36 1.7 @@ -1,10 +1,12 @@ -.\" RCSid "$Id: mkillum.1,v 1.3 2004/01/01 19:31:45 greg Exp $" +.\" RCSid "$Id: mkillum.1,v 1.7 2007/12/13 07:03:36 greg Exp $" .TH MKILLUM 1 10/6/95 RADIANCE .SH NAME mkillum - compute illum sources for a RADIANCE scene .SH SYNOPSIS .B mkillum [ +.B "\-n nprocs" +][ .B "rtrace options" ] .B octree @@ -27,7 +29,16 @@ directional distributions. These are best handled respectively by the ambient calculation and the secondary source types in RADIANCE. .PP -The arguments to +If the +.I \-n +option is specified with a value greater than 1, multiple +.I rtrace(1) +processes will be used to accelerate computation on a shared +memory machine. +Note that there is no benefit to using more processes +than there are local CPUs available to do the work. +.PP +Remaining arguments to .I mkillum are passed directly to .I rtrace(1), @@ -128,7 +139,8 @@ Only produce secondary sources for surfaces modified b .TP .BR n Do not produce any secondary sources. -All input will be passed to the output unaffected. +All input will be passed to the output unaffected, except any +void surfaces will be removed. .TP .BI b =real Do not produce a secondary source for a surface if its average @@ -162,6 +174,25 @@ If is zero, then a diffuse source is assumed and no distribution is created. .TP +.BI d =string +Set the surface Bidirectional Scattering Distribution Function (BSDF) +to the given file. +The RADIANCE library path will be searched if the file does not begin +with a '.' or '~' character. +This file must contain an LBNL Window 6 XML specification of a valid +BSDF for the given surface, and all rays will be interpreted through +this function. +The orientation of the BSDF may be controlled with the +.I u +setting, described below. +The thickness of the surface may be controlled with the +.I t +setting. +If this variable has no setting or an integer is specified, +.I mkillum +returns to the default behavior of computing the output distribution +directly. +.TP .BI s =integer Set the number of ray samples per direction to .I integer. @@ -182,6 +213,35 @@ will use the material type "illum" with the input surf as its alternate material. The default is .I l-. +.TP +.BI u =[+|-]{X|Y|Z} +The given axis will be considered "up" for the purposes of interpreting +BSDF data specified with the +.I d +variable. +The BSDF will be reoriented relative to the surface as necessary to keep +the up vector in the vertical plane that contains this axis and the +surface normal. +The default value is +Z. +.TP +.BI t =real +Set the surface thickness to +.I real +in world coordinates. +This value is used for determining where to start rays that need to begin +on the opposite side of the surface, specifically to compute the incoming +distribution for a BSDF computation. +The default value is 0. +.SH EXAMPLES +The following command generates illum's corresponding to geometry +in the files "it1.rad" and "it2.rad": +.IP "" .3i +mkillum \-ab 2 \-ad 1024 \-av .1 .1 .1 basic.oct "<" it1.rad it2.rad > illums.rad +.PP +The output file "illums.rad" would then be combined with the original +scene geometry to create a more easily rendered composite. +.SH ENVIRONMENT +RAYPATH the directories to check for auxiliary files. .SH AUTHOR Greg Ward .SH ACKNOWLEDGEMENT