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.25 by greg, Thu Oct 27 00:51:29 2011 UTC vs.
Revision 1.45 by greg, Tue Dec 12 20:25:22 2023 UTC

# Line 1 | Line 1
1 < .\" RCSid "$Id"
1 > .\" RCSid "$Id$"
2   .\" Print using the -ms macro package
3 < .DA 10/26/2011
3 > .DA 11/13/2023
4   .LP
5 < .tl """Copyright \(co 2011 Regents, University of California
5 > .tl """Copyright \(co 2023 Regents, University of California
6   .sp 2
7   .TL
8   The
# Line 622 | Line 622 | mod trans2 id
622   8 red green blue spec urough vrough trans tspec
623   .DE
624   .LP
625 + .UL Ashik2
626 + .PP
627 + Ashik2 is the anisotropic reflectance model by Ashikhmin & Shirley.
628 + The string arguments are the same as for plastic2, but the real
629 + arguments have additional flexibility to specify the specular color.
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
638 + 0
639 + 8 dred dgrn dblu sred sgrn sblu u-power v-power
640 + .DE
641 + .LP
642   .UL Dielectric
643   .PP
644   A dielectric material is transparent, and it refracts light
# Line 932 | 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 aBSDF
953 + .PP
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 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 aBSDF id
965 + 5+ BSDFfile ux uy uz funcfile transform
966 + 0
967 + 0|3|6|9
968 +     rfdif gfdif bfdif
969 +     rbdif gbdif bbdif
970 +     rtdif gtdif btdif
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 aBSDF.
975 + .LP
976   .UL Antimatter
977   .PP
978   Antimatter is a material that can "subtract" volumes from other volumes.
# Line 946 | Line 987 | N mod1 mod2 .. modN
987   The first modifier will also be used to shade the area leaving the
988   antimatter volume and entering the regular volume.
989   If mod1 is void, the antimatter volume is completely invisible.
990 < Antimatter does not work properly with the material type "trans",
991 < and multiple antimatter surfaces should be disjoint.
990 > If shading is desired at antimatter surfaces, it is important
991 > that the related volumes are closed with outward-facing normals.
992 > Antimatter surfaces should not intersect with other antimatter boundaries,
993 > and it is unwise to use the same modifier in nested antimatter volumes.
994   The viewpoint must be outside all volumes concerned for a correct
995   rendering.
996   .NH 3
# Line 1151 | 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 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+ sfunc 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
1265   A mixture is a blend of one or more materials or textures and patterns.
1266 + Blended materials should not be light source types or virtual source types.
1267   The basic types are given below.
1268   .LP
1269   .UL Mixfunc
# Line 1551 | Line 1660 | the Ecole Polytechnique Federale de Lausanne (EPFL Uni
1660   in Lausanne, Switzerland.
1661   .NH 1
1662   References
1663 + .LP
1664 + Ward, Gregory J., Bruno Bueno, David Geisler-Moroder,
1665 + Lars O. Grobe, Jacob C. Jonsson, Eleanor
1666 + S. Lee, Taoning Wang, Helen Rose Wilson,
1667 + ``Daylight Simulation Workflows Incorporating
1668 + Measured Bidirectional Scattering Distribution Functions,''
1669 + .I "Energy & Buildings",
1670 + Vol. 259, No. 111890, 2022.
1671 + .LP
1672 + Wang, Taoning, Gregory Ward, Eleanor Lee,
1673 + ``Efficient modeling of optically-complex, non-coplanar
1674 + exterior shading: Validation of matrix algebraic methods,''
1675 + .I "Energy & Buildings",
1676 + vol. 174, pp. 464-83, Sept. 2018.
1677 + .LP
1678 + Lee, Eleanor S., David Geisler-Moroder, Gregory Ward,
1679 + ``Modeling the direct sun component in buildings using matrix
1680 + algebraic approaches: Methods and validation,''
1681 + .I Solar Energy,
1682 + vol. 160, 15 January 2018, pp 380-395.
1683 + .LP
1684 + Ward, G., M. Kurt & N. Bonneel,
1685 + ``Reducing Anisotropic BSDF Measurement to Common Practice,''
1686 + .I Workshop on Material Appearance Modeling,
1687 + 2014.
1688 + .LP
1689 + McNeil, A., C.J. Jonsson, D. Appelfeld, G. Ward, E.S. Lee,
1690 + ``A validation of a ray-tracing tool used to generate
1691 + bi-directional scattering distribution functions for
1692 + complex fenestration systems,''
1693 + .I "Solar Energy",
1694 + 98, 404-14, November 2013.
1695   .LP
1696   Ward, G., R. Mistrick, E.S. Lee, A. McNeil, J. Jonsson,
1697   ``Simulating the Daylight Performance of Complex Fenestration Systems

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines