1 |
greg |
1.2 |
.\" RCSid "$Id$" |
2 |
greg |
1.1 |
.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) |