| 1 | .\" RCSid "$Id: lookamb.1,v 1.2 2003/12/09 15:59:06 greg Exp $" | 
| 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 rvu(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), rvu(1) |