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.26 by greg, Thu Jul 31 18:32:41 2014 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/31/2014
4   .LP
5 < .tl """Copyright \(co 2010 Regents, University of California
5 > .tl """Copyright \(co 2014 Regents, University of California
6   .sp 2
7   .TL
8   The
# Line 865 | Line 865 | mod transdata id
865   6+ red green blue rspec trans tspec A7 ..
866   .DE
867   .LP
868 + .UL BSDF
869 + .PP
870 + The BSDF material type loads an XML (eXtensible Markup Language)
871 + file describing a bidirectional scattering distribution function.
872 + Real arguments to this material may define additional
873 + diffuse components that augment the BSDF data.
874 + String arguments are used to define thickness for proxied
875 + surfaces and the "up" orientation for the material.
876 + .DS
877 + mod BSDF id
878 + 6+ thick BSDFfile ux uy uz funcfile transform
879 + 0
880 + 0|3|6|9
881 +     rfdif gfdif bfdif
882 +     rbdif gbdif bbdif
883 +     rtdif gtdif btdif
884 + .DE
885 + The first string argument is a "thickness" parameter that may be used
886 + to hide detail geometry being proxied by an aggregate BSDF material.
887 + If a view or shadow ray hits a BSDF proxy with non-zero thickness,
888 + it will pass directly through as if the surface were not there.
889 + Similar to the illum type, this permits direct viewing and
890 + shadow testing of complex geometry.
891 + The BSDF is used when a scattered (indirect) ray hits the surface,
892 + and any transmitted sample rays will be offset by the thickness amount
893 + to avoid the hidden geometry and gather samples from the other side.
894 + In this manner, BSDF surfaces can improve the results for indirect
895 + scattering from complex systems without sacrificing appearance or
896 + shadow accuracy.
897 + If the BSDF has transmission and back-side reflection data,
898 + a parallel BSDF surface may be
899 + placed slightly less than the given thickness away from the front surface
900 + to enclose the complex geometry on both sides.
901 + The sign of the thickness is important, as it indicates whether the
902 + proxied geometry is behind the BSDF surface (when thickness is positive)
903 + or in front (when thickness is negative).
904 + .LP
905 + The second string argument is the name of the BSDF file, which is
906 + found in the usual auxiliary locations.
907 + The following three string parameters name variables for an "up" vector,
908 + which together with the surface normal, define the
909 + local coordinate system that orients the BSDF.
910 + These variables, along with the thickness, are defined in a function
911 + file given as the next string argument.
912 + An optional transform is used to scale the thickness and reorient the up vector.
913 + .LP
914 + If no real arguments are given, the BSDF is used by itself to determine
915 + reflection and transmission.
916 + If there are at least 3 real arguments, the first triplet is an
917 + additional diffuse reflectance for the front side.
918 + At least 6 real arguments adds diffuse reflectance to the rear side of the surface.
919 + If there are 9 real arguments, the final triplet will be taken as an additional
920 + diffuse transmittance.
921 + All diffuse components as well as the non-diffuse transmission are
922 + modified by patterns applied to this material.
923 + The non-diffuse reflection from either side are unaffected.
924 + Textures perturb the effective surface normal in the usual way.
925 + .LP
926 + The surface normal of this type is not altered to face the incoming ray,
927 + so the front and back BSDF reflections may differ.
928 + (Transmission is identical front-to-back by physical law.)\0
929 + If back visibility is turned off during rendering and there is no
930 + transmission or back-side reflection, only then the surface will be
931 + invisible from behind.
932 + Unlike other data-driven material types, the BSDF type is fully
933 + supported and all parts of the distribution are properly sampled.
934 + .LP
935   .UL Antimatter
936   .PP
937   Antimatter is a material that can "subtract" volumes from other volumes.
# Line 1400 | Line 1467 | converts a picture to and from simpler formats.
1467   Pictures may be displayed directly under X11 using the program
1468   .I ximage,
1469   or converted a standard image format.
1470 < .I Ra_avs
1471 < converts to and from AVS image format.
1405 < .I Ra_pict
1406 < converts to Macintosh 32-bit PICT2 format.
1470 > .I Ra_bmp
1471 > converts to and from Microsoft Bitmap images.
1472   .I Ra_ppm
1473   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.
1474   .I Ra_ps
1475   converts to PostScript color and greyscale formats.
1476   .I Ra_rgbe
# Line 1490 | Line 1551 | the Ecole Polytechnique Federale de Lausanne (EPFL Uni
1551   in Lausanne, Switzerland.
1552   .NH 1
1553   References
1554 + .LP
1555 + McNeil, A., C.J. Jonsson, D. Appelfeld, G. Ward, E.S. Lee,
1556 + ``A validation of a ray-tracing tool used to generate
1557 + bi-directional scattering distribution functions for
1558 + complex fenestration systems,''
1559 + .I "Solar Energy",
1560 + 98, 404-14, November 2013.
1561 + .LP
1562 + Ward, G., R. Mistrick, E.S. Lee, A. McNeil, J. Jonsson,
1563 + ``Simulating the Daylight Performance of Complex Fenestration Systems
1564 + Using Bidirectional Scattering Distribution Functions within Radiance,''
1565 + .I "Leukos",
1566 + 7(4),
1567 + April 2011.
1568   .LP
1569   Cater, K., A. Chalmers, G. Ward,
1570   ``Detail to Attention: Exploiting Visual Tasks for Selective Rendering,''

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines