--- ray/doc/ray.html 2014/07/31 18:32:41 1.19
+++ ray/doc/ray.html 2023/12/12 20:25:22 1.37
@@ -1,7 +1,8 @@
+
-The RADIANCE 4.2 Synthetic Imaging System
+The RADIANCE 6.0 Synthetic Imaging System
@@ -9,7 +10,7 @@ The RADIANCE 4.2 Synthetic Imaging System
-The RADIANCE 4.2 Synthetic Imaging System
+The RADIANCE 6.0 Synthetic Imaging System
@@ -82,7 +83,7 @@ The diagram in Figure 1 shows the flow between program
(ovals).
The central program is rpict, which produces a picture from a scene
description.
-Rview is a variation of rpict that computes and displays images
+Rvu is a variation of rpict that computes and displays images
interactively, and rtrace computes single ray values.
Other programs (not shown) connect many of these elements together,
such as the executive programs
@@ -797,7 +798,8 @@ unless the line integrals consider enclosed geometry.
Trans2 is the anisotropic version of trans.
- The string arguments are the same as for plastic2, and the real arguments are the same as for trans but with an additional roughness value.
+ The string arguments are the same as for plastic2,
+ and the real arguments are the same as for trans but with an additional roughness value.
mod trans2 id
@@ -809,6 +811,29 @@ unless the line integrals consider enclosed geometry.
+
+ Ashik2
+
+
+
+ Ashik2 is the anisotropic reflectance model by Ashikhmin & Shirley.
+ The string arguments are the same as for plastic2, but the real
+ arguments have additional flexibility to specify the specular color.
+ Also, rather than roughness, specular power is used, which has no
+ physical meaning other than larger numbers are equivalent to a smoother
+ surface.
+ Unlike other material types, total reflectance is the sum of
+ diffuse and specular colors, and should be adjusted accordingly.
+
+ mod ashik2 id
+ 4+ ux uy uz funcfile transform
+ 0
+ 8 dred dgrn dblu sred sgrn sblu u-power v-power
+
+
+
+
+
Dielectric
@@ -1131,6 +1156,38 @@ unless the line integrals consider enclosed geometry.
+
+ aBSDF
+
+
+
+ The aBSDF material is identical to the BSDF type with two
+ important differences. First, proxy geometry is not
+ supported, so there is no thickness parameter. Second, an
+ aBSDF is assumed to have some specular through component
+ (the ’a’ stands for "aperture"),
+ which is treated specially during the direct calculation
+ and when viewing the material. Based on the BSDF data, the
+ coefficient of specular transmission is determined and used
+ for modifying unscattered shadow and view rays.
+
+
+ mod aBSDF id
+ 5+ BSDFfile ux uy uz funcfile transform
+ 0
+ 0|3|6|9
+ rfdif gfdif bfdif
+ rbdif gbdif bbdif
+ rtdif gtdif btdif
+
+
+
+ If a material has no specular transmitted component, it is
+ much better to use the BSDF type with a zero thickness
+ than to use aBSDF.
+
+
+
Antimatter
@@ -1404,6 +1461,98 @@ or:
A section of text meant to depict a picture, perhaps using a special purpose font such as hexbit4x1.fnt, calls for uniform spacing.
Reasonable magnitudes for proportional spacing are between 0.1 (for tightly spaced characters) and 0.3 (for wide spacing).
+
+
+
+
+ Spectrum
+
+
+
+ The spectrum primitive is the most basic type for introducing spectral
+ color to a material.
+ Since materials only provide RGB parameters, spectral patterns
+ are the only way to superimpose wavelength-dependent behavior.
+
+
+ mod spectrum id
+ 0
+ 0
+ 5+ nmA nmB s1 s2 .. sN
+
+
+
+ The first two real arguments indicate the extrema of the
+ spectral range in nanometers.
+ Subsequent real values correspond to multipliers at each wavelength.
+ The nmA wavelength may be greater or less than nmB,
+ but they may not be equal, and their ordering matches
+ the order of the spectral values.
+ A minimum of 3 values must be given, which would act
+ more or less the same as a constant RGB multiplier.
+ As with RGB values, spectral quantities normally range between 0
+ and 1 at each wavelength, or average to 1.0 against a standard
+ sensitivity functions such as V(lambda).
+ The best results obtain when the spectral range and number
+ of samples match rendering options, though resampling will handle
+ any differences, zero-filling wavelenths outside the nmA to nmB
+ range.
+ A warning will be issued if the given wavelength range does not
+ adequately cover the visible spectrum.
+
+
+
+
+
+ Specfile
+
+
+
+ The specfile primitive is equivalent to the spectrum type, but
+ the wavelength range and values are contained in a 1-dimensional
+ data file.
+ This may be a more convenient way to specify a spectral color,
+ especially one corresponding to a standard illuminant such as D65
+ or a library of measured spectra.
+
+
+ mod specfile id
+ 1 datafile
+ 0
+ 0
+
+
+
+ As with the spectrum type, rendering wavelengths outside the defined
+ range will be zero-filled.
+ Unlike the spectrum type, the file may contain non-uniform samples.
+
+
+
+
+
+ Specfunc
+
+
+
+ The specfunc primitive offers dynamic control over a spectral
+ pattern, similar to the colorfunc type.
+
+
+ mod specfunc id
+ 2+ sfunc funcfile transform
+ 0
+ 2+ nmA nmB A3 ..
+
+
+
+ Like the spectrum primitive, the wavelength range is specified
+ in the first two real arguments, and additional real values are
+ set in the evaluation context.
+ This function is fed a wavelenth sample
+ between nmA and nmB as its only argument,
+ and it returns the corresponding spectral intensity.
+
@@ -1414,6 +1563,7 @@ or:
A mixture is a blend of one or more materials or textures and patterns.
+Blended materials should not be light source types or virtual source types.
The basic types are given below.
@@ -1486,7 +1636,6 @@ A mixfunc mixes two modifiers procedurally. It i
arguments, the red, green and blue values
corresponding to the pixel at (u,v).
-
@@ -1752,7 +1901,7 @@ The details of this process are not important, but
directs the use of a scene description.
-
-Rview is ray-tracing program for viewing a scene interactively.
+Rvu is ray-tracing program for viewing a scene interactively.
When the user specifies a new perspective, rvu quickly displays a rough image on the terminal,
then progressively increases the resolution as the user looks on.
He can select a particular section of the image to improve, or move to a different view and start over.
@@ -1788,7 +1937,7 @@ Pictures may be displayed directly under X11 using the
or converted a standard image format using one of the following
translators:
- - Ra_bmp
+
- Ra_bmp
converts to and from BMP image format.
- Ra_ppm
converts to and from Poskanzer Portable Pixmap formats.
@@ -1817,7 +1966,7 @@ or converted a standard image format using one of the
The Radiance Software License, Version 1.0
-Copyright (c) 1990 - 2014 The Regents of the University of California,
+Copyright (c) 1990 - 2021 The Regents of the University of California,
through Lawrence Berkeley National Laboratory. All rights reserved.
Redistribution and use in source and binary forms, with or without
@@ -1890,6 +2039,39 @@ Ecole Polytechnique Federale de Lausanne (EPFL Unive
+ - Ward, Gregory J., Bruno Bueno, David Geisler-Moroder,
+ Lars O. Grobe, Jacob C. Jonsson, Eleanor
+ S. Lee, Taoning Wang, Helen Rose Wilson,
+ "Daylight
+ Simulation Workflows Incorporating Measured Bidirectional
+ Scattering Distribution Functions"
+ Energy & Buildings, Vol. 259, No. 11890, 2022.
+
- Wang, Taoning, Gregory Ward, Eleanor Lee,
+ "Efficient
+ modeling of optically-complex, non-coplanar exterior shading:
+ Validation of matrix algebraic methods"
+ Energy & Buildings, vol. 174, pp. 464-83, Sept. 2018.
+
- Lee, Eleanor S., David Geisler-Moroder, Gregory Ward,
+ "Modeling
+ the direct sun component in buildings using matrix
+ algebraic approaches: Methods and
+ validation," Solar Energy,
+ vol. 160, 15 January 2018, pp 380-395.
+
- Narain, Rahul, Rachel A. Albert, Abdullah Bulbul,
+ Gregory J. Ward, Marty Banks, James F. O'Brien,
+ "Optimal
+ Presentation of Imagery with Focus
+ Cues on Multi-Plane Displays,"
+ SIGGRAPH 2015.
+
- Ward, Greg, Murat Kurt, and Nicolas Bonneel,
+ "Reducing
+ Anisotropic BSDF Measurement to Common Practice,"
+ Workshop on Material Appearance Modeling, 2014.
+
- Banks, Martin, Abdullah Bulbul, Rachel Albert, Rahul Narain,
+ James F. O'Brien, Gregory Ward,
+ "The
+ Perception of Surface Material from Disparity and Focus Cues,"
+ VSS 2014.
- McNeil, A., C.J. Jonsson, D. Appelfeld, G. Ward, E.S. Lee,
"
A validation of a ray-tracing tool used to generate