1 |
.\" RCSid "$Id$" |
2 |
.TH FALSECOLOR 1 11/15/93 RADIANCE |
3 |
.SH NAME |
4 |
falsecolor - make a false color RADIANCE picture |
5 |
.SH SYNOPSIS |
6 |
.B falsecolor |
7 |
[ |
8 |
.B "\-i input" |
9 |
][ |
10 |
.B "\-p picture" |
11 |
][ |
12 |
.B "\-cb | \-cl" |
13 |
][ |
14 |
.B \-e |
15 |
][ |
16 |
.B "\-s scale" |
17 |
][ |
18 |
.B "\-l label" |
19 |
][ |
20 |
.B "\-n ndivs" |
21 |
][ |
22 |
.B "\-log decades" |
23 |
][ |
24 |
.B "\-m mult" |
25 |
][ |
26 |
.B "\-r redv" |
27 |
][ |
28 |
.B "\-g grnv" |
29 |
][ |
30 |
.B "\-b bluv" |
31 |
] |
32 |
.SH DESCRIPTION |
33 |
.I Falsecolor |
34 |
produces a false color picture for lighting analysis. |
35 |
Input is a rendered Radiance picture. |
36 |
.PP |
37 |
By default, luminance is displayed on a linear scale from 0 to 1000 nits, where |
38 |
dark areas are blue and brighter areas move through the spectrum to red. |
39 |
A different scale can be given with the |
40 |
.I \-s |
41 |
option. |
42 |
The default multiplier is 179, which converts from radiance or irradiance |
43 |
to luminance or illuminance, respectively. |
44 |
A different multiplier can be given with |
45 |
.I \-m |
46 |
to get daylight factors or whatever. |
47 |
For a logarithmic rather than a linear mapping, the |
48 |
.I \-log |
49 |
option can be used, where |
50 |
.I decades |
51 |
is the number of decades below the maximum scale desired. |
52 |
.PP |
53 |
A legend is produced for the new image with a label given by the |
54 |
.I \-l |
55 |
option. |
56 |
The default label is "Nits", which is appropriate for standard Radiance |
57 |
images. |
58 |
If the |
59 |
.I -i |
60 |
option of |
61 |
.I rpict(1) |
62 |
was used to produce the image, then the appropriate label would be "Lux". |
63 |
.PP |
64 |
If contour lines are desired rather than just false color, the |
65 |
.I \-cl |
66 |
option can be used. |
67 |
These lines can be placed over another Radiance picture using the |
68 |
.I -p |
69 |
option. |
70 |
If the input picture is given with |
71 |
.I \-ip |
72 |
instead of |
73 |
.I \-i, |
74 |
then it will be used both as the source of values and as the picture |
75 |
to overlay with contours. |
76 |
The |
77 |
.I \-cb |
78 |
option produces contour bands instead of lines, where the thickness of |
79 |
the bands is related to the rate of change in the image. |
80 |
The |
81 |
.I \-n |
82 |
option can be used to change the number of contours (and corresponding |
83 |
legend entries) from the default value of 8. |
84 |
.PP |
85 |
The |
86 |
.I \-e |
87 |
option causes extrema points to be printed on the brightest and |
88 |
darkest pixels of the input picture. |
89 |
.PP |
90 |
The remaining options, |
91 |
.I "\-r, \-g," |
92 |
and |
93 |
.I \-b |
94 |
are for changing the mapping of values to colors. |
95 |
These are expressions of the variable |
96 |
.I v, |
97 |
where |
98 |
.I v |
99 |
varies from 0 to 1. |
100 |
These options are not recommended for the casual user. |
101 |
.PP |
102 |
If no |
103 |
.I \-i |
104 |
or |
105 |
.I \-ip |
106 |
option is used, input is taken from the standard input. |
107 |
The output image is always written to standard output, which should |
108 |
be redirected. |
109 |
.SH EXAMPLES |
110 |
To create a false color image directly from |
111 |
.I rpict(1): |
112 |
.IP "" .2i |
113 |
rpict -vf default.vp scene.oct | falsecolor > scene.pic |
114 |
.PP |
115 |
To create a logarithmic contour plot of illuminance values on a |
116 |
Radiance image: |
117 |
.IP "" .2i |
118 |
rpict -i -vf default.vp scene.oct > irrad.pic |
119 |
.br |
120 |
rpict -vf default.vp scene.oct > rad.pic |
121 |
.br |
122 |
falsecolor -i irrad.pic -p rad.pic -cl -log 2 -l Lux > lux.pic |
123 |
.SH AUTHOR |
124 |
Greg Ward |
125 |
.SH ACKNOWLEDGEMENT |
126 |
Work on this program was initiated and sponsored by the LESO |
127 |
group at EPFL in Switzerland. |
128 |
.SH "SEE ALSO" |
129 |
getinfo(1), pcomb(1), pcompos(1), pextrem(1), pfilt(1), pflip(1), protate(1), |
130 |
psign(1), rpict(1), ximage(1) |