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

Comparing ray/doc/man/man1/genBSDF.1 (file contents):
Revision 1.5 by greg, Fri May 6 23:58:09 2011 UTC vs.
Revision 1.6 by greg, Fri Jun 3 19:41:14 2011 UTC

# Line 11 | Line 11 | genBSDF - generate BSDF description from Radiance or M
11   ][
12   .B "\-r 'rtcontrib opts...'"
13   ][
14 + .B "\-t{3|4} Nlog2"
15 + ][
16   .B "{+|-}forward"
17   ][
18   .B "{+|-}backward"
# Line 87 | Line 89 | option may be used to specify a set of quoted argument
89   included on the
90   .I rtcontrib
91   command line.
92 + .PP
93 + The
94 + .I \-t4
95 + mode computes a non-uniform BSDF represented as a rank 4 tensor tree,
96 + suitable for use in the Radiance rendering tools.
97 + The parameter given to this option is the log to the base 2 of the
98 + sampling resolution in each dimension, and must be an integer.
99 + The
100 + .I \-c
101 + setting should be adjusted so that an appropriate number of samples
102 + lands in each region.
103 + A
104 + .I \-t4
105 + parameter of 5 corresponds to 32x32 or 1024 output regions, so a
106 + .I \-c
107 + setting of 102400 would provide 100 samples per region on average.
108 + Increasing the resolution to 6 corresponds to 64x64 or 4096
109 + regions, so the
110 + .I \-c
111 + setting would need to be increased by a factor of 4 to provide
112 + the same accuracy in each region.
113 + .PP
114 + The
115 + .I \-t3
116 + mode is similar to
117 + .I \-t4
118 + but computes a rank 3 tensor tree rather than rank 4.
119 + This provides a much faster computation, but only works
120 + in special circumstances.
121 + Specifically, do NOT use this option if the system is not in fact isotropic.
122 + I.e., only use
123 + .I \-t3
124 + when you are certain that the system has a high degree of radial symmetry.
125 + Again, the parameter to this option sets the maximum resolution as
126 + a power of 2 in each dimension, but in this case there is one less
127 + dimension being sampled.
128   .SH EXAMPLE
129   To create a BSDF description including geometry from a set of venetian blinds:
130   .IP "" .2i
131   genblinds blind_white blind1 .07 3 1.5 30 40 | xform -rz -90 -rx 90 > blind1.rad
132   .br
133   genBSDF -r @rtc.opt blind_white.mat glazing.rad blind1.rad > blind1.xml
134 + .PP
135 + To create a non-uniform, anisotropic BSDF distribution with a maximum
136 + resolution of 128x128 from the same description:
137 + .IP "" .2i
138 + genBSDF -r @rtc.opt -t4 7 -c 160000 blind_white.mat glazing.rad blind1.rad > blind12.xml
139 + .SH NOTES
140 + The variable resolution (tensor tree) BSDF representation is not supported
141 + by all software and applicatons, and should be used with caution.
142 + It provides practical, high-resolution data for use in the
143 + Radiance rendering programs, but does not work in the matrix formulation
144 + of the daylight coefficient method for example.
145 + Also, third party tools generally expect or require a fixed number of sample
146 + directions using the Klems directions or similar.
147   .SH AUTHOR
148   Greg Ward
149   .SH "SEE ALSO"

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines