NAME

       SoSpotLight — node representing a spotlight source

INHERITS FROM

       SoBase > SoFieldContainer > SoNode > SoLight > SoSpotLight

SYNOPSIS

       #include <Inventor/nodes/SoSpotLight.h>

          Fields from class SoSpotLight:

     SoSFVec3f           location
     SoSFVec3f           direction
     SoSFFloat           dropOffRate
     SoSFFloat           cutOffAngle

          Fields from class SoLight:

     SoSFBool            on
     SoSFFloat           intensity
     SoSFColor           color

          Methods from class SoSpotLight:

                         SoSpotLight()
     static SoType       getClassTypeId()

          Methods from class SoNode:

     void                setOverride(SbBool state)
     SbBool              isOverride() const
     SoNode *            copy(SbBool copyConnections = FALSE) const
     virtual SbBool      affectsState() const
     static SoNode *     getByName(const SbName &name)
     static int          getByName(const SbName &name, SoNodeList &list)

          Methods from class SoFieldContainer:

     void                setToDefaults()
     SbBool              hasDefaultValues() const
     SbBool              fieldsAreEqual(const SoFieldContainer *fc) const
     void                copyFieldValues(const  SoFieldContainer  *fc,  SbBool  copyConnections =
                              FALSE)
     SbBool              set(const char *fieldDataString)
     void                get(SbString &fieldDataString)
     virtual int         getFields(SoFieldList &resultList) const
     virtual SoField *   getField(const SbName &fieldName) const
     SbBool              getFieldName(const SoField *field, SbName &fieldName) const
     SbBool              isNotifyEnabled() const
     SbBool              enableNotify(SbBool flag)

          Methods from class SoBase:

     void                ref()
     void                unref() const
     void                unrefNoDelete() const
     void                touch()
     virtual SoType      getTypeId() const
     SbBool              isOfType(SoType type) const
     virtual void        setName(const SbName &name)
     virtual SbName      getName() const

DESCRIPTION

       This node defines a spotlight style light  source.  A  spotlight  is  placed  at  a  fixed
       location  in 3-space and illuminates in a cone along a particular direction. The intensity
       of the illumination drops off exponentially as a ray of light diverges from this direction
       toward  the  edges  of  the  cone.  The  rate  of  drop-off  and the angle of the cone are
       controlled by the dropOffRate and cutOffAngle fields.

FIELDS

     SoSFVec3f           location
          Location of the source.

     SoSFVec3f           direction
          Principal direction of illumination (center axis of cone).

     SoSFFloat           dropOffRate
          Rate of intensity drop-off per change in angle from primary  direction:  0  =  constant
          intensity, 1 = very sharp drop-off

     SoSFFloat           cutOffAngle
          Angle (in radians) outside of which intensity is zero, measured from the center axis of
          the cone to an edge.

METHODS

                         SoSpotLight()
          Creates a spotlight source node with default settings.

     static SoType       getClassTypeId()
          Returns type identifier for this class.

ACTION BEHAVIOR

       SoGLRenderAction
          Activates this light (if so specified) during traversal.  All  shape  nodes  that  come
          after this light in the scene graph are illuminated by this light. The light's location
          is affected by the current transformation.

FILE FORMAT/DEFAULTS

       SpotLight {
          on           TRUE
          intensity    1
          color        1 1 1
          location     0 0 1
          direction    0 0 -1
          dropOffRate  0
          cutOffAngle  0.785398
     }

SEE ALSO

       SoDirectionalLight, SoPointLight

                                                                               SoSpotLight(3IV)()