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.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 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 + 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"
# Line 68 | 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