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.27 by greg, Sat Dec 2 00:42:21 2023 UTC

# Line 9 | Line 9 | rmtxop - concatenate, add, multiply, divide, transpose
9   ][
10   .B \-f[afdc]
11   ][
12 < .B \-t
12 > .B "\-C {symbols|file}"
13   ][
14 + .B "\-c ce .."
15 + ][
16   .B "\-s sf .."
17   ][
18 < .B "\-c ce .."
18 > .B \-t
19   ][
20   .B "\-rf|\-rb"
21   ]
# Line 33 | Line 35 | NROWS={number of rows}
35   NCOLS={number of columns}
36   NCOMP={number of components}
37   FORMAT={ascii|float|double|32-bit_rle_rgbe|32-bit_rle_xyze|Radiance_spectra}
36 – .sp
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.
42   This is essentially dividing the matrix into planes, where each component
# Line 78 | Line 80 | or
80   Before each file, the
81   .I \-t
82   and
81 – .I \-s
82 – or
83   .I \-c
84 + and/or
85 + .I \-s
86   options may be used to modify the matrix.
87   The
88   .I \-t
89   option transposes the matrix, swapping rows and columns.
90   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
91   .I \-c
92 < option may be used to "transform" the element values, possibly changing
92 > option can "transform" the element values, possibly changing
93   the number of components in the matrix.
94   For example, a 3-component matrix can be transformed into a single-component
95   matrix by using
# Line 106 | Line 101 | the first new component, and the second four coefficie
101   yield the second new component.
102   Note that the number of coefficients must be an even multiple of the number
103   of original components.
104 + .PP
105 + Alternatively, a set of symbolic output components may be given to the
106 + .I \-c
107 + option, with the following definitions:
108 + .sp
109 + .nf
110 + R       - red channel
111 + G       - green channel
112 + B       - blue channel
113 + X       - CIE X channel
114 + Y       - CIE Y channel (aka., luminance or illuminance)
115 + Z       - CIE Z channel
116 + S       - scotopic luminance or illuminance
117 + M       - melanopic luminance or illuminance
118 + A       - average component value
119 + .fi
120 + .sp
121 + These letters may be given in any order as a single string, and if
122 + .I "-c RGB"
123 + or
124 + .I "-c XYZ"
125 + is specified with
126 + .I "-fc"
127 + option, the output will be written as a RGBE or XYZE picture, respectively.
128 + Note that conversion from a float or RGBE color space applies a conversion
129 + of 179 lumens/watt (for CIE or melanopic output) or 412 (for scotopic output),
130 + and the reverse happens for conversion from XYZE input to RGB or RGBE output.
131 + .PP
132 + If a matrix or picture file is given to the
133 + .I \-c
134 + option, then the color space of that file will be used, instead.
135 + .PP
136   The
137 + .I \-C
138 + option takes either a symbolic color space or an input file, and will be
139 + applied to all subsequent matrices that do not have their own associated
140 + .I \-c
141 + option.
142 + .PP
143 + Additionally, the
144   .I \-s
145 < and
145 > option applies the given scalar factor(s) to the elements of the matrix.
146 > If only one factor is provided,
147 > it will be used for all components.
148 > If multiple factors are given, their number must match the number of matrix
149 > components
150 > .I after
151 > application of any
152   .I \-c
153 < options are mutually exclusive, insofar as they cannot be applied together
114 < to the same input matrix.
153 > option for this input matrix or picture.
154   .PP
155   If present, the second and subsequent matrices on the command
156   line are concatenated together, unless separated by a plus ('+'),
# Line 150 | Line 189 | In the case of addition, multiplication, and division,
189   the number of rows and columns of the prior result and the
190   next matrix must match, and will not be changed by the operation.
191   .PP
192 < A final transpose or scaling/transform operation may be applied to
192 > A final transpose or transform/scaling operation may be applied to
193   the results by appending the
194   .I \-t
195   and
157 – .I \-s
158 – or
196   .I \-c
197 + and/or
198 + .I \-s
199   options after the last matrix on the command line.
200   .PP
201   Results are sent to the standard output.
# Line 164 | Line 203 | By default, the values will be written in the lowest r
203   among the inputs, but the
204   .I \-f
205   option may be used to explicitly output components
206 < as ASCII (-fa), binary doubles (-fd), floats (-ff), or common-exponent colors (-fc).
206 > as ASCII (-fa), binary doubles (-fd), floats (-ff), or common-exponent
207 > colors/spectra (-fc).
208   In the latter case, the actual matrix dimensions are written in the resolution
209   string rather than the header.
210   Also, matrix results will be written as standard
# Line 192 | Line 232 | To extract the luminance values from a picture as an A
232   .IP "" .2i
233   rmtxop -fa -c .265 .670 .065 image.hdr > image_lum.mtx
234   .PP
235 + To render a melanopic illuminance image with
236 + .I rtrace\:
237 + .IP "" .2i
238 + vwrays -ff -x 1024 -y 1024 -vf myview.vf |
239 + rtrace -fff -cs 18 -co+ -i+ `vwrays -x 1024 -y 1024 -vf myview.vf -d` scene.oct |
240 + rmtxop -fc -c M - > scene_meli.hdr
241 + .PP
242   To scale a matrix by 4 and add it to the transpose of another matrix:
243   .IP "" .2i
244   rmtxop -s 4 first.mtx + -t second.mtx > result.mtx
# Line 225 | Line 272 | evaluated from left to right.
272   .SH AUTHOR
273   Greg Ward
274   .SH "SEE ALSO"
275 < cnt(1), getinfo(1), histo(1), neaten(1), pcomb(1), rcalc(1),
275 > cnt(1), getinfo(1), histo(1), neaten(1), pcomb(1),
276 > ra_xyze(1), rcalc(1),
277   rcollate(1), rcontrib(1), rcrop(1), rfluxmtx(1), rlam(1),
278 < rsplit(1), rtrace(1), tabfunc(1), total(1), wrapBSDF(1)
278 > rsplit(1), rtrace(1), tabfunc(1), total(1), vwrays(1),
279 > wrapBSDF(1)

Diff Legend

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