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