| 1 | .TH RCODE2BMP 1 7/25/2019 RADIANCE | 
| 2 | .SH NAME | 
| 3 | rcode2bmp - convert identifier, depth, and normal maps to BMP images | 
| 4 | .SH SYNOPSIS | 
| 5 | .B rcode2bmp | 
| 6 | [ | 
| 7 | .B "\-x xres \-y yres" | 
| 8 | ] | 
| 9 | .B input1.typ | 
| 10 | [ | 
| 11 | .B "input2.typ .." | 
| 12 | ] | 
| 13 | .SH DESCRIPTION | 
| 14 | .I Ra_bmp | 
| 15 | converts each input map to a suitable visualization as a BMP image. | 
| 16 | Supported types include Radiance pictures and hyperspectral images, | 
| 17 | depth maps produced by | 
| 18 | .I rcode_depth(1), | 
| 19 | identifier maps from | 
| 20 | .I rcode_ident(1), | 
| 21 | and surface normal maps from | 
| 22 | .I rcode_norm(1). | 
| 23 | Each input file is identified by the FORMAT string it its header, | 
| 24 | and if it belongs to one of the supported types, a new file with the | 
| 25 | same name will be created with its suffix replaced by ".bmp". | 
| 26 | If a previous BMP file exists with the same name, it will be overwritten. | 
| 27 | .PP | 
| 28 | Radiance pictures are tone-mapped as if calling: | 
| 29 | .IP "" .2i | 
| 30 | ra_bmp -e auto file.hdr file.bmp | 
| 31 | .PP | 
| 32 | If the | 
| 33 | .I \-x | 
| 34 | and | 
| 35 | .I \-y | 
| 36 | options are given, these will be used as the maximum output image dimensions, | 
| 37 | and this holds for all input types. | 
| 38 | .PP | 
| 39 | Depth maps from | 
| 40 | .I rcode_depth | 
| 41 | are processed using | 
| 42 | .I falsecolor(1) | 
| 43 | with an appropriate scale and label. | 
| 44 | .PP | 
| 45 | Identifier maps from | 
| 46 | .I rcode_ident | 
| 47 | are assigned a random color for each identifier. | 
| 48 | .PP | 
| 49 | Surface normal maps are processed using an HSV (hue, saturation, value) | 
| 50 | color space that assigns normal orientation | 
| 51 | to a hue angle, and saturation runs from 0 when the normal is aligned to | 
| 52 | the view origin, to maximum saturation at tangential edges. | 
| 53 | Back-facing normals will be darker -- a normal in the direction opposite | 
| 54 | to the viewer being pure black. | 
| 55 | .SH AUTHOR | 
| 56 | Greg Ward | 
| 57 | .SH "SEE ALSO" | 
| 58 | falsecolor(1), ra_bmp(1), rcode_depth(1), rcode_ident(1), rcode_norm(1), | 
| 59 | rcomb(1), rtpict(1) |