ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/doc/man/man1/pkgBSDF.1
Revision: 1.1
Committed: Thu Jun 23 18:11:17 2011 UTC (13 years, 10 months ago) by greg
Branch: MAIN
Log Message:
Create pkgBSDF program

File Contents

# User Rev Content
1 greg 1.1 .\" RCSid $Id$
2     .TH PKGBSDF 1 6/23/2011 RADIANCE
3     .SH NAME
4     pkgBSDF - package BSDFs provided as XML for Radiance
5     .SH SYNOPSIS
6     .B pkgBSDF
7     [
8     .B \-i
9     ][
10     .B \-s
11     ]
12     .B "bsdf.xml .."
13     .SH DESCRIPTION
14     .I PkgBSDF
15     takes one or more XML files, each describing the bidirectional scattering
16     distribution function of a surface or geometric system, and packages
17     them into RADIANCE scene descriptions.
18     One rectangle is produced for each BSDF that has
19     no detail geometry and/or no rear-side reflectance distribution.
20     If both front and back reflectance distributions are present with
21     detail geometry, then two rectangles will be used to sandwich
22     the geometry extracted from the BSDF file.
23     .PP
24     The
25     .I \-i
26     option causes
27     .I pkgBSDF
28     to produce frozen octree instances for any detail geometry,
29     which may reduce memory requirements in scenes with many
30     references to the same complex BSDF object.
31     .PP
32     Normally,
33     .I pkgBSDF
34     produces one RADIANCE scene file for each XML input, replacing
35     the required '.xml' suffix with '.rad' in the same directory.
36     The
37     .I \-s
38     option sends the RADIANCE scene description to the standard
39     output rather than writing it to a file, but only works
40     for a single XML input.
41     Any instance octree is still written out to a file generated
42     by replacing the '.xml' suffix with '.oct' in the same directory.
43     .SH EXAMPLE
44     Package all the XML files in the current directory as Radiance
45     scene files, employing frozen octree instances for any
46     detail geometry:
47     .IP "" .2i
48     pkgBSDF -i *.xml
49     .SH AUTHOR
50     Greg Ward
51     .SH "SEE ALSO"
52     genBSDF(1), oconv(1), xform(1)