Radiance falsecolor program



FALSECOLOR(1)                                                    FALSECOLOR(1)




NAME

       falsecolor - make a false color RADIANCE picture


SYNOPSIS

       falsecolor  [  -i input ][ -p picture ][ -cb | -cl ][ -e ][ -s scale ][
       -l label ][ -n ndivs ][ -lw lwidth ][ -lh lheight ][ -log decades ][ -m
       mult ][ -r redv ][ -g grnv ][ -b bluv ]


DESCRIPTION

       Falsecolor 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  -log  option  can  be  used,
       where decades 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 rpict(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 -cl
       option can be used.  These lines can be placed  over  another  Radiance
       picture  using  the  -p option.  If the input picture is given with -ip
       instead of -i, then it will be used both as the source of values and as
       the  picture to overlay with contours.  The -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 -n option can be used to change
       the number of contours (and  corresponding  legend  entries)  from  the
       default  value of 8.  The -lw and -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.

       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 -ip option is used, input is taken from the standard input.
       The output image is always written to standard output, which should  be
       redirected.


EXAMPLES

       To create a false color image directly from rpict(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


AUTHOR

       Greg Ward


ACKNOWLEDGEMENT

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


SEE ALSO

       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)

Man(1) output converted with man2html