7 |
|
[ |
8 |
|
.B \-h |
9 |
|
][ |
10 |
+ |
.B \-w |
11 |
+ |
][ |
12 |
|
.B \-f[afdb][N]] |
13 |
|
][ |
14 |
|
.B \-t |
34 |
|
is copied to the standard output along with the command name, but the |
35 |
|
.I \-h |
36 |
|
option may be used to turn this behavior off. |
37 |
+ |
The |
38 |
+ |
.I \-w |
39 |
+ |
option turns off non-fatal warning messages, such as unexpected EOD. |
40 |
|
.PP |
41 |
|
The input format is assumed to be ASCII, with three white-space separated words |
42 |
|
(typically numbers) in each record. |
69 |
|
does not actually do anything for binary files unless the transpose |
70 |
|
option is given, also. |
71 |
|
.PP |
72 |
+ |
If an input header is present, it may contain the format, number of components |
73 |
+ |
and matrix dimensions. |
74 |
+ |
In such cases, the |
75 |
+ |
.I \-ic, |
76 |
+ |
.I \-ir |
77 |
+ |
and |
78 |
+ |
.I \-f |
79 |
+ |
options are not required, but will be checked against the header |
80 |
+ |
information if provided. |
81 |
+ |
.PP |
82 |
|
The transpose option, |
83 |
|
.I \-t |
84 |
|
swaps rows and columns on the input. |
98 |
|
to specify the input file on the command line, rather than reading |
99 |
|
from the standard input, since |
100 |
|
.I rcollate |
101 |
< |
can map the file directly into memory. |
101 |
> |
can map the file directly into virtual memory. |
102 |
|
.SH EXAMPLE |
103 |
|
To change put 8760 color triplets per row in a matrix with no header: |
104 |
|
.IP "" .2i |