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.7 by greg, Tue Aug 30 06:10:12 2016 UTC vs.
Revision 1.10 by greg, Mon Mar 21 00:21:13 2022 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 + {
23   .B -a
24 + |
25 + .B -r
26 + }
27   .B "info_line1 .."
28   .br
29   .B getinfo
30 + [
31 + .B -d
32 + |
33 + .B +d
34 + ]
35   .B -c
36   .B "command .."
37   .SH DESCRIPTION
# Line 41 | Line 55 | prints the bounding cube (xmin ymin zmin size).
55   For a picture,
56   .I "getinfo \-d"
57   prints the y and x resolution (\-Y yres +X xres).
58 + The
59 + .I \+d
60 + option prints the header followed by a newline and the dimensions.
61   If no
62   .I file
63   is given, the standard input is read.
# Line 50 | Line 67 | The second form of
67   with a hyphen simply removes the header
68   and copies the body of the file from the standard
69   input to the standard output.
70 + If the
71 + .I \-d
72 + option is given, then the resolution string will be elided as well.
73   .PP
74   The third form of
75   .I "getinfo \-a"
# Line 57 | Line 77 | adds one or more header lines to the standard input.
77   These lines are given as arguments to
78   .I getinfo,
79   and must be quoted if they contain spaces.
80 + The alternative form with
81 + .I \-r
82 + replaces any previous occurances of the settings in the given
83 + line(s) with nothing if there is only one word, or with
84 + the whole line if quoted and containing interior white space or
85 + an equals sign ('=').
86   .PP
87   The fourth form of
88   .I "getinfo \-c"
# Line 68 | Line 94 | This is roughly equivalent to the following sequence,
94   require the input to be in a file:
95   .IP "" .2i
96   ( getinfo < input ; getinfo - < input | command .. )
97 < .SH EXAMPLE
97 > .PP
98 > If the
99 > .I \+d
100 > option is given with
101 > .I \-c,
102 > then the resolution string will be copied before the command is called.
103 > If the
104 > .I \-d
105 > option is given, then the resolution string is read in but not copied.
106 > .SH EXAMPLES
107   To print the header information from scene1.oct and scene2.hdr:
108   .IP "" .2i
109   getinfo scene1.oct scene2.hdr
110 + .PP
111 + To print the dimensions of a set of pictures:
112 + .IP "" .2i
113 + getinfo -d *.hdr
114 + .PP
115 + To add two header lines modifying the view
116 + and exposure calibration of a picture:
117 + .IP "" .2i
118 + getinfo -a "VIEW= -vta -vh 180 -vv 180" "EXPOSURE=1.5" < orig.hdr > modified.hdr
119 + .PP
120 + To remove any indented lines containing "EXPOSURE=" and replace any
121 + left-justified "EXPOSURE=" lines with a single value of 16:
122 + .IP "" .2i
123 + getinfo -r " EXPOSURE=" "EXPOSURE=16" < orig.hdr > fixed.hdr
124 + .PP
125 + To raise floating-point matrix elements to a power of 2.7:
126 + .IP "" .2i
127 + getinfo -c rcalc -if -of -e '$1=$1^2.7' < input.fmx > output.fmx
128   .SH AUTHOR
129   Greg Ward
130   .SH "SEE ALSO"
131 < oconv(1), pfilt(1), rcalc(1), rhinfo(1), rpict(1), rvu(1)
131 > 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