man/man1/getinfo.1

.\" RCSid "$Id: getinfo.1,v 1.5 2008/11/10 19:08:17 greg Exp $"
.TH GETINFO 1 1/15/99 RADIANCE
.SH NAME
getinfo - get header information from a RADIANCE file
.SH SYNOPSIS
.B getinfo
[
.B -d
][
.B "file .."
]
.br
.B getinfo
-
.br
.B getinfo
.B -c
.B "command .."
.SH DESCRIPTION
.I Getinfo
reads the header of each RADIANCE
.I file
and writes it to the standard output.
Octree and picture files are in a binary format, which makes
it difficult to determine their content.
Therefore, a few lines of text are placed at the beginning
of each file by the RADIANCE program that creates it.
The end of the header information and the start of the
data is indicated by an empty line.
The
.I \-d
option can be used to print the dimensions of an octree or
picture file instead.
For an octree,
.I "getinfo \-d"
prints the bounding cube (xmin ymin zmin size).
For a picture,
.I "getinfo \-d"
prints the y and x resolution (\-Y yres +X xres).
If no
.I file
is given, the standard input is read.
.PP
The second form of
.I getinfo
with a hyphen simply removes the header
and copies the body of the file from the standard
input to the standard output.
.PP
The third form of
.I "getinfo \-c"
is followed by a command and its arguments, which is executed
on the data segment of the standard input.
The header is passed along, with the addition of the command
at the end.
This is roughly equivalent to the following sequence, but does not
require the input to be in a file:
.IP "" .2i
( getinfo < input ; getinfo - < input | command .. )
.SH EXAMPLE
To print the header information from scene1.oct and scene2.hdr:
.IP "" .2i
getinfo scene1.oct scene2.hdr
.SH AUTHOR
Greg Ward
.SH "SEE ALSO"
oconv(1), pfilt(1), rcalc(1), rhinfo(1), rpict(1), rvu(1)
Revision:	1.6
Committed:	Mon Jul 28 17:25:03 2014 UTC (9 years, 10 months ago) by greg
Branch:	MAIN
CVS Tags:	rad4R2P2, rad5R0, rad4R2, rad4R2P1
Changes since 1.5:	+20 -3 lines
Log Message:	Added "-c" option to getinfo for operating on data segment
#	User	Rev	Content
1	greg	1.6	.\" RCSid "$Id: getinfo.1,v 1.5 2008/11/10 19:08:17 greg Exp $"
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	greg	1.6	.br
16			.B getinfo
17			.B -c
18			.B "command .."
19	greg	1.1	.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	greg	1.4	prints the y and x resolution (\-Y yres +X xres).
40	greg	1.1	If no
41			.I file
42			is given, the standard input is read.
43			.PP
44	greg	1.6	The second form of
45			.I getinfo
46			with a hyphen simply removes the header
47	greg	1.1	and copies the body of the file from the standard
48			input to the standard output.
49	greg	1.6	.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	greg	1.1	.SH EXAMPLE
61	greg	1.5	To print the header information from scene1.oct and scene2.hdr:
62	greg	1.1	.IP "" .2i
63	greg	1.5	getinfo scene1.oct scene2.hdr
64	greg	1.1	.SH AUTHOR
65			Greg Ward
66			.SH "SEE ALSO"
67	greg	1.6	oconv(1), pfilt(1), rcalc(1), rhinfo(1), rpict(1), rvu(1)