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.38 by greg, Mon Aug 31 21:54:55 2020 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 8/31/2020
3 > .DA 11/13/2023
4   .LP
5 < .tl """Copyright \(co 2020 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 1192 | 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 1593 | 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

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines