ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/doc/man/man1/getinfo.1
(Generate patch)

Comparing ray/doc/man/man1/getinfo.1 (file contents):
Revision 1.4 by greg, Tue Sep 4 17:36:40 2007 UTC vs.
Revision 1.9 by greg, Tue Jul 16 17:07:35 2019 UTC

# Line 6 | Line 6 | getinfo - get header information from a RADIANCE file
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
# Line 33 | Line 51 | 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 getinfo with a hyphen simply removes the header
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 < .SH EXAMPLE
67 < To print the header information from scene1.oct and scene2.pic:
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 scene1.oct scene2.pic
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), rhinfo(1), rpict(1), rvu(1)
116 > oconv(1), pfilt(1), rcalc(1), rhinfo(1), rpict(1), rsplit(1), rtrace(1), rvu(1)

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines