home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 16 / CD_ASCQ_16_0994.iso / news / 2555 / povhlp / spotlgt.hlp < prev    next >
Encoding:
Text File  |  1994-07-04  |  3.1 KB  |  79 lines
  1.     A spotlight is a point light source where the rays of light are cons-
  2.  trained by a cone.  The light is bright in the center of the spotlight and
  3.  falls off/darkens to soft shadows at the edges of the circle.  The syntax
  4.  is:
  5.        light_source {
  6.           <CENTER>
  7.           color red #, green #, blue #
  8.           spotlight
  9.           point_at <POINT>
  10.           radius #
  11.           falloff #
  12.           tightness #
  13.        }
  14.  
  15.     A spotlight is positioned using two vectors.  The first vector is the
  16.  usual <CENTER> vector that you would use to position a point light source.
  17.  The second vector is the point_at <POINT>, the vector position of the point
  18.  the light is pointing at, similar to the look_at in a camera description.
  19.  
  20.     The following illustrations will be helpful in understanding how these
  21.  values relate to each other:
  22.  
  23.             (+) Spotlight <center>
  24.             / \
  25.            /   \
  26.           /     \
  27.          /       \
  28.         /         \
  29.        /           \
  30.        +-----*-----+
  31.              ^ point_at <point>
  32.  
  33.     The center is specified the same way as a normal point light_source.
  34.  Point_at <POINT> is the location that the cone of light is aiming at.  Spot-
  35.  lights also have three other parameters: radius, falloff, and tightness.
  36.  
  37.     If you think of a spotlight as two nested cones,  the inner cone would be
  38.  specified by the radius parameter, and would be fully lit.  The outer cone
  39.  would be the falloff cone and beyond it would be totally unlit.  The values
  40.  for these two parameters are specified in degrees of the half angle at the
  41.  peak of each cone:
  42.  
  43.        (+) Spotlight <center>
  44.         |\ <-----  angle measured here
  45.         | \
  46.         || \
  47.         ||  \      shaded area = radius cone
  48.         |||  \     outer line = falloff cone
  49.         ||||  \
  50.         |||||  \
  51.         +-------+
  52.  
  53.     The radius # is the radius, in degrees, of the bright circular hotspot at
  54.  the center of the spotlight's area of affect.  The falloff # is the falloff
  55.  angle of the radius of the total spotlight area, in degrees.  This is the
  56.  value where the light 'falls off' to zero brightness.  Falloff should be
  57.  larger than the radius.  Both values should be between 1 and 180.
  58.  
  59.     The tightness value specifies how quickly the light dims, or falls off,
  60.  in the region between the radius (full brightness) cone and the falloff
  61.  (full darkness) cone.  The default value for tightness is 10.  Lower tight-
  62.  ness values will make the spot have very soft edges.  High values will make
  63.  the edges sharper, the spot 'tighter'.  Values from 1 to 100 are acceptable.
  64.  
  65.     Spotlights may used anyplace that a normal light source is used.  Like
  66.  normal light sources, they are invisible points.  They are treated as shapes
  67.  and may be included in CSG shapes.  They may also be used in conjunction
  68.  with area_lights.  For example:
  69.        // This is the spotlight.
  70.        light_source {
  71.           <10, 10, 0>
  72.           color red 1, green 1, blue 0.5
  73.           spotlight
  74.           point_at <0, 1, 0>
  75.           tightness 50
  76.           radius 11
  77.           falloff 25
  78.        }
  79.