man/man1/falsecolor.1

.\" RCSid "$Id"
.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 "\-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.
.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.1
Committed:	Tue Mar 11 19:20:21 2003 UTC (21 years, 2 months ago) by greg
Branch:	MAIN
CVS Tags:	rad3R5
Log Message:	Added documentation to repository
#	User	Rev	Content
1	greg	1.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)