| 9 |
|
][ |
| 10 |
|
.B "\-n Nproc" |
| 11 |
|
][ |
| 12 |
< |
.B "\-r 'rtcontrib opts...'" |
| 12 |
> |
.B "\-r 'rcontrib opts...'" |
| 13 |
|
][ |
| 14 |
+ |
.B "\-W" |
| 15 |
+ |
][ |
| 16 |
+ |
.B "\-s 'x=string;y=string'" |
| 17 |
+ |
][ |
| 18 |
|
.B "\-t{3|4} Nlog2" |
| 19 |
|
][ |
| 20 |
+ |
.B "{+|-}C" |
| 21 |
+ |
][ |
| 22 |
|
.B "{+|-}forward" |
| 23 |
|
][ |
| 24 |
|
.B "{+|-}backward" |
| 25 |
|
][ |
| 26 |
|
.B "{+|-}mgf" |
| 27 |
|
][ |
| 28 |
< |
.B "{+|-}geom |
| 28 |
> |
.B "{+|-}geom unit" |
| 29 |
|
][ |
| 30 |
|
.B "\-dim Xmin Xmax Ymin Ymax Zmin Zmax" |
| 31 |
|
] |
| 42 |
|
The output conforms to the LBNL Window 6 XML standard for BSDF data, |
| 43 |
|
and will include an MGF representation of the input geometry if the |
| 44 |
|
.I \+geom |
| 45 |
< |
option is given. |
| 46 |
< |
(This is the default, and may be switched off using |
| 47 |
< |
.I \-geom.)\0 |
| 45 |
> |
option is given, followed by one of "meter," "foot," "inch," |
| 46 |
> |
"centimeter," or "millimeter," depending on the scene units. |
| 47 |
> |
The default is to include the provided geometry, |
| 48 |
> |
which is assumed to be in meters. |
| 49 |
> |
Geometry output can be supressed with the |
| 50 |
> |
.I \-geom |
| 51 |
> |
option, which must also be followed by one of the above length units. |
| 52 |
|
.PP |
| 53 |
|
Normally, |
| 54 |
|
.I genBSDF |
| 60 |
|
To turn off backward components, use the |
| 61 |
|
.I \-backward |
| 62 |
|
option. |
| 63 |
< |
Computing both components takes about twice as long as one component. |
| 63 |
> |
Computing both components takes about twice as long as one component, but |
| 64 |
> |
is recommended when rays will be impinging from either side. |
| 65 |
|
.PP |
| 66 |
+ |
The |
| 67 |
+ |
.I \+C |
| 68 |
+ |
option specifies that the output XML should include color information, |
| 69 |
+ |
which is interpreted by the rendering programs. |
| 70 |
+ |
The default option |
| 71 |
+ |
.I \-C |
| 72 |
+ |
reduces all BSDF data to grayscale. |
| 73 |
+ |
.PP |
| 74 |
|
The geometry must fit a rectangular profile, whose width is along the X-axis, |
| 75 |
|
height is in the Y-axis, and depth is in the Z-axis. |
| 76 |
|
The positive Z-axis points into the room, and the input geometry should |
| 93 |
|
samples per incident direction using the |
| 94 |
|
.I \-c |
| 95 |
|
option. |
| 96 |
< |
This value defaults to 1000 samples distributed over the incoming plane |
| 96 |
> |
This value defaults to 2000 samples distributed over the incoming plane |
| 97 |
|
for each of the 145 Klems hemisphere directions. |
| 98 |
|
.PP |
| 99 |
< |
In some cases, the processing time may be reduced by the |
| 99 |
> |
On multi-core machines, processing time may be reduced by the |
| 100 |
|
.I \-n |
| 101 |
|
option, which specifies the number of simultaneous |
| 83 |
– |
.I rtrace(1) |
| 102 |
|
processes to run in |
| 103 |
< |
.I rtcontrib(1). |
| 103 |
> |
.I rcontrib(1). |
| 104 |
|
The |
| 105 |
|
.I \-r |
| 106 |
|
option may be used to specify a set of quoted arguments to be |
| 107 |
|
included on the |
| 108 |
< |
.I rtcontrib |
| 108 |
> |
.I rcontrib |
| 109 |
|
command line. |
| 110 |
|
.PP |
| 111 |
|
The |
| 112 |
+ |
.I \-W |
| 113 |
+ |
option is passed to |
| 114 |
+ |
.I wrapBSDF(1) |
| 115 |
+ |
to prepare the XML file for WINDOW6. |
| 116 |
+ |
Any |
| 117 |
+ |
.I \-s |
| 118 |
+ |
parameters are passed to the |
| 119 |
+ |
.I \-f |
| 120 |
+ |
option of |
| 121 |
+ |
.I wrapBSDF, |
| 122 |
+ |
controlling XML fields such as |
| 123 |
+ |
the Manufacturer (e.g., -s m=MF) and device Name (e.g, -s n=NM). |
| 124 |
+ |
.PP |
| 125 |
+ |
The |
| 126 |
|
.I \-t4 |
| 127 |
|
mode computes a non-uniform BSDF represented as a rank 4 tensor tree, |
| 128 |
|
suitable for use in the Radiance rendering tools. |
| 136 |
|
.I \-t4 |
| 137 |
|
parameter of 5 corresponds to 32x32 or 1024 output regions, so a |
| 138 |
|
.I \-c |
| 139 |
< |
setting of 102400 would provide 100 samples per region on average. |
| 139 |
> |
setting of 10240 would provide 10 samples per region on average. |
| 140 |
|
Increasing the resolution to 6 corresponds to 64x64 or 4096 |
| 141 |
|
regions, so the |
| 142 |
|
.I \-c |
| 179 |
|
.SH AUTHOR |
| 180 |
|
Greg Ward |
| 181 |
|
.SH "SEE ALSO" |
| 182 |
< |
dctimestep(1), genklemsamp(1), genskyvec(1), mkillum(1), rtcontrib(1), rtrace(1) |
| 182 |
> |
dctimestep(1), gendaymtx(1), genklemsamp(1), genskyvec(1), mkillum(1), |
| 183 |
> |
pkgBSDF(1), rcontrib(1), rfluxmtx(1), rmtxop(1), rtrace(1) wrapBSDF(1) |
