ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/doc/man/man1/rcode2bmp.1
Revision: 1.1
Committed: Fri Jul 26 01:32:32 2019 UTC (5 years, 9 months ago) by greg
Branch: MAIN
CVS Tags: rad5R4, rad5R3
Log Message:
Added man page for rcode2bmp

File Contents

# User Rev Content
1 greg 1.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, depth maps produced by
17     .I rcode_depth(1),
18     identifier maps from
19     .I rcode_ident(1),
20     and surface normal maps from
21     .I rcode_norm(1).
22     Each input file is identified by the FORMAT string it its header,
23     and if it belongs to one of the supported types, a new file with the
24     same name will be created with its suffix replaced by ".bmp".
25     If a previous BMP file exists with the same name, it will be overwritten.
26     .PP
27     Radiance pictures are tone-mapped as if calling:
28     .IP "" .2i
29     ra_bmp -e auto file.hdr file.bmp
30     .PP
31     If the
32     .I \-x
33     and
34     .I \-y
35     options are given, these will be used as the maximum output image dimensions,
36     and this holds for all input types.
37     .PP
38     Depth maps from
39     .I rcode_depth
40     are processed using
41     .I falsecolor(1)
42     with an appropriate scale and label.
43     .PP
44     Identifier maps from
45     .I rcode_ident
46     are assigned a random color for each identifier.
47     .PP
48     Surface normal maps are processed using an HSV (hue, saturation, value)
49     color space that assigns normal orientation
50     to a hue angle, and saturation runs from 0 when the normal is aligned to
51     the view origin, to maximum saturation at tangential edges.
52     Back-facing normals will be darker -- a normal in the direction opposite
53     to the viewer being pure black.
54     .SH AUTHOR
55     Greg Ward
56     .SH "SEE ALSO"
57     falsecolor(1), ra_bmp(1), rcode_depth(1), rcode_ident(1), rcode_norm(1),
58     rtpict(1)