| 1 | 
greg | 
1.1 | 
.\" RCSid "$Id" | 
| 2 | 
  | 
  | 
.TH LOOKAMB 1 11/15/93 RADIANCE | 
| 3 | 
  | 
  | 
.SH NAME | 
| 4 | 
  | 
  | 
lookamb - examine ambient file values | 
| 5 | 
  | 
  | 
.SH SYNOPSIS | 
| 6 | 
  | 
  | 
.B lookamb | 
| 7 | 
  | 
  | 
[ | 
| 8 | 
  | 
  | 
.B \-d | 
| 9 | 
  | 
  | 
][ | 
| 10 | 
  | 
  | 
.B \-r | 
| 11 | 
  | 
  | 
][ | 
| 12 | 
  | 
  | 
.B \-h | 
| 13 | 
  | 
  | 
] | 
| 14 | 
  | 
  | 
[ | 
| 15 | 
  | 
  | 
.B ambfile | 
| 16 | 
  | 
  | 
] | 
| 17 | 
  | 
  | 
.SH DESCRIPTION | 
| 18 | 
  | 
  | 
.I Lookamb | 
| 19 | 
  | 
  | 
examines an ambient file produced by | 
| 20 | 
  | 
  | 
.I rpict(1), | 
| 21 | 
  | 
  | 
.I rtrace(1), | 
| 22 | 
  | 
  | 
or | 
| 23 | 
  | 
  | 
.I rview(1). | 
| 24 | 
  | 
  | 
The default mode prints the position, direction, level, weight, | 
| 25 | 
  | 
  | 
radius, value, position gradient and direction gradient | 
| 26 | 
  | 
  | 
for each stored ambient value preceded by a | 
| 27 | 
  | 
  | 
label appropriate for human interpretation. | 
| 28 | 
  | 
  | 
The  | 
| 29 | 
  | 
  | 
.I \-d | 
| 30 | 
  | 
  | 
option prints the same quantities in 18 columns without any expanatory | 
| 31 | 
  | 
  | 
text, and is more appropriate as input to another program. | 
| 32 | 
  | 
  | 
.PP | 
| 33 | 
  | 
  | 
The | 
| 34 | 
  | 
  | 
.I \-r | 
| 35 | 
  | 
  | 
option performs the reverse conversion, taking the output of lookamb | 
| 36 | 
  | 
  | 
and reproducing the original ambient file on the standard output. | 
| 37 | 
  | 
  | 
.PP | 
| 38 | 
  | 
  | 
The | 
| 39 | 
  | 
  | 
.I \-h | 
| 40 | 
  | 
  | 
option causes lookamb not to print out the header information on the | 
| 41 | 
  | 
  | 
output, or not to expect it on the input with the | 
| 42 | 
  | 
  | 
.I \-r | 
| 43 | 
  | 
  | 
option. | 
| 44 | 
  | 
  | 
.PP | 
| 45 | 
  | 
  | 
If no file is given, | 
| 46 | 
  | 
  | 
.I lookamb | 
| 47 | 
  | 
  | 
reads from the standard input. | 
| 48 | 
  | 
  | 
.SH NOTES | 
| 49 | 
  | 
  | 
Before release 2.2 of Radiance, ambient files were in a | 
| 50 | 
  | 
  | 
machine-dependent format. | 
| 51 | 
  | 
  | 
Since that is no longer the case, ambient files can now be moved | 
| 52 | 
  | 
  | 
freely between machines without any conversions. | 
| 53 | 
  | 
  | 
Thus, the only reason to use | 
| 54 | 
  | 
  | 
.I lookamb | 
| 55 | 
  | 
  | 
now is to examine the contents of an ambient file. | 
| 56 | 
  | 
  | 
.SH AUTHOR | 
| 57 | 
  | 
  | 
Greg Ward | 
| 58 | 
  | 
  | 
.SH "SEE ALSO" | 
| 59 | 
  | 
  | 
getinfo(1), oconv(1), pfilt(1), pinterp(1), rpict(1), rtrace(1), rview(1) |