| 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 |
| 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 extrema of the |
| 1211 |
+ |
spectral range in nanometers. |
| 1212 |
+ |
Subsequent real values correspond to multipliers at each wavelength. |
| 1213 |
+ |
The nmA wavelength may be greater or less than nmB, |
| 1214 |
+ |
but they may not be equal, and their ordering matches |
| 1215 |
+ |
the order of the spectral values. |
| 1216 |
+ |
A minimum of 3 values must be given, which would act |
| 1217 |
+ |
more or less the same as a constant RGB multiplier. |
| 1218 |
+ |
As with RGB values, spectral quantities normally range between 0 |
| 1219 |
+ |
and 1 at each wavelength, or average to 1.0 against a standard |
| 1220 |
+ |
sensitivity functions such as V(lambda). |
| 1221 |
+ |
The best results obtain when the spectral range and number |
| 1222 |
+ |
of samples match rendering options, though resampling will handle |
| 1223 |
+ |
any differences, zero-filling wavelenths outside the nmA to nmB |
| 1224 |
+ |
range. |
| 1225 |
+ |
A warning will be issued if the given wavelength range does not |
| 1226 |
+ |
adequately cover the visible spectrum. |
| 1227 |
+ |
.LP |
| 1228 |
+ |
.UL Specfile |
| 1229 |
+ |
.PP |
| 1230 |
+ |
The specfile primitive is equivalent to the spectrum type, but |
| 1231 |
+ |
the wavelength range and values are contained in a 1-dimensional |
| 1232 |
+ |
data file. |
| 1233 |
+ |
This may be a more convenient way to specify a spectral color, |
| 1234 |
+ |
especially one corresponding to a standard illuminant such as D65 |
| 1235 |
+ |
or a library of measured spectra. |
| 1236 |
+ |
.DS |
| 1237 |
+ |
mod specfile id |
| 1238 |
+ |
1 datafile |
| 1239 |
+ |
0 |
| 1240 |
+ |
0 |
| 1241 |
+ |
.DE |
| 1242 |
+ |
As with the spectrum type, rendering wavelengths outside the defined |
| 1243 |
+ |
range will be zero-filled. |
| 1244 |
+ |
Unlike the spectrum type, the file may contain non-uniform samples. |
| 1245 |
+ |
.LP |
| 1246 |
+ |
.UL Specfunc |
| 1247 |
+ |
.PP |
| 1248 |
+ |
The specfunc primitive offers dynamic control over a spectral |
| 1249 |
+ |
pattern, similar to the colorfunc type. |
| 1250 |
+ |
.DS |
| 1251 |
+ |
mod specfunc id |
| 1252 |
+ |
2+ sval funcfile transform |
| 1253 |
+ |
0 |
| 1254 |
+ |
2+ nmA nmB A3 .. |
| 1255 |
+ |
.DE |
| 1256 |
+ |
Like the spectrum primitive, the wavelength range is specified |
| 1257 |
+ |
in the first two real arguments, and additional real values are |
| 1258 |
+ |
set in the evaluation context. |
| 1259 |
+ |
This function is fed a wavelenth sample |
| 1260 |
+ |
between nmA and nmB as its only argument, |
| 1261 |
+ |
and it returns the corresponding spectral intensity. |
| 1262 |
|
.NH 3 |
| 1263 |
|
Mixtures |
| 1264 |
|
.PP |
