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.24 by greg, Tue Nov 21 02:16:59 2023 UTC vs.
Revision 1.26 by greg, Wed Nov 29 18:56:28 2023 UTC

# Line 11 | Line 11 | rmtxop - concatenate, add, multiply, divide, transpose
11   ][
12   .B \-t
13   ][
14 – .B "\-s sf .."
15 – ][
14   .B "\-c ce .."
15   ][
16 + .B "\-s sf .."
17 + ][
18   .B "\-rf|\-rb"
19   ]
20   .B m1
# Line 33 | Line 33 | NROWS={number of rows}
33   NCOLS={number of columns}
34   NCOMP={number of components}
35   FORMAT={ascii|float|double|32-bit_rle_rgbe|32-bit_rle_xyze|Radiance_spectra}
36 – .sp
36   .fi
37 + .sp
38   The number of components indicates that each matrix element is actually
39   composed of multiple elements, most commonly an RGB triple.
40   This is essentially dividing the matrix into planes, where each component
# Line 78 | Line 78 | or
78   Before each file, the
79   .I \-t
80   and
81 – .I \-s
82 – or
81   .I \-c
82 + and/or
83 + .I \-s
84   options may be used to modify the matrix.
85   The
86   .I \-t
87   option transposes the matrix, swapping rows and columns.
88   The
89 – .I \-s
90 – option applies the given scalar factor(s) to the elements of the matrix.
91 – If only one factor is provided,
92 – it will be used for all components.
93 – If multiple factors are given, their number must match the number of matrix
94 – components.
95 – Alternatively, the
89   .I \-c
90 < option may be used to "transform" the element values, possibly changing
90 > option can "transform" the element values, possibly changing
91   the number of components in the matrix.
92   For example, a 3-component matrix can be transformed into a single-component
93   matrix by using
# Line 106 | Line 99 | the first new component, and the second four coefficie
99   yield the second new component.
100   Note that the number of coefficients must be an even multiple of the number
101   of original components.
102 < The
102 > Alternatively, a set of symbolic output components can be specified as capital
103 > letters, with the following definitions:
104 > .sp
105 > .nf
106 > R       - red channel
107 > G       - green channel
108 > B       - blue channel
109 > X       - CIE X channel
110 > Y       - CIE Y channel (aka., luminance or illuminance)
111 > Z       - CIE Z channel
112 > S       - scotopic luminance or illuminance
113 > M       - melanopic luminance or illuminance
114 > A       - average component value
115 > .fi
116 > .sp
117 > These letters may be given in any order as a single string, and if
118 > .I "-c RGB"
119 > or
120 > .I "-c XYZ"
121 > is specified along with a
122 > .I "-fc"
123 > option, the output will be written as a RGBE or XYZE picture, respectively.
124 > Note that conversion from a float or RGBE color space applies a conversion
125 > of 179 lumens/watt (for CIE or melanopic output) or 412 (for scotopic output),
126 > and the reverse happens for conversion from XYZE input to RGB or RGBE output.
127 > .PP
128 > Additionally, the
129   .I \-s
130 < and
130 > option applies the given scalar factor(s) to the elements of the matrix.
131 > If only one factor is provided,
132 > it will be used for all components.
133 > If multiple factors are given, their number must match the number of matrix
134 > components
135 > .I after
136 > application of any
137   .I \-c
138 < options are mutually exclusive, insofar as they cannot be applied together
114 < to the same input matrix.
138 > option for this input matrix or picture.
139   .PP
140   If present, the second and subsequent matrices on the command
141   line are concatenated together, unless separated by a plus ('+'),
# Line 150 | Line 174 | In the case of addition, multiplication, and division,
174   the number of rows and columns of the prior result and the
175   next matrix must match, and will not be changed by the operation.
176   .PP
177 < A final transpose or scaling/transform operation may be applied to
177 > A final transpose or transform/scaling operation may be applied to
178   the results by appending the
179   .I \-t
180   and
157 – .I \-s
158 – or
181   .I \-c
182 + and/or
183 + .I \-s
184   options after the last matrix on the command line.
185   .PP
186   Results are sent to the standard output.
# Line 164 | Line 188 | By default, the values will be written in the lowest r
188   among the inputs, but the
189   .I \-f
190   option may be used to explicitly output components
191 < as ASCII (-fa), binary doubles (-fd), floats (-ff), or common-exponent colors (-fc).
191 > as ASCII (-fa), binary doubles (-fd), floats (-ff), or common-exponent
192 > colors/spectra (-fc).
193   In the latter case, the actual matrix dimensions are written in the resolution
194   string rather than the header.
195   Also, matrix results will be written as standard
# Line 192 | Line 217 | To extract the luminance values from a picture as an A
217   .IP "" .2i
218   rmtxop -fa -c .265 .670 .065 image.hdr > image_lum.mtx
219   .PP
220 + To render a melanopic illuminance image with
221 + .I rtrace\:
222 + .IP "" .2i
223 + vwrays -ff -x 1024 -y 1024 -vf myview.vf |
224 + rtrace -fff -cs 18 -co+ -i+ `vwrays -x 1024 -y 1024 -vf myview.vf -d` scene.oct |
225 + rmtxop -fc -c M - > scene_meli.hdr
226 + .PP
227   To scale a matrix by 4 and add it to the transpose of another matrix:
228   .IP "" .2i
229   rmtxop -s 4 first.mtx + -t second.mtx > result.mtx
# Line 225 | Line 257 | evaluated from left to right.
257   .SH AUTHOR
258   Greg Ward
259   .SH "SEE ALSO"
260 < cnt(1), getinfo(1), histo(1), neaten(1), pcomb(1), rcalc(1),
260 > cnt(1), getinfo(1), histo(1), neaten(1), pcomb(1),
261 > ra_xyze(1), rcalc(1),
262   rcollate(1), rcontrib(1), rcrop(1), rfluxmtx(1), rlam(1),
263 < rsplit(1), rtrace(1), tabfunc(1), total(1), wrapBSDF(1)
263 > rsplit(1), rtrace(1), tabfunc(1), total(1), vwrays(1),
264 > wrapBSDF(1)

Diff Legend

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