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.4 by greg, Thu May 26 21:03:22 2005 UTC vs.
Revision 1.12 by greg, Thu Oct 6 05:49:44 2005 UTC

# Line 1 | Line 1
1   .\" RCSid "$Id$"
2   .TH RTCONTRIB 1 5/25/05 RADIANCE
3   .SH NAME
4 < rtcontrib - compute contributions in a RADIANCE scene
4 > rtcontrib - compute contribution coefficients in a RADIANCE scene
5   .SH SYNOPSIS
6   .B rtcontrib
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 51 | Line 66 | systems, such as luminaires, light pipes, and shading
66   .I Rtcontrib
67   calls
68   .I rtrace(1)
69 < to calculate the contributions for each input ray,
70 < and the output tallies are sent to one or more files according to the
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 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 65 | 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, especially for output files containing multiple bins.
93 + Set this to 0 if the number of bins is unknown (the default).
94   The most recent
95 < .I \-b
95 > .I \-b,
96 > .I \-bn
97   and
98   .I \-o
99   options to the left of each
# Line 98 | Line 125 | The rules and predefined functions available for these
125   described in the
126   .I rcalc(1)
127   man page.
128 + Unlike
129 + .I rcalc,
130 + .I rtcontrib
131 + will search the RADIANCE library directories for each file given in a
132 + .I \-f
133 + option.
134   .PP
135   If no
136   .I \-o
137   specification is given, results are written on the standard output in order
138   of modifier (as given on the command line) then bin number.
139 < Concatenated data is also sent to a lone output file (i.e., an initial
139 > Concatenated data is also sent to a single destination (i.e., an initial
140   .I \-o
141   specification without formatting strings).
142   If a "%s" format appears but no "%d" in the
# Line 178 | Line 211 | pcomb -c 100 90 75 c_light1.pic -c 50 55 57 c_light2.p
211   .PP
212   To compute an array of illuminance contributions according to a Tregenza sky:
213   .IP "" .2i
214 < rtcontrib -b tbin -o sky.dat -m skyglow -b 0 -o ground.dat -m groundglow
214 > rtcontrib -I+ -b tbin -o sky.dat -m skyglow -b 0 -o ground.dat -m groundglow
215   @render.opt -f tregenza.cal scene.oct < test.dat
216 + .SH ENVIRONMENT
217 + RAYPATH         path to search for -f and -M files
218   .SH AUTHOR
219   Greg Ward
220   .SH "SEE ALSO"

Diff Legend

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