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.17 by greg, Fri Mar 12 19:57:58 2010 UTC vs.
Revision 1.18 by greg, Fri Feb 18 00:40:25 2011 UTC

# Line 1 | Line 1
1   .\" RCSid "$Id"
2   .\" Print using the -ms macro package
3 < .DA 3/12/2010
3 > .DA 2/17/2011
4   .LP
5 < .tl """Copyright \(co 2010 Regents, University of California
5 > .tl """Copyright \(co 2011 Regents, University of California
6   .sp 2
7   .TL
8   The
# Line 864 | Line 864 | mod transdata id
864   0
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 +
873 + Real arguments to this material may define additional
874 + diffuse components that augment the BSDF data.
875 + String arguments are used to define thickness for hidden
876 + objects and the "up" orientation for the material.
877 + .DS
878 + mod BSDF id
879 + 6+ thick BSDFfile ux uy uz funcfile transform
880 + 0
881 + 0|3|6|9
882 +     rfdif gfdif bfdif
883 +     rbdif gbdif bbdif
884 +     rtdif gtdif btdif
885 + .DE
886 + The first string argument is a "thickness" parameter that is useful
887 + for hiding detail geometry for transmitting systems, e.g.,
888 + complex fenestration.
889 + If a view or shadow ray hits a BSDF surface with non-zero specular transmission
890 + and positive thickness, the ray will pass directly through with no
891 + reflection or transmission due to the BSDF.
892 + Similar to the illum type, this permits direct viewing and
893 + shadow testing of complex geometry.
894 + In contrast, a scattered ray will use the BSDF transmission,
895 + offsetting transmitted sample rays by the thickness amount
896 + to avoid any intervening geometry.
897 + In this manner, BSDF surfaces may act as simplified stand-ins for detailed
898 + system geometry, which may still be present and visible in the simulation.
899 + If the BSDF has back-side reflection data, a parallel surface should be
900 + specified slightly less than the given thickness away from the front surface
901 + to enclose the system geometry on both sides.
902 + A zero thickness implies that the BSDF geomtery is all there is, and
903 + thickness is ignored if there is no transmitted component, or transmission is
904 + purely diffuse.
905 + .LP
906 + The second string argument is the name of the BSDF file, which is
907 + found in the usual auxiliary locations.
908 + The following three string parameters name variables for an "up" vector,
909 + which together with the surface normal, define the
910 + local coordinate system that orients the BSDF.
911 + These variables, along with the thickness, are defined in a function
912 + file given as the next string argument.
913 + An optional transform is used to scale the thickness and reorient the up vector.
914 + .LP
915 + If no real arguments are given, the BSDF is used by itself to determine
916 + reflection and transmission.
917 + If there are at least 3 real arguments, the first triplet is an
918 + additional diffuse reflectance for the front side.
919 + At least 6 real arguments adds diffuse reflectance to the rear side of the surface.
920 + If there are 9 real arguments, the final triplet will be taken as an additional
921 + diffuse transmittance.
922 + All diffuse components as well as the non-diffuse transmission are
923 + modified by patterns applied to this material.
924 + The non-diffuse reflection from either side are unaffected.
925 + Textures perturb the effective surface normal in the usual way.
926 + .LP
927 + The surface normal of this type is not altered to face the incoming ray,
928 + so the front and back BSDF reflections may differ.
929 + (Transmission is identical front-to-back by physical law.)\0
930 + If back visibility is turned off during rendering and there is no
931 + transmission or back-side reflection, only then the surface will be
932 + invisible from behind.
933 + Unlike other data-driven material types, the BSDF type is fully
934 + supported and all parts of the distribution are properly sampled.
935   .LP
936   .UL Antimatter
937   .PP

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines