man/man1/getinfo.1

.\" RCSid "$Id: getinfo.1,v 1.8 2019/07/06 14:08:07 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 +d
][
.B "file .."
]
.br
.B getinfo
[
.B -d
]
-
.br
.B getinfo
.B -a
.B "info_line1 .."
.br
.B getinfo
[
.B -d
|
.B +d
]
.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).
The
.I \+d
option prints the header followed by a newline and the dimensions.
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.
If the
.I \-d
option is given, then the resolution string will be elided as well.
.PP
The third form of
.I "getinfo \-a"
adds one or more header lines to the standard input.
These lines are given as arguments to
.I getinfo,
and must be quoted if they contain spaces.
.PP
The fourth 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 .. )
.PP
If the
.I \+d
option is given with
.I \-c,
then the resolution string will be copied before the command is called.
If the
.I \-d
option is given, then the resolution string is read in but not copied.
.SH EXAMPLES
To print the header information from scene1.oct and scene2.hdr:
.IP "" .2i
getinfo scene1.oct scene2.hdr
.PP
To print the dimensions of a set of pictures:
.IP "" .2i
getinfo -d *.hdr
.PP
To add two header lines modifying the view
and exposure calibration of a picture:
.IP "" .2i
getinfo -a "VIEW= -vta -vh 180 -vv 180" "EXPOSURE=1.5" < orig.hdr > modified.hdr
.PP
To raise floating-point matrix elements to a power of 2.7:
.IP "" .2i
getinfo -c rcalc -if -of -e '$1=$1^2.7' < input.fmx > output.fmx
.SH AUTHOR
Greg Ward
.SH "SEE ALSO"
oconv(1), pfilt(1), rcalc(1), rhinfo(1), rpict(1), rsplit(1), rtrace(1), rvu(1)
Revision:	1.9
Committed:	Tue Jul 16 17:07:35 2019 UTC (5 years, 11 months ago) by greg
Branch:	MAIN
CVS Tags:	rad5R3
Changes since 1.8:	+29 -5 lines
Log Message:	Created getinfo +d option for additional flexibility
#	Content
1	.\" RCSid "$Id: getinfo.1,v 1.8 2019/07/06 14:08:07 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 +d
11	][
12	.B "file .."
13	]
14	.br
15	.B getinfo
16	[
17	.B -d
18	]
19	-
20	.br
21	.B getinfo
22	.B -a
23	.B "info_line1 .."
24	.br
25	.B getinfo
26	[
27	.B -d
28	\|
29	.B +d
30	]
31	.B -c
32	.B "command .."
33	.SH DESCRIPTION
34	.I Getinfo
35	reads the header of each RADIANCE
36	.I file
37	and writes it to the standard output.
38	Octree and picture files are in a binary format, which makes
39	it difficult to determine their content.
40	Therefore, a few lines of text are placed at the beginning
41	of each file by the RADIANCE program that creates it.
42	The end of the header information and the start of the
43	data is indicated by an empty line.
44	The
45	.I \-d
46	option can be used to print the dimensions of an octree or
47	picture file instead.
48	For an octree,
49	.I "getinfo \-d"
50	prints the bounding cube (xmin ymin zmin size).
51	For a picture,
52	.I "getinfo \-d"
53	prints the y and x resolution (\-Y yres +X xres).
54	The
55	.I \+d
56	option prints the header followed by a newline and the dimensions.
57	If no
58	.I file
59	is given, the standard input is read.
60	.PP
61	The second form of
62	.I getinfo
63	with a hyphen simply removes the header
64	and copies the body of the file from the standard
65	input to the standard output.
66	If the
67	.I \-d
68	option is given, then the resolution string will be elided as well.
69	.PP
70	The third form of
71	.I "getinfo \-a"
72	adds one or more header lines to the standard input.
73	These lines are given as arguments to
74	.I getinfo,
75	and must be quoted if they contain spaces.
76	.PP
77	The fourth form of
78	.I "getinfo \-c"
79	is followed by a command and its arguments, which is executed
80	on the data segment of the standard input.
81	The header is passed along, with the addition of the command
82	at the end.
83	This is roughly equivalent to the following sequence, but does not
84	require the input to be in a file:
85	.IP "" .2i
86	( getinfo < input ; getinfo - < input \| command .. )
87	.PP
88	If the
89	.I \+d
90	option is given with
91	.I \-c,
92	then the resolution string will be copied before the command is called.
93	If the
94	.I \-d
95	option is given, then the resolution string is read in but not copied.
96	.SH EXAMPLES
97	To print the header information from scene1.oct and scene2.hdr:
98	.IP "" .2i
99	getinfo scene1.oct scene2.hdr
100	.PP
101	To print the dimensions of a set of pictures:
102	.IP "" .2i
103	getinfo -d *.hdr
104	.PP
105	To add two header lines modifying the view
106	and exposure calibration of a picture:
107	.IP "" .2i
108	getinfo -a "VIEW= -vta -vh 180 -vv 180" "EXPOSURE=1.5" < orig.hdr > modified.hdr
109	.PP
110	To raise floating-point matrix elements to a power of 2.7:
111	.IP "" .2i
112	getinfo -c rcalc -if -of -e '$1=$1^2.7' < input.fmx > output.fmx
113	.SH AUTHOR
114	Greg Ward
115	.SH "SEE ALSO"
116	oconv(1), pfilt(1), rcalc(1), rhinfo(1), rpict(1), rsplit(1), rtrace(1), rvu(1)