| 11 |
|
][ |
| 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 "{+|-}a" |
| 23 |
+ |
][ |
| 24 |
|
.B "{+|-}forward" |
| 25 |
|
][ |
| 26 |
|
.B "{+|-}backward" |
| 34 |
|
[ |
| 35 |
|
.B "geom .." |
| 36 |
|
] |
| 37 |
+ |
.br |
| 38 |
+ |
or |
| 39 |
+ |
.br |
| 40 |
+ |
.B genBSDF |
| 41 |
+ |
.B "\-recover tempdir" |
| 42 |
|
.SH DESCRIPTION |
| 43 |
|
.I GenBSDF |
| 44 |
|
computes a bidirectional scattering distribution function from |
| 67 |
|
To turn off backward components, use the |
| 68 |
|
.I \-backward |
| 69 |
|
option. |
| 70 |
< |
Computing both components takes about twice as long as one component. |
| 70 |
> |
Computing both components takes about twice as long as one component, but |
| 71 |
> |
is recommended when rays will be impinging from either side. |
| 72 |
|
.PP |
| 73 |
+ |
The |
| 74 |
+ |
.I \+C |
| 75 |
+ |
option specifies that the output XML should include color information, |
| 76 |
+ |
which is interpreted by the rendering programs. |
| 77 |
+ |
The default option |
| 78 |
+ |
.I \-C |
| 79 |
+ |
reduces all BSDF data to grayscale. |
| 80 |
+ |
.PP |
| 81 |
+ |
The |
| 82 |
+ |
.I \-a |
| 83 |
+ |
option turns off reciprocity averaging for tensor tree output. |
| 84 |
+ |
Normally on (+a), this ensures that each tensor-tree hemisphere follows symmetry |
| 85 |
+ |
implied by Helmholtz reciprocity, and is designed to reduce ray sampling noise. |
| 86 |
+ |
However, for some systems, reciprocity averaging can actually make the output worse. |
| 87 |
+ |
.PP |
| 88 |
|
The geometry must fit a rectangular profile, whose width is along the X-axis, |
| 89 |
|
height is in the Y-axis, and depth is in the Z-axis. |
| 90 |
|
The positive Z-axis points into the room, and the input geometry should |
| 110 |
|
This value defaults to 2000 samples distributed over the incoming plane |
| 111 |
|
for each of the 145 Klems hemisphere directions. |
| 112 |
|
.PP |
| 113 |
< |
In some cases, the processing time may be reduced by the |
| 113 |
> |
On multi-core machines, processing time may be reduced by the |
| 114 |
|
.I \-n |
| 115 |
|
option, which specifies the number of simultaneous |
| 87 |
– |
.I rtrace(1) |
| 116 |
|
processes to run in |
| 117 |
|
.I rcontrib(1). |
| 118 |
|
The |
| 123 |
|
command line. |
| 124 |
|
.PP |
| 125 |
|
The |
| 126 |
+ |
.I \-W |
| 127 |
+ |
option is passed to |
| 128 |
+ |
.I wrapBSDF(1) |
| 129 |
+ |
to prepare the XML file for WINDOW6. |
| 130 |
+ |
Any |
| 131 |
+ |
.I \-s |
| 132 |
+ |
parameters are passed to the |
| 133 |
+ |
.I \-f |
| 134 |
+ |
option of |
| 135 |
+ |
.I wrapBSDF, |
| 136 |
+ |
controlling XML fields such as |
| 137 |
+ |
the Manufacturer (e.g., -s m=MF) and device Name (e.g, -s n=NM). |
| 138 |
+ |
.PP |
| 139 |
+ |
The |
| 140 |
|
.I \-t4 |
| 141 |
|
mode computes a non-uniform BSDF represented as a rank 4 tensor tree, |
| 142 |
|
suitable for use in the Radiance rendering tools. |
| 171 |
|
Again, the parameter to this option sets the maximum resolution as |
| 172 |
|
a power of 2 in each dimension, but in this case there is one less |
| 173 |
|
dimension being sampled. |
| 174 |
+ |
.PP |
| 175 |
+ |
The |
| 176 |
+ |
.I \-recover |
| 177 |
+ |
option is available for continuing calculations that were killed by |
| 178 |
+ |
the system or the user. |
| 179 |
+ |
Unfortunately, genBSDF puts its temporary files in a directory |
| 180 |
+ |
that is often cleaned up after reboot, so this may not always work. |
| 181 |
|
.SH EXAMPLE |
| 182 |
|
To create a BSDF description including geometry from a set of venetian blinds: |
| 183 |
|
.IP "" .2i |
| 200 |
|
.SH AUTHOR |
| 201 |
|
Greg Ward |
| 202 |
|
.SH "SEE ALSO" |
| 203 |
< |
dctimestep(1), genklemsamp(1), genskyvec(1), mkillum(1), |
| 204 |
< |
pkgBSDF(1), rcontrib(1), rtrace(1) |
| 203 |
> |
dctimestep(1), gendaymtx(1), genklemsamp(1), genskyvec(1), mkillum(1), |
| 204 |
> |
pkgBSDF(1), rcontrib(1), rfluxmtx(1), rmtxcomb(1), rmtxop(1), rtrace(1) wrapBSDF(1) |
