| 1 | 
greg | 
1.2 | 
.\" RCSid "$Id$" | 
| 2 | 
greg | 
1.1 | 
.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 | 
  | 
  | 
.SH DESCRIPTION | 
| 16 | 
  | 
  | 
.I Getinfo | 
| 17 | 
  | 
  | 
reads the header of each RADIANCE | 
| 18 | 
  | 
  | 
.I file | 
| 19 | 
  | 
  | 
and writes it to the standard output. | 
| 20 | 
  | 
  | 
Octree and picture files are in a binary format, which makes | 
| 21 | 
  | 
  | 
it difficult to determine their content. | 
| 22 | 
  | 
  | 
Therefore, a few lines of text are placed at the beginning | 
| 23 | 
  | 
  | 
of each file by the RADIANCE program that creates it. | 
| 24 | 
  | 
  | 
The end of the header information and the start of the | 
| 25 | 
  | 
  | 
data is indicated by an empty line. | 
| 26 | 
  | 
  | 
The | 
| 27 | 
  | 
  | 
.I \-d | 
| 28 | 
  | 
  | 
option can be used to print the dimensions of an octree or | 
| 29 | 
  | 
  | 
picture file instead. | 
| 30 | 
  | 
  | 
For an octree, | 
| 31 | 
  | 
  | 
.I "getinfo \-d" | 
| 32 | 
  | 
  | 
prints the bounding cube (xmin ymin zmin size). | 
| 33 | 
  | 
  | 
For a picture, | 
| 34 | 
  | 
  | 
.I "getinfo \-d" | 
| 35 | 
  | 
  | 
prints the y and x resolution (-Y yres +X xres). | 
| 36 | 
  | 
  | 
If no | 
| 37 | 
  | 
  | 
.I file | 
| 38 | 
  | 
  | 
is given, the standard input is read. | 
| 39 | 
  | 
  | 
.PP | 
| 40 | 
  | 
  | 
The second form of getinfo with a hyphen simply removes the header | 
| 41 | 
  | 
  | 
and copies the body of the file from the standard | 
| 42 | 
  | 
  | 
input to the standard output. | 
| 43 | 
  | 
  | 
.SH EXAMPLE | 
| 44 | 
  | 
  | 
To print the header information from scene1.oct and scene2.pic: | 
| 45 | 
  | 
  | 
.IP "" .2i | 
| 46 | 
  | 
  | 
getinfo scene1.oct scene2.pic | 
| 47 | 
  | 
  | 
.SH AUTHOR | 
| 48 | 
  | 
  | 
Greg Ward | 
| 49 | 
  | 
  | 
.SH "SEE ALSO" | 
| 50 | 
  | 
  | 
oconv(1), pfilt(1), rhinfo(1), rpict(1), rview(1) |