| 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 |
| 38 |
|
.I Getinfo |
| 39 |
|
reads the header of each RADIANCE |
| 54 |
|
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). |
| 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. |
| 64 |
|
.PP |
| 65 |
< |
The second form of getinfo with a hyphen simply removes the header |
| 65 |
> |
The second form of |
| 66 |
> |
.I getinfo |
| 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 |
< |
.SH EXAMPLE |
| 71 |
< |
To print the header information from scene1.oct and scene2.pic: |
| 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. |
| 93 |
> |
The header is passed along, with the addition of the command |
| 94 |
> |
at the end. |
| 95 |
> |
This is roughly equivalent to the following sequence, but does not |
| 96 |
> |
require the input to be in a file: |
| 97 |
|
.IP "" .2i |
| 98 |
< |
getinfo scene1.oct scene2.pic |
| 98 |
> |
( getinfo < input ; getinfo - < input | command .. ) |
| 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), rhinfo(1), rpict(1), rvu(1) |
| 133 |
> |
oconv(1), pfilt(1), rcalc(1), rhinfo(1), rpict(1), rsplit(1), rtrace(1), rvu(1) |
