SoPointLight(3IV)

NAME
     SoPointLight (SoPtLt) - node representing a point light source

INHERITS FROM
     SoBase > SoFieldContainer > SoNode > SoLight > SoPointLight

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

     typedef SoPointLight  SoPtLt

          Fields from class SoPointLight:

     SoSFVec3f           location

          Fields from class SoLight:

     SoSFBool            on
     SoSFFloat           intensity
     SoSFColor           color

          Functions from class SoPointLight:

     SoPointLight *      SoPtLtCreate()
     SoType              SoPtLtGetClassTypeId()

          Functions from class SoNode:

     void                SoPtLtSetOverride(SoPtLt *this, SbBool state)
     SbBool              SoPtLtIsOverride(const SoPtLt *this)
     SoNode *            SoPtLtCopy(const SoPtLt *this, SbBool copyConnections
                              = FALSE)
     SbBool              SoPtLtAffectsState(const SoPtLt *this)
     SoNode *            SoPtLtGetByName(const char *name)
     int                 SoPtLtGetByNameList(const char *name, SoNodeList
                              *list)

          Functions from class SoFieldContainer:

     void                SoPtLtSetToDflts(SoPtLt *this)
     SbBool              SoPtLtHasDfltVals(const SoPtLt *this)
     SbBool              SoPtLtFldsAreEq(const SoPtLt *this, const
                              SoFieldContainer *fc)
     void                SoPtLtCopyFieldVals(SoPtLt *this, const
                              SoFieldContainer *fc, SbBool copyConnections =
                              FALSE)
     SbBool              SoPtLtSet(SoPtLt *this, const char *fieldDataString)
     void                SoPtLtGet(SoPtLt *this, SbString *fieldDataString)
     int                 SoPtLtGetFields(const SoPtLt *this, SoFieldList
                              *resultList)
     SoField *           SoPtLtGetField(const SoPtLt *this, const char
                              *fieldName)
     SbBool              SoPtLtGetFieldName(const SoPtLt *this, const SoField
                              *field, SbName *fieldName)
     SbBool              SoPtLtIsNotifyEnabled(const SoPtLt *this)
     SbBool              SoPtLtEnableNotify(SoPtLt *this, SbBool flag)

          Functions from class SoBase:

     void                SoPtLtRef(SoPtLt *this)
     void                SoPtLtUnref(const SoPtLt *this)
     void                SoPtLtUnrefNoDelete(const SoPtLt *this)
     void                SoPtLtTouch(SoPtLt *this)
     SoType              SoPtLtGetTypeId(const SoPtLt *this)
     SbBool              SoPtLtIsOfType(const SoPtLt *this, SoType type)
     void                SoPtLtSetName(SoPtLt *this, const char *name)
     SbName              SoPtLtGetName(const SoPtLt *this)


DESCRIPTION
     This node defines a point light source at a fixed 3D location. A point
     source illuminates equally in all directions; that is, it is omni-
     directional.

FIELDS
     SoSFVec3f           location
          Location of the source.


FUNCTIONS
     SoPointLight *      SoPtLtCreate()
          Creates a point light source node with default settings.

     SoType              SoPtLtGetClassTypeId()
          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
     PointLight {
          on         TRUE
          intensity  1
          color      1 1 1
          location   0 0 1
     }

SEE ALSO
     SoDirectionalLight, SoSpotLight