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.11 by greg, Mon Mar 21 17:12:49 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 + Any leading white space matches any leading number of spaces and
87 + tabs in the input header.
88 + .PP
89 + The fourth form of
90   .I "getinfo \-c"
91   is followed by a command and its arguments, which is executed
92   on the data segment of the standard input.
# Line 57 | Line 96 | This is roughly equivalent to the following sequence,
96   require the input to be in a file:
97   .IP "" .2i
98   ( getinfo < input ; getinfo - < input | command .. )
99 < .SH EXAMPLE
99 > .PP
100 > If the
101 > .I \+d
102 > option is given with
103 > .I \-c,
104 > then the resolution string will be copied before the command is called.
105 > If the
106 > .I \-d
107 > option is given, then the resolution string is read in but not copied.
108 > .SH EXAMPLES
109   To print the header information from scene1.oct and scene2.hdr:
110   .IP "" .2i
111   getinfo scene1.oct scene2.hdr
112 + .PP
113 + To print the dimensions of a set of pictures:
114 + .IP "" .2i
115 + getinfo -d *.hdr
116 + .PP
117 + To add two header lines modifying the view
118 + and exposure calibration of a picture:
119 + .IP "" .2i
120 + getinfo -a "VIEW= -vta -vh 180 -vv 180" "EXPOSURE=1.5" < orig.hdr > modified.hdr
121 + .PP
122 + To remove any indented lines containing "EXPOSURE=" and replace any
123 + left-justified "EXPOSURE=" lines with a single value of 16:
124 + .IP "" .2i
125 + getinfo -r " EXPOSURE=" "EXPOSURE=16" < orig.hdr > fixed.hdr
126 + .PP
127 + To raise floating-point matrix elements to a power of 2.7:
128 + .IP "" .2i
129 + getinfo -c rcalc -if -of -e '$1=$1^2.7' < input.fmx > output.fmx
130   .SH AUTHOR
131   Greg Ward
132   .SH "SEE ALSO"
133 < oconv(1), pfilt(1), rcalc(1), rhinfo(1), rpict(1), rvu(1)
133 > 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