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.5 by greg, Fri May 27 19:15:28 2005 UTC vs.
Revision 1.14 by greg, Tue Oct 11 16:54:26 2005 UTC

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

Diff Legend

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