diff -r d960df03359f -r a5d25b4668ac man/man1/falsecolor.1
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/man/man1/falsecolor.1	Sun Jun 26 16:57:40 2011 +0100
@@ -0,0 +1,160 @@
+.\" RCSid "$Id: falsecolor.1,v 1.8 2010/10/05 01:07:16 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 "\-pal palette"
+][
+.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.
+If the argument given to
+.I \-s
+begins with an "a" for "auto," then the maximum is used for scaling the result.
+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
+.I "\-pal"
+option provides different color palettes for
+.I falsecolor.
+The current choices are
+.I spec
+for the old spectral mapping,
+.I hot
+for a thermal scale, and
+.I pm3d
+for a variation of the default mapping,
+.I def.
+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.hdr
+.PP
+To create a logarithmic contour plot of illuminance values on a
+Radiance image:
+.IP "" .2i
+rpict \-i \-vf default.vp scene.oct > irrad.hdr
+.br
+rpict \-vf default.vp scene.oct > rad.hdr
+.br
+falsecolor \-i irrad.hdr \-p rad.hdr \-cl \-log 2 \-l Lux > lux.hdr
+.SH AUTHOR
+Greg Ward
+.br
+Axel Jacobs (Perl translation and -pal options)
+.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)