1 |
.\" RCSid "$Id: getinfo.1,v 1.5 2008/11/10 19:08:17 greg Exp $" |
2 |
.TH GETINFO 1 1/15/99 RADIANCE |
3 |
.SH NAME |
4 |
getinfo - get header information from a RADIANCE file |
5 |
.SH SYNOPSIS |
6 |
.B getinfo |
7 |
[ |
8 |
.B -d |
9 |
][ |
10 |
.B "file .." |
11 |
] |
12 |
.br |
13 |
.B getinfo |
14 |
- |
15 |
.br |
16 |
.B getinfo |
17 |
.B -c |
18 |
.B "command .." |
19 |
.SH DESCRIPTION |
20 |
.I Getinfo |
21 |
reads the header of each RADIANCE |
22 |
.I file |
23 |
and writes it to the standard output. |
24 |
Octree and picture files are in a binary format, which makes |
25 |
it difficult to determine their content. |
26 |
Therefore, a few lines of text are placed at the beginning |
27 |
of each file by the RADIANCE program that creates it. |
28 |
The end of the header information and the start of the |
29 |
data is indicated by an empty line. |
30 |
The |
31 |
.I \-d |
32 |
option can be used to print the dimensions of an octree or |
33 |
picture file instead. |
34 |
For an octree, |
35 |
.I "getinfo \-d" |
36 |
prints the bounding cube (xmin ymin zmin size). |
37 |
For a picture, |
38 |
.I "getinfo \-d" |
39 |
prints the y and x resolution (\-Y yres +X xres). |
40 |
If no |
41 |
.I file |
42 |
is given, the standard input is read. |
43 |
.PP |
44 |
The second form of |
45 |
.I getinfo |
46 |
with a hyphen simply removes the header |
47 |
and copies the body of the file from the standard |
48 |
input to the standard output. |
49 |
.PP |
50 |
The third form of |
51 |
.I "getinfo \-c" |
52 |
is followed by a command and its arguments, which is executed |
53 |
on the data segment of the standard input. |
54 |
The header is passed along, with the addition of the command |
55 |
at the end. |
56 |
This is roughly equivalent to the following sequence, but does not |
57 |
require the input to be in a file: |
58 |
.IP "" .2i |
59 |
( getinfo < input ; getinfo - < input | command .. ) |
60 |
.SH EXAMPLE |
61 |
To print the header information from scene1.oct and scene2.hdr: |
62 |
.IP "" .2i |
63 |
getinfo scene1.oct scene2.hdr |
64 |
.SH AUTHOR |
65 |
Greg Ward |
66 |
.SH "SEE ALSO" |
67 |
oconv(1), pfilt(1), rcalc(1), rhinfo(1), rpict(1), rvu(1) |