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 \-t |
19 |
+ |
][ |
20 |
|
.B "\-rf|\-rb" |
21 |
|
] |
22 |
|
.B m1 |
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} |
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 |
47 |
< |
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 |
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 |
100 |
|
yield the second new component. |
101 |
|
Note that the number of coefficients must be an even multiple of the number |
102 |
|
of original components. |
103 |
< |
Alternatively, a set of symbolic output components can be specified as capital |
104 |
< |
letters, with the following definitions: |
103 |
> |
.PP |
104 |
> |
Alternatively, a set of symbolic output components may be given to the |
105 |
> |
.I \-c |
106 |
> |
option, with the following definitions: |
107 |
|
.sp |
108 |
|
.nf |
109 |
|
R - red channel |
121 |
|
.I "-c RGB" |
122 |
|
or |
123 |
|
.I "-c XYZ" |
124 |
< |
is specified along with a |
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 path is given to the |
135 |
+ |
.I \-c |
136 |
+ |
option, then the color space of that file will be used, instead. |
137 |
+ |
.PP |
138 |
+ |
The |
139 |
+ |
.I \-C |
140 |
+ |
option takes either a symbolic color space or an input file, and will be |
141 |
+ |
applied to all subsequent matrices that do not have their own associated |
142 |
+ |
.I \-c |
143 |
+ |
option. |
144 |
+ |
.PP |
145 |
|
Additionally, the |
146 |
|
.I \-s |
147 |
|
option applies the given scalar factor(s) to the elements of the matrix. |
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 ('+'), |
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. |
276 |
|
.SH AUTHOR |
277 |
|
Greg Ward |
278 |
|
.SH "SEE ALSO" |
279 |
< |
cnt(1), getinfo(1), histo(1), neaten(1), pcomb(1), |
279 |
> |
cnt(1), dctimestep(1), getinfo(1), pcomb(1), pfilt(1), |
280 |
|
ra_xyze(1), rcalc(1), |
281 |
< |
rcollate(1), rcontrib(1), rcrop(1), rfluxmtx(1), rlam(1), |
282 |
< |
rsplit(1), rtrace(1), tabfunc(1), total(1), vwrays(1), |
264 |
< |
wrapBSDF(1) |
281 |
> |
rcollate(1), rcomb(1), rcontrib(1), rcrop(1), rfluxmtx(1), |
282 |
> |
rtpict(1), rtrace(1), vwrays(1), wrapBSDF(1) |