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 ][ --ssppeecc ][ --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.
       If  the  argument  given  to _-_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 _-_m to get  day-
       light factors or whatever.  For a logarithmic rather than a linear map-
       ping, 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  _-_s_p_e_c  option reinstates the old, spectral color scale used in the
       original _f_a_l_s_e_c_o_l_o_r_.  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  recom-
       mended 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.hdr

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

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

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)
