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.9 by greg, Fri Jun 10 16:42:10 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"
# Line 16 | Line 18 | rtcontrib - compute contribution coefficients in a RAD
18   .B "\-o ospec"
19   ][
20   .B "\-b binv"
21 + ][
22 + .B "\-bn nbins"
23   ]
24   {
25   .B "\-m mod | \-M file"
# Line 45 | Line 49 | 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
# Line 68 | Line 76 | 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 is clobbered, unless the
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, in which case data recovery is attempted.
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 81 | 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 120 | Line 139 | Unlike
139   will search the RADIANCE library directories for each file given in a
140   .I \-f
141   option.
123 (No search takes place if a file name begins with a '.', '/' or '~'
124 character.)\0
142   .PP
143   If no
144   .I \-o
# Line 202 | 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 files
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