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

Comparing ray/doc/ray.html (file contents):
Revision 1.39 by greg, Mon Dec 9 19:21:38 2024 UTC vs.
Revision 1.40 by greg, Fri Dec 13 18:17:17 2024 UTC

+         ...
+</pre>
-+
+<p>
-+
+A comment line begins with a pound sign, `#'.
+<p>
+</pre>
-+
+<p>
+        If the modifier is &quot;void&quot;, then surfaces will
+        use the modifiers  given  in  the  original  description.
+        Otherwise, the modifier specified is used in their  place.
+</pre>
-+
+<p>
-+
+        If the modifier is &quot;void&quot;, then surfaces will
+        use the modifiers  given  in  the  original  mesh description.
+        Otherwise, the modifier specified is used in their  place.
+red green blue maxrad
+</pre>
-+
+<p>
+        If maxrad is zero, then the surface will never be tested for shadow,  although  it  may participate in an interreflection calculation.
+        If maxrad is negative, then the  surface  will never  contribute  to scene illumination.
+        Glow sources will never illuminate objects on the other side of an illum  surface.
+        n A1 A2 .. An
+</pre>
-+
+<p>
-+
+        The new direction variables dx, dy and dz need not produce a normalized  vector.
+        For convenience, the variables DxA, DyA and DzA are defined as the normalized direction to the  target  light  source.
+        See <a HREF="#Function">section 2.2.1</a> on function files for further information.
+ source1  mirror1&gt;source10  mirror2&gt;mirror1&gt;source3
+</pre>
-+
+<p>
+Normally, only one source is given per mist material, and there is an
+upper limit of 32 to the total number of active scattering sources.
+The extinction coefficient, if given, is added the the global
+        P(theta) = (1 - g*g) / (1 + g*g - 2*g*cos(theta))^1.5
+</pre>
-+
+<p>
-+
+A perfectly isotropic scattering medium has a g parameter of 0, and
+a highly directional material has a g parameter close to 1.
+Fits to the g parameter may be found along with typical extinction
+|3|6|7 [ rext gext bext [ ralb galb balb [ g ] ] ]
+</pre>
-+
+<p>
-+
+There are two usual uses of the mist type.
+One is to surround a beam from a spotlight or laser so that it is
+visible during rendering.
+            A10 ..
+</pre>
-+
+<p>
-+
+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
+        tn = (sqrt(.8402528435+.0072522239*Tn*Tn)-.9166530661)/.0036261119/Tn
+</pre>
-+
+<p>
-+
+        Standard 88% transmittance glass  has  a  transmissivity  of 0.96.
+        (A <a HREF="#Patterns">pattern</a> modifying glass will affect the transmissivity.)
+        If a fourth real argument is given,  it  is  interpreted as the index of refraction to use instead of 1.52.
++ red green blue spec A5 ..
+</pre>
-+
+<p>
-+
+        The function refl takes four arguments, the x, y and z
+        direction towards the incident light, and the solid angle
+        subtended by the source.
++ red green blue rspec trans tspec A7 ..
+</pre>
-+
+<p>
-+
+        Where trans is the total light transmitted and tspec is  the non-Lambertian  fraction of transmitted light.
+        The function brtd should integrate to 1 over each projected hemisphere.
+             A10 ..
+</pre>
-+
+<p>
-+
+        The variables rrefl, grefl and brefl specify the color coefficients  for  the ideal specular (mirror) reflection of the surface.
+        The variables rtrns, gtrns and btrns  specify  the color coefficients for the ideal specular transmission.
+        The functions rbrtd, gbrtd and bbrtd take the direction to the incident light (and its solid angle) and
++ red green blue spec A5 ..
+</pre>
-+
+<p>
-+
+        The coordinate indices (x1, x2, etc.) are  themselves  functions  of  the  x,  y and z direction to the incident light, plus the solid angle
+        subtended by the light source (usually ignored).
+        The data function (func) takes five variables, the
+</pre>
-+
+<p>
-+
+        The first modifier will also be used to shade  the  area  leaving the  antimatter  volume and entering the regular volume.
+        If mod1 is void, the antimatter volume is completely invisible.
+        Antimatter  does  not  work  properly with the material type <a HREF="#Trans">&quot;trans&quot;</a>,
+        n A1 A2 .. An
+</pre>
-+
+<p>
-+
+</dl>
+<p>
+                [spacing]
+</pre>
-+
+<p>
-+
+or:
+<pre>
+                [spacing]
+</pre>
-+
+<p>
-+
+or:
+<pre>
+        n A1 A2 .. An
+</pre>
-+
+<p>
-+
+        Foreground and background are modifier names that must be
+        defined earlier in the scene description.
+        If one of these is a material, then
+        m A1 A2 .. Am
+</pre>
-+
+<p>
-+
+<dt>
+        <a NAME="Mixpict">
+        <b>Mixpict</b>
+                [spacing]
+</pre>
-+
+<p>
-+
+or:
+<pre>
+                [spacing]
+</pre>
-+
+<p>
-+
+</dl>
+<p>
+        cfunc(x) : 10*x / sqrt(x) ;
+</pre>
-+
+<p>
-+
+Many variables and functions are already defined by the program, and they are listed in the file rayinit.cal.
+The following variables are particularly important:
+                arg(i)                  - i'th real argument
+</pre>
-+
+<p>
-+
+For mesh objects, the local surface coordinates are available:
+<pre>
+                Lu, Lv                  - local (u,v) coordinates
+</pre>
-+
+<p>
-+
+For BRDF types, the following variables are defined as well:
+<pre>
+                CrP, CgP, CbP           - perturbed material color
+</pre>
-+
+<p>
-+
+A unique context is set up for each file so
+that  the  same variable may appear in different
+function files without conflict.
+        DATA, later dimensions changing faster.
+</pre>
-+
+<p>
-+
+N is the number of  dimensions.
+For  each  dimension,  the beginning  and  ending  coordinate  values and the dimension size is given.
+Alternatively, individual coordinate  values can  be  given when the points are not evenly spaced.
+         ...
+</pre>
-+
+<p>
-+
+The ASCII codes can appear in any order.  N is the number of vertices,  and  the  last  is automatically connected to the first.
+Separate polygonal sections are joined by coincident sides.
+The  character  coordinate  system is a square with lower left corner at (0,0), lower right at (255,0) and upper right at (255,255).
+OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGE.
+</pre>
-+
-+
+<p>
+<hr>

Diff Legend

-–
+Removed lines
-+
+Added lines
-<
+Changed lines (old)
->
+Changed lines (new)

Comparing ray/doc/ray.html (file contents): Revision 1.39 by greg, Mon Dec 9 19:21:38 2024 UTC vs. Revision 1.40 by greg, Fri Dec 13 18:17:17 2024 UTC

Diff Legend

Comparing ray/doc/ray.html (file contents):
Revision 1.39 by greg, Mon Dec 9 19:21:38 2024 UTC vs.
Revision 1.40 by greg, Fri Dec 13 18:17:17 2024 UTC