home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / video / render / radiance.lzh / ray / doc / cat1 / findglare.doc < prev    next >
Encoding:
Text File  |  1991-11-24  |  5.2 KB  |  199 lines
  1.  
  2.  
  3.  
  4. FINDGLARE(1)             USER COMMANDS               FINDGLARE(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      findglare - locate glare sources in a RADIANCE scene
  10.  
  11. SYNOPSIS
  12.      findglare [ -v ][ -ga angles ][ -t threshold ][  -r  resolu-
  13.      tion ][ -c ][ -p picture ][ view options ] [[ rtrace options
  14.      ] octree ]
  15.  
  16. DESCRIPTION
  17.      Findglare locates sources of glare in a specific set of hor-
  18.      izontal  directions  by  computing  luminance samples from a
  19.      RADIANCE picture and/or octree.  Findglare is intended  pri-
  20.      marily as a preprocessor for glare calculation programs such
  21.      as glarendx(1), and is usually accessed through  the  execu-
  22.      tive script glare(1).
  23.  
  24.      If only an octree is given, findglare calls rtrace  to  com-
  25.      pute  the samples it needs.  If both an octree and a picture
  26.      are specified, findglare calls rtrace only for samples  that
  27.      are outside the frame of the picture.  If findglare does not
  28.      have an octree and the picture does not completely cover the
  29.      area  of  interest,  a warning will be issued and everything
  30.      outside the picture will be treated as if it were black.  It
  31.      is  preferable  to  use  a picture with a fisheye view and a
  32.      horizontal and vertical size of at least 180  degrees  (more
  33.      horizontally  if the -ga option is used -- see below).  Note
  34.      that the picture file must contain correct  view  specifica-
  35.      tions,  as  maintained  by  rpict(1), rview(1), pfilt(1) and
  36.      pinterp(1). Specifically, findglare will not  work  on  pic-
  37.      tures processed by pcompos(1) or pcomb(1). It is also essen-
  38.      tial to give the proper rtrace options  when  an  octree  is
  39.      used so that the calculated luminance values are correct.
  40.  
  41.      The output of findglare is a list  of  glare  source  direc-
  42.      tions,  solid  angles and average luminances, plus a list of
  43.      indirect vertical illuminance values as a function of angle.
  44.      Angles  are  measured  in degrees from the view center, with
  45.      positive angles to the  left  and  negative  angles  to  the
  46.      right.
  47.  
  48.      By  default,  findglare  only  computes  glare  sources  and
  49.      indirect vertical illuminance for the given view (taken from
  50.      the picture if none is specified).  If the view direction is
  51.      not  horizontal to begin with (ie. perpendicular to the view
  52.      up vector), findglare will substitute the closest horizontal
  53.      direction as its view center.  The -ga option can be used to
  54.      specify a set of directions to consider about the center  of
  55.      view.  This specification is given by a starting angle, end-
  56.      ing angle, and step angle like so:
  57.           start-end:step
  58.      All angles must be whole degrees within the range 1 to  180.
  59.      Multiple  angle  ranges  may  be  separated  by  commas, and
  60.  
  61.  
  62.  
  63. Sun Release 4.1           Last change:                          1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. FINDGLARE(1)             USER COMMANDS               FINDGLARE(1)
  71.  
  72.  
  73.  
  74.      individual angles may be given without the ending  and  step
  75.      angles.  Note that findglare will complain if the same angle
  76.      is given  twice  either  explicitly  or  implicitly  by  two
  77.      ranges.
  78.  
  79.      Findglare normally identifies glare  sources  as  directions
  80.      that  are brighter than 7 times the average luminance level.
  81.      It is possible to override this determination by  giving  an
  82.      explicit luminance threshold with the -t option.  It usually
  83.      works best to use the 'l' command within ximage(1) to decide
  84.      what  this  value should be.  Alternatively, one can use the
  85.      't' command within rview(1). The idea is to pick a threshold
  86.      that  is  well  above the average level but smaller than the
  87.      source areas.
  88.  
  89.      If the sources in the scene are small, it may  be  necessary
  90.      to  increase  the  default sample resolution of findglare(1)
  91.      using the -r option.  The default resolution is 150 vertical
  92.      samples and a proportional number of horizontal samples.  If
  93.      besides being small, the sources are not much brighter  than
  94.      the  threshold,  the  -c  flag  should  be  used to override
  95.      findglare's default action of  absorbing  small  sources  it
  96.      deems to be insignificant.
  97.  
  98.      The -v  flag  switches  on  verbose  mode,  where  findglare
  99.      reports its progress during the calculation.
  100.  
  101. EXAMPLE
  102.      To calculate the glare sources in the image "scene.pic":
  103.  
  104.        findglare -p scene.pic > scene.glr
  105.  
  106.      To compute the Guth visual  comfort  probability  from  this
  107.      result:
  108.  
  109.        glarendx -t guth_vcp scene.glr
  110.  
  111.      To compute the glare for a set of  angles  around  the  view
  112.      "good.vp" from the octree "scene.oct" using an ambient level
  113.      of .1:
  114.  
  115.        findglare -vf good.vp -ga 10-60:10 -av .1 .1 .1  scene.oct
  116.        > scene.glr
  117.  
  118. AUTHOR
  119.      Greg Ward
  120.  
  121. ACKNOWLEDGEMENT
  122.      Work on this program was initiated and sponsored by the LESO
  123.      group at EPFL in Switzerland.
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Sun Release 4.1           Last change:                          2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. FINDGLARE(1)             USER COMMANDS               FINDGLARE(1)
  137.  
  138.  
  139.  
  140. SEE ALSO
  141.      getinfo(1),  glare(1),  glarendx(1),   pfilt(1),   rpict(1),
  142.      rtrace(1), rview(1), xglaresrc(1), ximage(1)
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195. Sun Release 4.1           Last change:                          3
  196.  
  197.  
  198.  
  199.