ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/doc/man/man1/rtcontrib.1
(Generate patch)

Comparing ray/doc/man/man1/rtcontrib.1 (file contents):
Revision 1.6 by greg, Wed Jun 1 16:11:01 2005 UTC vs.
Revision 1.13 by greg, Thu Oct 6 16:28:59 2005 UTC

# Line 7 | Line 7 | rtcontrib - compute contribution coefficients in a RAD
7   [
8   .B "\-n nprocs"
9   ][
10 + .B \-r
11 + ][
12   .B "\-e expr"
13   ][
14   .B "\-f source"
15   ][
16 < .B "\-o fspec"
16 > .B "\-o ospec"
17   ][
18   .B "\-b binv"
19 + ][
20 + .B "\-bn nbins"
21   ]
22 < .B "\-m mod .."
22 > {
23 > .B "\-m mod | \-M file"
24 > }
25 > ..
26   [
27   .B $EVAR
28   ]
# Line 37 | Line 44 | settings.
44   These modifiers are usually materials associated with
45   light sources or sky domes, and must directly modify some geometric
46   primitives to be considered in the output.
47 + A modifier list may also be read from a file using the
48 + .I \-M
49 + option.
50 + The RAYPATH environment variable determines directories to search for
51 + this file.
52 + (No search takes place if a file name begins with a '.', '/' or '~'
53 + character.)\0
54 + .PP
55   The output of
56   .I rtcontrib
57   has many potential uses.
# Line 53 | Line 68 | calls
68   .I rtrace(1)
69   with the -oTW option to calculate the daughter ray
70   contributions for each input ray, and the output tallies
71 < are sent to one or more files according to the given
71 > are sent to one or more destinations according to the given
72   .I \-o
73   specification.
74 + If a destination begins with an exclamation mark ('!'), then
75 + a pipe is opened to a command and data is sent to its standard input.
76 + Otherwise, the destination is treated as a file.
77 + An existing file of the same name is clobbered, unless the
78 + .I \-r
79 + option is specified, in which case data recovery is attempted.
80   If an output specification contains a "%s" format, this will be
81   replaced by the modifier name.
82   The
# Line 66 | Line 87 | this will be applied to a "%d" format in the output fi
87   specification if present.
88   The actual bin number is computed at run time based on ray direction
89   and surface intersection, as described below.
90 + If the number of bins is known in advance, it should be specified with the
91 + .I \-bn
92 + option, and this is critical for output files containing multiple values
93 + per record.
94 + Since bin numbers start from 0, the bin count is always equal to
95 + the last bin plus 1.
96 + Set the this value to 0 if the bin count is unknown (the default).
97   The most recent
98 < .I \-b
98 > .I \-b,
99 > .I \-bn
100   and
101   .I \-o
102   options to the left of each
# Line 105 | Line 134 | Unlike
134   will search the RADIANCE library directories for each file given in a
135   .I \-f
136   option.
108 – (No search takes place if a file name begins with a '.', '/' or '~'
109 – character.)\0
137   .PP
138   If no
139   .I \-o
140   specification is given, results are written on the standard output in order
141   of modifier (as given on the command line) then bin number.
142 < Concatenated data is also sent to a lone output file (i.e., an initial
142 > Concatenated data is also sent to a single destination (i.e., an initial
143   .I \-o
144   specification without formatting strings).
145   If a "%s" format appears but no "%d" in the
# Line 187 | Line 214 | pcomb -c 100 90 75 c_light1.pic -c 50 55 57 c_light2.p
214   .PP
215   To compute an array of illuminance contributions according to a Tregenza sky:
216   .IP "" .2i
217 < rtcontrib -b tbin -o sky.dat -m skyglow -b 0 -o ground.dat -m groundglow
217 > rtcontrib -I+ -b tbin -o sky.dat -m skyglow -b 0 -o ground.dat -m groundglow
218   @render.opt -f tregenza.cal scene.oct < test.dat
219   .SH ENVIRONMENT
220 < RAYPATH         path to search for -f files
220 > RAYPATH         path to search for -f and -M files
221   .SH AUTHOR
222   Greg Ward
223   .SH "SEE ALSO"

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines