SoLight(3IV)

NAME
     SoLight (SoLight) - abstract base class for all light source nodes

INHERITS FROM
     SoBase > SoFieldContainer > SoNode > SoLight

SYNOPSIS
     #include <Inventor_c/nodes/SoLight.h>

          Fields from class SoLight:

     SoSFBool            on
     SoSFFloat           intensity
     SoSFColor           color

          Functions from class SoLight:

     SoType              SoLightGetClassTypeId()

          Functions from class SoNode:

     void                SoLightSetOverride(SoLight *this, SbBool state)
     SbBool              SoLightIsOverride(const SoLight *this)
     SoNode *            SoLightCopy(const SoLight *this, SbBool
                              copyConnections = FALSE)
     SbBool              SoLightAffectsState(const SoLight *this)
     SoNode *            SoLightGetByName(const char *name)
     int                 SoLightGetByNameList(const char *name, SoNodeList
                              *list)

          Functions from class SoFieldContainer:

     void                SoLightSetToDflts(SoLight *this)
     SbBool              SoLightHasDfltVals(const SoLight *this)
     SbBool              SoLightFldsAreEq(const SoLight *this, const
                              SoFieldContainer *fc)
     void                SoLightCopyFieldVals(SoLight *this, const
                              SoFieldContainer *fc, SbBool copyConnections =
                              FALSE)
     SbBool              SoLightSet(SoLight *this, const char
                              *fieldDataString)
     void                SoLightGet(SoLight *this, SbString *fieldDataString)
     int                 SoLightGetFields(const SoLight *this, SoFieldList
                              *resultList)
     SoField *           SoLightGetField(const SoLight *this, const char
                              *fieldName)
     SbBool              SoLightGetFieldName(const SoLight *this, const
                              SoField *field, SbName *fieldName)
     SbBool              SoLightIsNotifyEnabled(const SoLight *this)
     SbBool              SoLightEnableNotify(SoLight *this, SbBool flag)

          Functions from class SoBase:
     void                SoLightRef(SoLight *this)
     void                SoLightUnref(const SoLight *this)
     void                SoLightUnrefNoDelete(const SoLight *this)
     void                SoLightTouch(SoLight *this)
     SoType              SoLightGetTypeId(const SoLight *this)
     SbBool              SoLightIsOfType(const SoLight *this, SoType type)
     void                SoLightSetName(SoLight *this, const char *name)
     SbName              SoLightGetName(const SoLight *this)


DESCRIPTION
     SoLight is the abstract base class for all light nodes. A light node
     defines an illumination source that may affect subsequent shapes in the
     scene graph, depending on the current lighting style. Light sources are
     affected by the current transformation. A light node under a separator
     does not affect any objects outside that separator.

     You can also use a node kit to create a light; see the reference page for
     SoLightKit.

FIELDS
     SoSFBool            on
          Determines whether the source is active or inactive. When inactive,
          the source does not illuminate at all.

     SoSFFloat           intensity
          Illumination intensity of light source. Valid values range from 0.0
          (no illumination) to 1.0 (maximum illumination).

     SoSFColor           color
          Light source illumination color.


FUNCTIONS
     SoType              SoLightGetClassTypeId()
          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.


FILE FORMAT/DEFAULTS
     This is an abstract class. See the reference page of a derived class for
     the format and default values.

SEE ALSO
     SoDirectionalLight, SoEnvironment, SoLightKit, SoLightModel, SoMaterial,
     SoPointLight, SoSpotLight