| 1 |
|
.\" RCSid "$Id$" |
| 2 |
< |
.TH RMTXOP 1 7/8/97 RADIANCE |
| 2 |
> |
.TH RMTXOP 1 5/31/2014 RADIANCE |
| 3 |
|
.SH NAME |
| 4 |
|
rmtxop - concatenate, add, multiply, divide, transpose, scale, and convert matrices |
| 5 |
|
.SH SYNOPSIS |
| 14 |
|
.B "\-s sf .." |
| 15 |
|
][ |
| 16 |
|
.B "\-c ce .." |
| 17 |
+ |
][ |
| 18 |
+ |
.B "\-rf|\-rb" |
| 19 |
|
] |
| 20 |
|
.B m1 |
| 21 |
|
[ |
| 32 |
|
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} |
| 35 |
> |
FORMAT={ascii|float|double|32-bit_rle_rgbe|32-bit_rle_xyze|Radiance_spectra} |
| 36 |
|
.sp |
| 37 |
|
.fi |
| 38 |
|
The number of components indicates that each matrix element is actually |
| 49 |
|
using quotes and a beginning exclamation point ('!'). |
| 50 |
|
.PP |
| 51 |
|
Two special cases are handled for component matrices that are either |
| 52 |
< |
XML files containing BTDF data, or Radiance picture files. |
| 53 |
< |
In the first case, a BSDF library is used to load and interpret the |
| 54 |
< |
transmission matrix. |
| 52 |
> |
XML files containing BSDF data, or Radiance picture files. |
| 53 |
> |
In the first case, the BSDF library loads and interprets the |
| 54 |
> |
transmission matrix by default. |
| 55 |
> |
Alternatively, the front (normal-side) reflectance is selected if the |
| 56 |
> |
.I \-rf |
| 57 |
> |
option precedes the file name, or the backside reflectance if |
| 58 |
> |
.I \-rb |
| 59 |
> |
is specified. |
| 60 |
|
(XML files cannot be read from the standard input or from a command.)\0 |
| 61 |
|
In the second case, the RGBE or XYZE values are loaded in a 3-component |
| 62 |
|
matrix where the number of columns match the X-dimension of the picture, and |
| 63 |
|
the number of rows match the Y-dimension. |
| 64 |
|
The picture must be in standard pixel ordering, and the first row |
| 65 |
|
is at the top with the first column on the left. |
| 66 |
+ |
Any exposure changes that were applied to the pictures before |
| 67 |
+ |
.I rmtxop |
| 68 |
+ |
will be undone, similar to the |
| 69 |
+ |
.I pcomb(1) |
| 70 |
+ |
.I \-o |
| 71 |
+ |
option. |
| 72 |
+ |
Radiance spectral pictures with more than 3 components are also supported. |
| 73 |
+ |
These are typically produced by |
| 74 |
+ |
.I rtrace(1) |
| 75 |
+ |
or |
| 76 |
+ |
.I rfluxmtx(1). |
| 77 |
|
.PP |
| 78 |
|
Before each file, the |
| 79 |
|
.I \-t |
| 139 |
|
.I rmtxop |
| 140 |
|
command into another, as shown in one of the examples below. |
| 141 |
|
.PP |
| 142 |
< |
The number of components in the new matrix after applying any |
| 142 |
> |
The number of components in the next matrix after applying any |
| 143 |
|
.I -c |
| 144 |
|
transform must agree with the prior result. |
| 145 |
|
For concatenation (matrix multiplication), the number of columns |
| 146 |
< |
in the prior result must equal the number of rows in the new matrix, and |
| 146 |
> |
in the prior result must equal the number of rows in the next matrix, and |
| 147 |
|
the result will have the number of rows of the previous and the number |
| 148 |
< |
of columns of the new matrix. |
| 148 |
> |
of columns of the next matrix. |
| 149 |
|
In the case of addition, multiplication, and division, |
| 150 |
|
the number of rows and columns of the prior result and the |
| 151 |
< |
new matrix must match, and will not be changed by the operation. |
| 151 |
> |
next matrix must match, and will not be changed by the operation. |
| 152 |
|
.PP |
| 153 |
|
A final transpose or scaling/transform operation may be applied to |
| 154 |
|
the results by appending the |
| 164 |
|
among the inputs, but the |
| 165 |
|
.I \-f |
| 166 |
|
option may be used to explicitly output components |
| 167 |
< |
as ASCII (-fa), binary doubles (-fd), floats (-ff), or RGBE colors (-fc). |
| 167 |
> |
as ASCII (-fa), binary doubles (-fd), floats (-ff), or common-exponent colors (-fc). |
| 168 |
|
In the latter case, the actual matrix dimensions are written in the resolution |
| 169 |
|
string rather than the header. |
| 170 |
< |
Also, matrix results written as Radiance pictures must have either one |
| 170 |
> |
Also, matrix results will be written as standard |
| 171 |
> |
Radiance pictures if they have either one |
| 172 |
|
or three components. |
| 173 |
|
In the one-component case, the output is written as grayscale. |
| 174 |
+ |
If more than 3 components are in the final matrix and |
| 175 |
+ |
.I -fc |
| 176 |
+ |
is specified, the output will be a Radiance spectral picture. |
| 177 |
|
.PP |
| 178 |
|
The |
| 179 |
|
.I \-v |
| 225 |
|
.SH AUTHOR |
| 226 |
|
Greg Ward |
| 227 |
|
.SH "SEE ALSO" |
| 228 |
< |
cnt(1), getinfo(1), histo(1), neaten(1), rcalc(1), rcollate(1), |
| 229 |
< |
rcontrib(1), rfluxmtx(1), rlam(1), |
| 230 |
< |
rsplit(1), tabfunc(1), total(1), wrapBSDF(1) |
| 228 |
> |
cnt(1), getinfo(1), histo(1), neaten(1), pcomb(1), rcalc(1), |
| 229 |
> |
rcollate(1), rcontrib(1), rcrop(1), rfluxmtx(1), rlam(1), |
| 230 |
> |
rsplit(1), rtrace(1), tabfunc(1), total(1), wrapBSDF(1) |
