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

Comparing ray/doc/ray.1 (file contents):
Revision 1.34 by greg, Mon Jun 25 20:49:10 2018 UTC vs.
Revision 1.41 by greg, Wed Nov 15 18:28:09 2023 UTC

# Line 1 | Line 1
1   .\" RCSid "$Id$"
2   .\" Print using the -ms macro package
3 < .DA 07/10/2016
3 > .DA 11/13/2023
4   .LP
5 < .tl """Copyright \(co 2017 Regents, University of California
5 > .tl """Copyright \(co 2023 Regents, University of California
6   .sp 2
7   .TL
8   The
# Line 630 | Line 630 | arguments have additional flexibility to specify the s
630   Also, rather than roughness, specular power is used, which has no
631   physical meaning other than larger numbers are equivalent to a smoother
632   surface.
633 + Unlike other material types, total reflectance is the sum of
634 + diffuse and specular colors, and should be adjusted accordingly.
635   .DS
636   mod ashik2 id
637   4+ ux uy uz funcfile transform
# Line 947 | Line 949 | invisible from behind.
949   Unlike other data-driven material types, the BSDF type is fully
950   supported and all parts of the distribution are properly sampled.
951   .LP
952 < .UL sBSDF
952 > .UL aBSDF
953   .PP
954 < The sBSDF material is identical to the BSDF type with two important
954 > The aBSDF material is identical to the BSDF type with two important
955   differences.
956   First, proxy geometry is not supported, so there is no thickness parameter.
957 < Second, an sBSDF is assumed to have some specular through component, which
957 > Second, an aBSDF is assumed to have some specular through component
958 > (the 'a' stands for "aperture"), which
959   is treated specially during the direct calculation and when viewing the
960   material.
961   Based on the BSDF data, the coefficient of specular transmission is
962   determined and used for modifying unscattered shadow and view rays.
963   .DS
964 < mod sBSDF id
964 > mod aBSDF id
965   5+ BSDFfile ux uy uz funcfile transform
966   0
967   0|3|6|9
# Line 968 | Line 971 | mod sBSDF id
971   .DE
972   .LP
973   If a material has no specular transmitted component, it is much better
974 < to use the BSDF type with a zero thickness than to use sBSDF.
974 > to use the BSDF type with a zero thickness than to use aBSDF.
975   .LP
976   .UL Antimatter
977   .PP
# Line 1191 | Line 1194 | A section of text meant to depict a picture, perhaps u
1194   font such as hexbit4x1.fnt, calls for uniform spacing.
1195   Reasonable magnitudes for proportional spacing are
1196   between 0.1 (for tightly spaced characters) and 0.3 (for wide spacing).
1197 + .LP
1198 + .UL Spectrum
1199 + .PP
1200 + The spectrum primitive is the most basic type for introducing spectral
1201 + color to a material.
1202 + Since materials only provide RGB parameters, spectral patterns
1203 + are the only way to superimpose wavelength-dependent behavior.
1204 + .DS
1205 + mod spectrum id
1206 + 0
1207 + 0
1208 + 5+ nmA nmB s1 s2 .. sN
1209 + .DE
1210 + The first two real arguments indicate the limits of the covered
1211 + spectral range in nanometers.
1212 + Subsequent real values correspond to multipliers in each wavelength band,
1213 + where the first band goes from nmA to nmA+(nmB-nmA)/N, and N is the
1214 + number of bands (i.e., the number of real arguments minus 2).
1215 + The nmA wavelength may be greater or less than the nmB wavelength,
1216 + but they may not be equal, and their ordering must correspond to
1217 + the ordering of the spectral values.
1218 + A minimum of 3 values must be given, which would act
1219 + more or less the same as a constant RGB multiplier.
1220 + As with RGB values, spectral quantities normally range between 0
1221 + and 1 at each wavelength, or average to 1.0 against a standard
1222 + sensitivity functions such as V(lambda).
1223 + The best results obtain when the spectral range and number
1224 + of samples match rendering options, though resampling will handle
1225 + any differences, zero-filling wavelenths outside the nmA to nmB
1226 + range.
1227 + A warning will be issued if the given wavelength range does not
1228 + adequately cover the visible spectrum.
1229 + .LP
1230 + .UL Specfile
1231 + .PP
1232 + The specfile primitive is equivalent to the spectrum type, but
1233 + the wavelength range and values are contained in a 1-dimensional
1234 + data file.
1235 + This may be a more convenient way to specify a spectral color,
1236 + especially one corresponding to a standard illuminant such as D65
1237 + or a library of measured spectra.
1238 + .DS
1239 + mod specfile id
1240 + 1 datafile
1241 + 0
1242 + 0
1243 + .DE
1244 + As with the spectrum type, rendering wavelengths outside the defined
1245 + range will be zero-filled.
1246 + Unlike the spectrum type, the file may contain non-uniform samples.
1247 + .LP
1248 + .UL Specfunc
1249 + .PP
1250 + The specfunc primitive offers dynamic control over a spectral
1251 + pattern, similar to the colorfunc type.
1252 + .DS
1253 + mod specfunc id
1254 + 2+ sval funcfile transform
1255 + 0
1256 + 2+ nmA nmB A3 ..
1257 + .DE
1258 + Like the spectrum primitive, the wavelength range is specified
1259 + in the first two real arguments, and additional real values are
1260 + accessible to the sval function.
1261 + This function is fed a wavelenth sample
1262 + between nmA and nmB as its only argument,
1263 + and it returns the corresponding spectral intensity.
1264   .NH 3
1265   Mixtures
1266   .PP
# Line 1592 | Line 1662 | the Ecole Polytechnique Federale de Lausanne (EPFL Uni
1662   in Lausanne, Switzerland.
1663   .NH 1
1664   References
1665 + .LP
1666 + Ward, Gregory J., Bruno Bueno, David Geisler-Moroder,
1667 + Lars O. Grobe, Jacob C. Jonsson, Eleanor
1668 + S. Lee, Taoning Wang, Helen Rose Wilson,
1669 + ``Daylight Simulation Workflows Incorporating
1670 + Measured Bidirectional Scattering Distribution Functions,''
1671 + .I "Energy & Buildings",
1672 + Vol. 259, No. 111890, 2022.
1673 + .LP
1674 + Wang, Taoning, Gregory Ward, Eleanor Lee,
1675 + ``Efficient modeling of optically-complex, non-coplanar
1676 + exterior shading: Validation of matrix algebraic methods,''
1677 + .I "Energy & Buildings",
1678 + vol. 174, pp. 464-83, Sept. 2018.
1679   .LP
1680   Lee, Eleanor S., David Geisler-Moroder, Gregory Ward,
1681   ``Modeling the direct sun component in buildings using matrix

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines