| 5 |
|
.SH SYNOPSIS |
| 6 |
|
.B bsdf2ttree |
| 7 |
|
[ |
| 8 |
+ |
.B "\-pC" |
| 9 |
+ |
][ |
| 10 |
+ |
.B "{+|-}a" |
| 11 |
+ |
][ |
| 12 |
|
.B "\-g Nlog2" |
| 13 |
|
][ |
| 14 |
< |
.B "\-t pctcull |
| 14 |
> |
.B "\-t pctcull" |
| 15 |
> |
][ |
| 16 |
> |
.B "\-l maxlobes" |
| 17 |
|
] |
| 18 |
|
[ |
| 19 |
|
.B "bsdf.sir .." |
| 24 |
|
.B bsdf2ttree |
| 25 |
|
.B "\-t{3|4}" |
| 26 |
|
[ |
| 27 |
+ |
.B "\-pC" |
| 28 |
+ |
][ |
| 29 |
+ |
.B "{+|-}a" |
| 30 |
+ |
][ |
| 31 |
|
.B "\-g Nlog2" |
| 32 |
|
][ |
| 33 |
< |
.B "\-t pctcull |
| 33 |
> |
.B "\-t pctcull" |
| 34 |
|
][ |
| 35 |
|
.B "{+|-}forward" |
| 36 |
|
][ |
| 37 |
|
.B "{+|-}backward" |
| 38 |
|
][ |
| 39 |
< |
.B "\-e expr |
| 39 |
> |
.B "\-e expr" |
| 40 |
|
][ |
| 41 |
< |
.B "\-f file |
| 41 |
> |
.B "\-f file" |
| 42 |
|
] |
| 43 |
|
.B bsdf_func |
| 44 |
|
.SH DESCRIPTION |
| 50 |
|
A complete XML description is written to the standard output, |
| 51 |
|
which is normally redirected to a file. |
| 52 |
|
.PP |
| 53 |
+ |
The |
| 54 |
+ |
.I \-p |
| 55 |
+ |
option by itself turns off the progress bar, whose length may be set |
| 56 |
+ |
by an immediately following integer argument. |
| 57 |
+ |
(The default progress bar length is 79 characters.)\0 |
| 58 |
+ |
.PP |
| 59 |
+ |
The |
| 60 |
+ |
.I \-a |
| 61 |
+ |
option turns off reciprocity averaging for isotropic scattering or anisotropic reflection. |
| 62 |
+ |
Normally on (+a), this ensures that the tensor BRDF obeys Helmholtz reciprocity. |
| 63 |
+ |
However, in certain rare cases, reciprocity averaging can cause unwanted noise in the output. |
| 64 |
+ |
.PP |
| 65 |
|
The maximum resolution of the tensor tree may be controlled by the |
| 66 |
|
.I \-g |
| 67 |
|
option, which defaults to a value of 6. |
| 86 |
|
the four components, and if the first component |
| 87 |
|
is isotropic, all components must be isotropic. |
| 88 |
|
A similar rule holds for anisotropic inputs. |
| 89 |
+ |
The |
| 90 |
+ |
.I \-l |
| 91 |
+ |
option may be used to specify the maximum number of lobes in any |
| 92 |
+ |
interpolated radial basis function. |
| 93 |
+ |
The default value is 15000, which generally keeps the interpolation tractable. |
| 94 |
+ |
Setting the value to 0 turns off this limit. |
| 95 |
|
.PP |
| 96 |
|
In the second invocation form, |
| 97 |
|
.I bsdf2ttree |
| 118 |
|
options, and should obey both Helmholtz reciprocity and |
| 119 |
|
integrate to less than 1 over each projected incident hemisphere |
| 120 |
|
for energy conservation. |
| 121 |
+ |
The variable and function definitions in each |
| 122 |
+ |
.I \-f source |
| 123 |
+ |
file are read and compiled from the RADIANCE library where it is found. |
| 124 |
|
If the |
| 125 |
|
.I \-t3 |
| 126 |
|
option is specified, the defined function is assumed to be isotropic. |
| 153 |
|
isotropic Phong distribution: |
| 154 |
|
.IP "" .2i |
| 155 |
|
bsdf2ttree -g 5 -t3 -e 'phong(ix,iy,iz,ox,oy,oz) = if(iz, .1+((iz+oz)/sqrt((ix+ox)^2+(iy+oy)^2+(iz+oz)^2))^50, 0)' phong > phong.xml |
| 156 |
+ |
.SH ENVIRONMENT |
| 157 |
+ |
RAYPATH the directories to check for auxiliary files. |
| 158 |
|
.SH AUTHOR |
| 159 |
|
Greg Ward |
| 160 |
|
.SH "SEE ALSO" |
| 161 |
< |
bsdf2klems(1), icalc(1), genBSDF(1), pkgBSDF(1) |
| 161 |
> |
bsdf2klems(1), icalc(1), genBSDF(1), pkgBSDF(1), rcontrib(1), |
| 162 |
> |
rfluxmtx(1), wrapBSDF(1) |
