[ViewVC] Diff of: radiance/doc/ray.html

Comparing doc/ray.html (file contents):
Revision 1.26 by greg, Tue Jun 26 14:42:18 2018 UTC vs.
Revision 1.39 by greg, Mon Dec 9 19:21:38 2024 UTC

+<!-- RCSid $Id$ -->
+<head>
+<title>
-<
+The RADIANCE 5.2 Synthetic Imaging System
->
+The RADIANCE 6.0 Synthetic Imaging System
+</title>
+</head>
+<body>
+<p>
+<h1>
-<
+The RADIANCE 5.2 Synthetic Imaging System
->
+The RADIANCE 6.0 Synthetic Imaging System
+</h1>
+<p>
+(ovals).
+The central program is <i>rpict</i>, which produces a picture from a scene
+description.
-<
+<i>Rview</i> is a  variation  of  rpict  that  computes  and displays images
->
+<i>Rvu</i> 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
+        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.
+<pre>
+        mod ashik2 id
++ ux uy uz funcfile transform
+<p>
+<dt>
-+
+        <a NAME="WGMDfunc">
-+
+        <b>WGMDfunc</b>
-+
+        </a>
-+
-+
+<dd>
-+
+        WGMDfunc is a more programmable version of <a HREF="#Trans2">trans2</a>,
-+
+        with separate modifier paths and variables to control each component.
-+
+        (WGMD stands for Ward-Geisler-Moroder-Duer, which is the basis for
-+
+        this empirical model, similar to previous ones beside Ashik2.)
-+
+        The specification of this material is given below.
-+
+<pre>
-+
+        mod WGMDfunc id
-+
++ rs_mod  rs  rs_urough rs_vrough
-+
+            ts_mod  ts  ts_urough ts_vrough
-+
+            td_mod
-+
+            ux uy uz  funcfile  transform
-+
-+
++  rfdif gfdif bfdif
-+
+            rbdif gbdif bbdif
-+
+            rtdif gtdif btdif
-+
+            A10 ..
-+
+</pre>
-+
-+
+The sum of specular reflectance (<I>rs</I>), specular transmittance (<I>ts</I>),
-+
+diffuse reflectance (<I>rfdif gfdif bfdif</I> for front and <I>rbdif gbdif bbdif</I> for back)
-+
+and diffuse transmittance (<I>rtdif gtdif btdif</I>) should be less than 1 for each
-+
+channel.
-+
-+
+<p>
-+
-+
+Unique to this material, separate modifier channels are
-+
+provided for each component.
-+
+The main modifier is used on the diffuse reflectance, both
-+
+front and back.
-+
+The <I>rs_mod</I> modifier is used for specular reflectance.
-+
+If "void" is given for <I>rs_mod</I>,
-+
+then the specular reflection color will be white.
-+
+The special "inherit" keyword may also be given, in which case
-+
+specular reflectance will share the main modifier.
-+
+This behavior is replicated for the specular transmittance modifier
-+
+<I>ts_mod</I>, which also has its own independent roughness expressions.
-+
+Finally, the diffuse transmittance modifier is given as
-+
+<I>td_mod</I>, which may also be "void" or "inherit".
-+
+Note that any spectra or color for specular components must be
-+
+carried by the named modifier(s).
-+
-+
+<p>
-+
-+
+The main advantage to this material over
-+
+<a HREF="#BRTDfunc">BRTDfunc</a> and
-+
+other programmable types described below is that the specular sampling is
-+
+well-defined, so that all components are fully computed.
-+
-+
+<p>
-+
-+
+<dt>
+        <a NAME="Dielectric">
+        <b>Dielectric</b>
+        </a>
+        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).
-+
+<p>
-+
-+
+<dt>
-+
+        <a NAME="Spectrum">
-+
+        <b>Spectrum</b>
-+
+        </a>
-+
-+
+<dd>
-+
+        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.
-+
-+
+<pre>
-+
+        mod spectrum id
-+
-+
-+
++ nmA nmB s1 s2 .. sN
-+
+</pre>
-+
-+
+<p>
-+
+        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.
-+
-+
+<p>
-+
-+
+<dt>
-+
+        <a NAME="Specfile">
-+
+        <b>Specfile</b>
-+
+        </a>
-+
-+
+<dd>
-+
+        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.
-+
-+
+<pre>
-+
+        mod specfile id
-+
+datafile
-+
-+
-+
+</pre>
-+
-+
+<p>
-+
+        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.
-+
-+
+<p>
-+
-+
+<dt>
-+
+        <a NAME="Specfunc">
-+
+        <b>Specfunc</b>
-+
+        </a>
-+
-+
+<dd>
-+
+        The specfunc primitive offers dynamic control over a spectral
-+
+        pattern, similar to the colorfunc type.
-+
-+
+<pre>
-+
+        mod specfunc id
-+
++ sfunc funcfile transform
-+
-+
++ nmA nmB A3 ..
-+
+</pre>
-+
-+
+<p>
-+
+        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.
-+
-+
+<dt>
-+
+       <a NAME="Specdata">
-+
+       <b>Specdata</b>
-+
+       </a>
-+
-+
+<dd>
-+
+        Specdata is like brightdata and colordata, but with more
-+
+        than 3 specular samples.
-+
-+
+<pre>
-+
+        mod specdata id
-+
++n+
-+
+                func datafile
-+
+                funcfile x1 x2 .. xn transform
-+
-+
+        m A1 A2 .. Am
-+
+</pre>
-+
-+
+<p>
-+
+        The data file must have one more dimension than the coordinate
-+
+        variable count, as this final dimension corresponds to the covered
-+
+        spectrum.
-+
+        The starting and ending wavelengths are specified in "datafile"
-+
+        as well as the number of spectral samples.
-+
+        The function "func" will be called with two parameters, the
-+
+        interpolated spectral value for the current coordinate and the
-+
+        associated wavelength.
-+
+        If the spectrum is broken into 12 components, then 12 calls
-+
+        will be made to "func" for the relevant ray evaluation.
-+
-+
+<dt>
-+
+       <a NAME="Specpict">
-+
+       <b>Specpict</b>
-+
+       </a>
-+
-+
+<dd>
-+
+        Specpict is a special case of specdata, where the pattern is
-+
+        a hyperspectral image stored in the common-exponent file format.
-+
+        The dimensions of the image data are determined by the picture
-+
+        just as with the colorpict primitive.
-+
-+
+<pre>
-+
+        mod specpict id
 +
-+
+                func specfile
-+
+                funcfile u v transform
-+
-+
+        m A1 A2 .. Am
-+
+</pre>
-+
-+
+<p>
-+
+        The function "func" is called with the interpolated pixel value
-+
+        and the wavelength sample in nanometers, the same as specdata,
-+
+        with as many calls made as there are components in "specfile".
-+
+</dl>
+<p>
+directs the use of a scene description.
+<ul>
+<li>
-<
+<a NAME="rvu" HREF="../man_html/rvu.1.html"><b>Rview</b></a>  is  ray-tracing  program  for  viewing  a  scene interactively.
->
+<a NAME="rvu" HREF="../man_html/rvu.1.html"><b>Rvu</b></a>  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.
+or converted a standard image format using one of the following
+<b>translators</b>:
+        <ul>
-<
+        <li> <a HREF="../man_html/ra_bmp.1.html"><b>Ra_bmp</b>
->
+        <li> <a HREF="../man_html/ra_bmp.1.html"><b>Ra_bmp</b></a>
+                converts to and from BMP image format.
+        <li> <a HREF="../man_html/ra_ppm.1.html"><b>Ra_ppm</b></a>
+                converts to and from Poskanzer Portable Pixmap formats.
+<pre>
+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
+</h2>
+<p>
+<ul>
-+
+    <li>Ward, Gregory J., Bruno Bueno, David Geisler-Moroder,
-+
+      Lars O. Grobe, Jacob C. Jonsson, Eleanor
-+
+      S. Lee, Taoning Wang, Helen Rose Wilson,
-+
+      &quot;<a href="https://doi.org/10.1016/j.enbuild.2022.111890">Daylight
-+
+      Simulation Workflows Incorporating Measured Bidirectional
-+
+      Scattering Distribution Functions</a>&quot;
-+
+      <em>Energy &amp; Buildings</em>, Vol. 259, No. 11890, 2022.
-+
+    <li>Wang, Taoning, Gregory Ward, Eleanor Lee,
-+
+      &quot;<a href="https://authors.elsevier.com/a/1XQ0a1M7zGwT7v">Efficient
-+
+      modeling of optically-complex, non-coplanar exterior shading:
-+
+      Validation of matrix algebraic methods</a>&quot;
-+
+      <em>Energy & Buildings</em>, vol. 174, pp. 464-83, Sept. 2018.
-+
+    <li>Lee, Eleanor S., David Geisler-Moroder, Gregory Ward,
-+
+      &quot;<a href="https://eta.lbl.gov/sites/default/files/publications/solar_energy.pdf">Modeling
-+
+      the direct sun component in buildings using matrix
-+
+      algebraic approaches: Methods and
-+
+      validation</a>,&quot; <em>Solar Energy</em>,
-+
+      vol. 160, 15 January 2018, pp 380-395.
-+
+    <li>Narain, Rahul, Rachel A. Albert, Abdullah Bulbul,
-+
+       Gregory J. Ward, Marty Banks, James F. O'Brien,
-+
+       &quot;<a href="http://graphics.berkeley.edu/papers/Narain-OPI-2015-08/index.html">Optimal
-+
+       Presentation of Imagery with Focus
-+
+       Cues on Multi-Plane Displays</a>,&quot;
-+
+       <em>SIGGRAPH 2015</em>.
-+
+    <li>Ward, Greg, Murat Kurt, and Nicolas Bonneel,
-+
+        &quot;<a href="papers/WMAM14_Tensor_Tree_Representation.pdf">Reducing
-+
+        Anisotropic BSDF Measurement to Common Practice</a>,&quot;
-+
+        <em>Workshop on Material Appearance Modeling</em>, 2014.
-+
+    <li>Banks, Martin, Abdullah Bulbul, Rachel Albert, Rahul Narain,
-+
+        James F. O'Brien, Gregory Ward,
-+
+        &quot;<a href="http://graphics.berkeley.edu/papers/Banks-TPO-2014-05/index.html">The
-+
+        Perception of Surface Material from Disparity and Focus Cues</a>,&quot;
-+
+        <em>VSS 2014</em>.
+    <li>McNeil, A., C.J. Jonsson, D. Appelfeld, G. Ward, E.S. Lee,
+        &quot;<a href="http://gaia.lbl.gov/btech/papers/4414.pdf">
+        A validation of a ray-tracing tool used to generate

Diff Legend

-–
+Removed lines
-+
+Added lines
-<
+Changed lines
->
+Changed lines

Comparing doc/ray.html (file contents): Revision 1.26 by greg, Tue Jun 26 14:42:18 2018 UTC vs. Revision 1.39 by greg, Mon Dec 9 19:21:38 2024 UTC

Diff Legend

Comparing doc/ray.html (file contents):
Revision 1.26 by greg, Tue Jun 26 14:42:18 2018 UTC vs.
Revision 1.39 by greg, Mon Dec 9 19:21:38 2024 UTC