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.40 by greg, Fri Nov 3 17:41:27 2023 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 5/11/2023
3 > .DA 11/13/2023
4   .LP
5   .tl """Copyright \(co 2023 Regents, University of California
6   .sp 2
# Line 1194 | 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

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines