man/man1/falsecolor.1

.\" RCSid "$Id: falsecolor.1,v 1.2 2003/12/09 15:59:06 greg Exp $"
.TH FALSECOLOR 1 11/15/93 RADIANCE
.SH NAME
falsecolor - make a false color RADIANCE picture
.SH SYNOPSIS
.B falsecolor
[
.B "\-i input"
][
.B "\-p picture"
][
.B "\-cb | \-cl"
][
.B \-e
][
.B "\-s scale"
][
.B "\-l label"
][
.B "\-n ndivs"
][
.B "\-lw lwidth"
][
.B "\-lh lheight"
][
.B "\-log decades"
][
.B "\-m mult"
][
.B "\-r redv"
][
.B "\-g grnv"
][
.B "\-b bluv"
]
.SH DESCRIPTION
.I Falsecolor
produces a false color picture for lighting analysis.
Input is a rendered Radiance picture.
.PP
By default, luminance is displayed on a linear scale from 0 to 1000 nits, where
dark areas are blue and brighter areas move through the spectrum to red.
A different scale can be given with the
.I \-s
option.
The default multiplier is 179, which converts from radiance or irradiance
to luminance or illuminance, respectively.
A different multiplier can be given with
.I \-m
to get daylight factors or whatever.
For a logarithmic rather than a linear mapping, the
.I \-log
option can be used, where
.I decades
is the number of decades below the maximum scale desired.
.PP
A legend is produced for the new image with a label given by the
.I \-l
option.
The default label is "Nits", which is appropriate for standard Radiance
images.
If the
.I -i
option of
.I rpict(1)
was used to produce the image, then the appropriate label would be "Lux".
.PP
If contour lines are desired rather than just false color, the
.I \-cl
option can be used.
These lines can be placed over another Radiance picture using the
.I -p
option.
If the input picture is given with
.I \-ip
instead of
.I \-i,
then it will be used both as the source of values and as the picture
to overlay with contours.
The
.I \-cb
option produces contour bands instead of lines, where the thickness of
the bands is related to the rate of change in the image.
The
.I \-n
option can be used to change the number of contours (and corresponding
legend entries) from the default value of 8.
The
.I \-lw
and
.I \-lh
options may be used to change the legend dimensions from the default width
and height of 100x200.
A value of zero in either eliminates the legend in the output.
.PP
The
.I \-e
option causes extrema points to be printed on the brightest and
darkest pixels of the input picture.
.PP
The remaining options,
.I "\-r, \-g,"
and
.I \-b
are for changing the mapping of values to colors.
These are expressions of the variable 
.I v,
where
.I v
varies from 0 to 1.
These options are not recommended for the casual user.
.PP
If no
.I \-i
or
.I \-ip
option is used, input is taken from the standard input.
The output image is always written to standard output, which should
be redirected.
.SH EXAMPLES
To create a false color image directly from
.I rpict(1):
.IP "" .2i
rpict -vf default.vp scene.oct | falsecolor > scene.pic
.PP
To create a logarithmic contour plot of illuminance values on a
Radiance image:
.IP "" .2i
rpict -i -vf default.vp scene.oct > irrad.pic
.br
rpict -vf default.vp scene.oct > rad.pic
.br
falsecolor -i irrad.pic -p rad.pic -cl -log 2 -l Lux > lux.pic
.SH AUTHOR
Greg Ward
.SH ACKNOWLEDGEMENT
Work on this program was initiated and sponsored by the LESO
group at EPFL in Switzerland.
.SH "SEE ALSO"
getinfo(1), pcomb(1), pcompos(1), pextrem(1), pfilt(1), pflip(1), protate(1),
psign(1), rpict(1), ximage(1)
Revision:	1.3
Committed:	Mon Mar 8 21:39:31 2004 UTC (20 years, 2 months ago) by greg
Branch:	MAIN
CVS Tags:	rad3R7P2, rad3R7P1, rad3R6, rad3R6P1, rad3R8
Changes since 1.2:	+12 -1 lines
Log Message:	Put in Rob Guglielmetti's falsecolor -lw and -lh options
#	User	Rev	Content
1	greg	1.3	.\" RCSid "$Id: falsecolor.1,v 1.2 2003/12/09 15:59:06 greg Exp $"
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	greg	1.3	.B "\-lw lwidth"
23			][
24			.B "\-lh lheight"
25			][
26	greg	1.1	.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	greg	1.3	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	greg	1.1	.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)