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.6 by greg, Mon Jul 28 17:25:03 2014 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 37 | 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 46 | 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"
76 + 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"
89   is followed by a command and its arguments, which is executed
90   on the data segment of the standard input.
# Line 57 | 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