ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/doc/man/man1/mkillum.1
(Generate patch)

Comparing ray/doc/man/man1/mkillum.1 (file contents):
Revision 1.6 by greg, Tue Sep 4 17:36:40 2007 UTC vs.
Revision 1.7 by greg, Thu Dec 13 07:03:36 2007 UTC

# Line 139 | Line 139 | Only produce secondary sources for surfaces modified b
139   .TP
140   .BR n
141   Do not produce any secondary sources.
142 < All input will be passed to the output unaffected.
142 > All input will be passed to the output unaffected, except any
143 > void surfaces will be removed.
144   .TP
145   .BI b =real
146   Do not produce a secondary source for a surface if its average
# Line 173 | Line 174 | If
174   is zero, then a diffuse source is assumed and no distribution is
175   created.
176   .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
196   .BI s =integer
197   Set the number of ray samples per direction to
198   .I integer.
# Line 193 | Line 213 | will use the material type "illum" with the input surf
213   as its alternate material.
214   The default is
215   .I l-.
216 + .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.
225 + The default value is +Z.
226 + .TP
227 + .BI t =real
228 + Set the surface thickness to
229 + .I real
230 + in world coordinates.
231 + This value is used for determining where to start rays that need to begin
232 + on the opposite side of the surface, specifically to compute the incoming
233 + distribution for a BSDF computation.
234 + The default value is 0.
235   .SH EXAMPLES
236   The following command generates illum's corresponding to geometry
237   in the files "it1.rad" and "it2.rad":
# Line 201 | Line 240 | mkillum \-ab 2 \-ad 1024 \-av .1 .1 .1 basic.oct "<" i
240   .PP
241   The output file "illums.rad" would then be combined with the original
242   scene geometry to create a more easily rendered composite.
243 + .SH ENVIRONMENT
244 + RAYPATH         the directories to check for auxiliary files.
245   .SH AUTHOR
246   Greg Ward
247   .SH ACKNOWLEDGEMENT

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines