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

Comparing ray/doc/man/man1/rmtxop.1 (file contents):
Revision 1.27 by greg, Sat Dec 2 00:42:21 2023 UTC vs.
Revision 1.35 by greg, Thu Mar 27 01:26:55 2025 UTC

# Line 28 | Line 28 | rmtxop - concatenate, add, multiply, divide, transpose
28   .I Rmtxop
29   loads and concatenates or adds/multiplies/divides
30   together component matrix files given on the command line.
31 < Each file must have a header containing the following variables:
31 > Each file must have a header containing the following metadata:
32   .sp
33   .nf
34   NROWS={number of rows}
# Line 38 | Line 38 | FORMAT={ascii|float|double|32-bit_rle_rgbe|32-bit_rle_
38   .fi
39   .sp
40   The number of components indicates that each matrix element is actually
41 < composed of multiple elements, most commonly an RGB triple.
41 > composed of multiple channels, most commonly an RGB triple.
42   This is essentially dividing the matrix into planes, where each component
43   participates in a separate calculation.
44   If an appropriate header is not present, it may be added with a call to
45   .I rcollate(1).
46   A matrix may be read from the standard input using a hyphen by itself ('-')
47   in the appropriate place on the command line.
48 < .PP
49 < Any of the matrix inputs may be read from a command
48 > Similarly, any of the inputs may be read from a command
49   instead of a file by
50   using quotes and a beginning exclamation point ('!').
51   .PP
# Line 77 | Line 76 | These are typically produced by
76   or
77   .I rfluxmtx(1).
78   .PP
79 < Before each file, the
79 > Before each input, the
80   .I \-t
81   and
82   .I \-c
# Line 122 | Line 121 | These letters may be given in any order as a single st
121   .I "-c RGB"
122   or
123   .I "-c XYZ"
124 < is specified with
124 > is specified for an input picture or the
125   .I "-fc"
126 < option, the output will be written as a RGBE or XYZE picture, respectively.
126 > option is given, the output will be written as a RGBE or XYZE picture.
127   Note that conversion from a float or RGBE color space applies a conversion
128   of 179 lumens/watt (for CIE or melanopic output) or 412 (for scotopic output),
129   and the reverse happens for conversion from XYZE input to RGB or RGBE output.
130 + Lower case versions of all these components are also supported, the only
131 + difference is that the aforementioned efficacy factors
132 + will be left out of the conversion.
133   .PP
134 < If a matrix or picture file is given to the
134 > If a matrix or picture file path is given to the
135   .I \-c
136   option, then the color space of that file will be used, instead.
137   .PP
# Line 150 | Line 152 | components
152   .I after
153   application of any
154   .I \-c
155 < option for this input matrix or picture.
155 > option for this input matrix or picture, even if the
156 > .I \-s
157 > option appears first.
158   .PP
159   If present, the second and subsequent matrices on the command
160   line are concatenated together, unless separated by a plus ('+'),
# Line 199 | Line 203 | and/or
203   options after the last matrix on the command line.
204   .PP
205   Results are sent to the standard output.
206 < By default, the values will be written in the lowest resolution format
206 > By default, the values will be written in the lowest precision format
207   among the inputs, but the
208 < .I \-f
208 > .I \-f[adfc]
209   option may be used to explicitly output components
210   as ASCII (-fa), binary doubles (-fd), floats (-ff), or common-exponent
211   colors/spectra (-fc).
212 < In the latter case, the actual matrix dimensions are written in the resolution
213 < string rather than the header.
212 > In the latter case, the actual matrix dimensions are written in
213 > the resolution string rather than the header.
214   Also, matrix results will be written as standard
215   Radiance pictures if they have either one
216   or three components.
# Line 269 | Line 273 | be the same.
273   Note that this only applies to concatenation;
274   element-wise addition, multiplication, and division are always
275   evaluated from left to right.
276 + .SH BUGS
277 + The
278 + .I rmtxop
279 + command currently ignores the "PRIMARIES" setting in input
280 + headers, and does not produce any on output, even in
281 + circumstances where it would make sense to.
282   .SH AUTHOR
283   Greg Ward
284   .SH "SEE ALSO"
285 < cnt(1), getinfo(1), histo(1), neaten(1), pcomb(1),
286 < ra_xyze(1), rcalc(1),
287 < rcollate(1), rcontrib(1), rcrop(1), rfluxmtx(1), rlam(1),
288 < rsplit(1), rtrace(1), tabfunc(1), total(1), vwrays(1),
279 < wrapBSDF(1)
285 > cnt(1), dctimestep(1), getinfo(1), pcomb(1), pfilt(1),
286 > pvsum(1), ra_xyze(1), rcalc(1),
287 > rcollate(1), rcomb(1), rcontrib(1), rcrop(1), rfluxmtx(1),
288 > rtpict(1), rtrace(1), vwrays(1), wrapBSDF(1)

Diff Legend

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