FALSECOLOR(1)                                                    FALSECOLOR(1)



NNAAMMEE
       falsecolor - make a false color RADIANCE picture

SSYYNNOOPPSSIISS
       ffaallsseeccoolloorr  [  --ii iinnppuutt ][ --pp ppiiccttuurree ][ --ccbb || --ccll ][ --ee ][ --ss ssccaallee ][
       --ll llaabbeell ][ --nn nnddiivvss ][ --llww llwwiiddtthh ][ --llhh llhheeiigghhtt ][ --lloogg ddeeccaaddeess ][ --mm
       mmuulltt ][ --rr rreeddvv ][ --gg ggrrnnvv ][ --bb bblluuvv ]

DDEESSCCRRIIPPTTIIOONN
       _F_a_l_s_e_c_o_l_o_r produces a false color picture for lighting analysis.  Input
       is a rendered Radiance picture.

       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  _-_s  option.
       The  default multiplier is 179, which converts from radiance or irradi-
       ance to luminance or illuminance, respectively.  A different multiplier
       can  be given with _-_m to get daylight factors or whatever.  For a loga-
       rithmic rather than a linear mapping, the  _-_l_o_g  option  can  be  used,
       where _d_e_c_a_d_e_s is the number of decades below the maximum scale desired.

       A legend is produced for the new image with a label  given  by  the  _-_l
       option.  The default label is "Nits", which is appropriate for standard
       Radiance images.  If the _-_i option of _r_p_i_c_t_(_1_) was used to produce  the
       image, then the appropriate label would be "Lux".

       If  contour  lines  are  desired  rather than just false color, the _-_c_l
       option can be used.  These lines can be placed  over  another  Radiance
       picture  using  the  _-_p option.  If the input picture is given with _-_i_p
       instead of _-_i_, then it will be used both as the source of values and as
       the  picture to overlay with contours.  The _-_c_b option produces contour
       bands instead of lines, where the thickness of the bands is related  to
       the  rate  of change in the image.  The _-_n option can be used to change
       the number of contours (and  corresponding  legend  entries)  from  the
       default  value of 8.  The _-_l_w and _-_l_h 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.

       The  _-_e option causes extrema points to be printed on the brightest and
       darkest pixels of the input picture.

       The remaining options, _-_r_, _-_g_, and _-_b are for changing the  mapping  of
       values  to  colors.   These  are expressions of the variable _v_, where _v
       varies from 0 to 1.  These options are not recommended for  the  casual
       user.

       If no _-_i or _-_i_p option is used, input is taken from the standard input.
       The output image is always written to standard output, which should  be
       redirected.

EEXXAAMMPPLLEESS
       To create a false color image directly from _r_p_i_c_t_(_1_)_:

         rpict -vf default.vp scene.oct | falsecolor > scene.pic

       To  create  a logarithmic contour plot of illuminance values on a Radi-
       ance image:

         rpict -i -vf default.vp scene.oct > irrad.pic
         rpict -vf default.vp scene.oct > rad.pic
         falsecolor -i irrad.pic -p rad.pic -cl -log 2 -l Lux > lux.pic

AAUUTTHHOORR
       Greg Ward

AACCKKNNOOWWLLEEDDGGEEMMEENNTT
       Work on this program was initiated and sponsored by the LESO  group  at
       EPFL in Switzerland.

SSEEEE AALLSSOO
       getinfo(1),  pcomb(1), pcompos(1), pextrem(1), pfilt(1), pflip(1), pro-
       tate(1), psign(1), rpict(1), ximage(1)



RADIANCE                           11/15/93                      FALSECOLOR(1)
