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.16 by greg, Fri Mar 12 18:43:30 2010 UTC vs.
Revision 1.30 by greg, Sun Jul 10 23:41:37 2016 UTC

# Line 1 | Line 1
1 < .\" RCSid "$Id"
1 > .\" RCSid "$Id$"
2   .\" Print using the -ms macro package
3 < .DA 3/12/2010
3 > .DA 07/10/2016
4   .LP
5 < .tl """Copyright \(co 2010 Regents, University of California
5 > .tl """Copyright \(co 2016 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 + .DS
634 + mod ashik2 id
635 + 4+ ux uy uz funcfile transform
636 + 0
637 + 8 dred dgrn dblu sred sgrn sblu u-power v-power
638 + .DE
639 + .LP
640   .UL Dielectric
641   .PP
642   A dielectric material is transparent, and it refracts light
# Line 865 | Line 880 | mod transdata id
880   6+ red green blue rspec trans tspec A7 ..
881   .DE
882   .LP
883 + .UL BSDF
884 + .PP
885 + The BSDF material type loads an XML (eXtensible Markup Language)
886 + file describing a bidirectional scattering distribution function.
887 + Real arguments to this material may define additional
888 + diffuse components that augment the BSDF data.
889 + String arguments are used to define thickness for proxied
890 + surfaces and the "up" orientation for the material.
891 + .DS
892 + mod BSDF id
893 + 6+ thick BSDFfile ux uy uz funcfile transform
894 + 0
895 + 0|3|6|9
896 +     rfdif gfdif bfdif
897 +     rbdif gbdif bbdif
898 +     rtdif gtdif btdif
899 + .DE
900 + The first string argument is a "thickness" parameter that may be used
901 + to hide detail geometry being proxied by an aggregate BSDF material.
902 + If a view or shadow ray hits a BSDF proxy with non-zero thickness,
903 + it will pass directly through as if the surface were not there.
904 + Similar to the illum type, this permits direct viewing and
905 + shadow testing of complex geometry.
906 + The BSDF is used when a scattered (indirect) ray hits the surface,
907 + and any transmitted sample rays will be offset by the thickness amount
908 + to avoid the hidden geometry and gather samples from the other side.
909 + In this manner, BSDF surfaces can improve the results for indirect
910 + scattering from complex systems without sacrificing appearance or
911 + shadow accuracy.
912 + If the BSDF has transmission and back-side reflection data,
913 + a parallel BSDF surface may be
914 + placed slightly less than the given thickness away from the front surface
915 + to enclose the complex geometry on both sides.
916 + The sign of the thickness is important, as it indicates whether the
917 + proxied geometry is behind the BSDF surface (when thickness is positive)
918 + or in front (when thickness is negative).
919 + .LP
920 + The second string argument is the name of the BSDF file, which is
921 + found in the usual auxiliary locations.
922 + The following three string parameters name variables for an "up" vector,
923 + which together with the surface normal, define the
924 + local coordinate system that orients the BSDF.
925 + These variables, along with the thickness, are defined in a function
926 + file given as the next string argument.
927 + An optional transform is used to scale the thickness and reorient the up vector.
928 + .LP
929 + If no real arguments are given, the BSDF is used by itself to determine
930 + reflection and transmission.
931 + If there are at least 3 real arguments, the first triplet is an
932 + additional diffuse reflectance for the front side.
933 + At least 6 real arguments adds diffuse reflectance to the rear side of the surface.
934 + If there are 9 real arguments, the final triplet will be taken as an additional
935 + diffuse transmittance.
936 + All diffuse components as well as the non-diffuse transmission are
937 + modified by patterns applied to this material.
938 + The non-diffuse reflection from either side are unaffected.
939 + Textures perturb the effective surface normal in the usual way.
940 + .LP
941 + The surface normal of this type is not altered to face the incoming ray,
942 + so the front and back BSDF reflections may differ.
943 + (Transmission is identical front-to-back by physical law.)\0
944 + If back visibility is turned off during rendering and there is no
945 + transmission or back-side reflection, only then the surface will be
946 + invisible from behind.
947 + Unlike other data-driven material types, the BSDF type is fully
948 + supported and all parts of the distribution are properly sampled.
949 + .LP
950   .UL Antimatter
951   .PP
952   Antimatter is a material that can "subtract" volumes from other volumes.
# Line 1088 | Line 1170 | between 0.1 (for tightly spaced characters) and 0.3 (f
1170   Mixtures
1171   .PP
1172   A mixture is a blend of one or more materials or textures and patterns.
1173 + Blended materials should not be light source types or virtual source types.
1174   The basic types are given below.
1175   .LP
1176   .UL Mixfunc
# Line 1400 | Line 1483 | converts a picture to and from simpler formats.
1483   Pictures may be displayed directly under X11 using the program
1484   .I ximage,
1485   or converted a standard image format.
1486 < .I Ra_avs
1487 < converts to and from AVS image format.
1405 < .I Ra_pict
1406 < converts to Macintosh 32-bit PICT2 format.
1486 > .I Ra_bmp
1487 > converts to and from Microsoft Bitmap images.
1488   .I Ra_ppm
1489   converts to and from Poskanzer Portable Pixmap formats.
1409 .I Ra_pr
1410 converts to and from Sun 8-bit rasterfile format.
1411 .I Ra_pr24
1412 converts to and from Sun 24-bit rasterfile format.
1490   .I Ra_ps
1491   converts to PostScript color and greyscale formats.
1492   .I Ra_rgbe
# Line 1490 | Line 1567 | the Ecole Polytechnique Federale de Lausanne (EPFL Uni
1567   in Lausanne, Switzerland.
1568   .NH 1
1569   References
1570 + .LP
1571 + Ward, G., M. Kurt & N. Bonneel,
1572 + ``Reducing Anisotropic BSDF Measurement to Common Practice,''
1573 + .I Workshop on Material Appearance Modeling,
1574 + 2014.
1575 + .LP
1576 + McNeil, A., C.J. Jonsson, D. Appelfeld, G. Ward, E.S. Lee,
1577 + ``A validation of a ray-tracing tool used to generate
1578 + bi-directional scattering distribution functions for
1579 + complex fenestration systems,''
1580 + .I "Solar Energy",
1581 + 98, 404-14, November 2013.
1582 + .LP
1583 + Ward, G., R. Mistrick, E.S. Lee, A. McNeil, J. Jonsson,
1584 + ``Simulating the Daylight Performance of Complex Fenestration Systems
1585 + Using Bidirectional Scattering Distribution Functions within Radiance,''
1586 + .I "Leukos",
1587 + 7(4),
1588 + April 2011.
1589   .LP
1590   Cater, K., A. Chalmers, G. Ward,
1591   ``Detail to Attention: Exploiting Visual Tasks for Selective Rendering,''

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines