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

Comparing ray/doc/man/man1/rcomb.1 (file contents):
Revision 1.5 by greg, Wed Jan 17 21:50:15 2024 UTC vs.
Revision 1.7 by greg, Tue May 7 17:15:31 2024 UTC

# Line 53 | Line 53 | or
53   .I \-s
54   options follow the last input matrix, output results will be transformed
55   and/or scaled accordingly.
56 < These operations are discussed in greater detail further on.
56 > These operations are discussed in greater detail below.
57   A single concatenation matrix may be applied after element operations
58   using the
59   .I \-m
# Line 71 | Line 71 | FORMAT={ascii|float|double|32-bit_rle_rgbe|32-bit_rle_
71   .fi
72   .sp
73   The number of components indicates that each matrix element is actually
74 < composed of multiple elements, most commonly an RGB triple.
74 > composed of multiple channels, most commonly an RGB triple.
75   This is essentially dividing the matrix into planes, where each component
76   participates in a separate calculation.
77   If an appropriate header is not present, it may be added with a call to
# Line 188 | Line 188 | If the
188   or
189   .I \-f
190   options are used to define a "co" variable or "co(p)" function,
191 < this will be evaluated at each output
192 < component for the current element.
191 > which will be evaluated for each output
192 > component from the current element.
193   The "co" variable defines identical operations for all components,
194   whereas "co(p)" may specify different operations for each component.
195   The element position is defined
# Line 207 | Line 207 | and the number of components is defined by the "ncomp"
207   If given as "ci(i)", the function returns the current component
208   being evaluated by
209   .I rcomb.
210 < A different component may be referenced using th second argument.
210 > A different component may be referenced using the second argument.
211   For example, "ci(1,2)" accesses
212   the second component from the first input.
213   If the input is a picture, the the constants "R", "G", and "B"
# Line 222 | Line 222 | For convenience and compatibility with
222   the functions "ri(i)", "gi(i)", and "bi(i)" are predefined as
223   "ci(i,R)", "ci(i,G)", and "ci(i,B)", respectively.
224   Accordingly, the "ro", "go", and "bo"
225 < variables may be used in place of "co(R)", "co(G)", and "co(B)".
225 > variables may be used in place of "co(R)", "co(G)", and "co(B)",
226 > but all three must be defined for this substitution to take place.
227   Finally, the total number of input files is set in the constant "nfiles".
228   .PP
229   Results are sent to the standard output.
# Line 280 | Line 281 | and
281   .I pcomb,
282   whose capabilities somewhat overlap.
283   The former loads each matrix into memory before operations,
284 < and element components take 8 bytes apiece, adding up quickly.
284 > and element components are stored as double-precision.
285   Very large matrices therefore present a problem with that tool.
286   Furthermore,
287   .I rmtxop
# Line 313 | Line 314 | Generally speaking,
314   .I rcomb
315   should be preferred over
316   .I rmtxop
317 < for any operations in can handle, which is everything except
317 > for any operations it can handle, which is everything except
318   multiple matrix concatenations and transpose
319 < operations, which are handled more efficiently by
320 < .I rcollate(1)
321 < in any case.
319 > operations.
320 > The latter may be handled more efficiently by
321 > .I rcollate(1).
322   That said, there is no significant difference for
323 < simple operations on smallish matrices, and note that only
323 > simple operations on small matrices, and only
324   .I rmtxop
325   and
326   .I dctimestep(1)
327 < currently accept XML files as inputs.
328 < Also, the resizing function of
327 > accept XML files as inputs.
328 > Also note that the resizing function of
329   .I pcomb
330   is not supported in
331   .I rcomb,

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines