SoLightModel(3IV)

NAME
     SoLightModel (SoLModel) - node that defines the lighting model to use
     when rendering

INHERITS FROM
     SoBase > SoFieldContainer > SoNode > SoLightModel

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

     typedef SoLightModel  SoLModel

     enum SoLightModelModel {
          SO_L_MODEL_BASE_COLOR  Use only the base (diffuse) object color
          SO_L_MODEL_PHONG       Use Phong lighting model
     }

          Fields from class SoLightModel:

     SoSFEnum            model

          Functions from class SoLightModel:

     SoLightModel *      SoLModelCreate()
     SoType              SoLModelGetClassTypeId()

          Functions from class SoNode:

     void                SoLModelSetOverride(SoLModel *this, SbBool state)
     SbBool              SoLModelIsOverride(const SoLModel *this)
     SoNode *            SoLModelCopy(const SoLModel *this, SbBool
                              copyConnections = FALSE)
     SbBool              SoLModelAffectsState(const SoLModel *this)
     SoNode *            SoLModelGetByName(const char *name)
     int                 SoLModelGetByNameList(const char *name, SoNodeList
                              *list)

          Functions from class SoFieldContainer:

     void                SoLModelSetToDflts(SoLModel *this)
     SbBool              SoLModelHasDfltVals(const SoLModel *this)
     SbBool              SoLModelFldsAreEq(const SoLModel *this, const
                              SoFieldContainer *fc)
     void                SoLModelCopyFieldVals(SoLModel *this, const
                              SoFieldContainer *fc, SbBool copyConnections =
                              FALSE)
     SbBool              SoLModelSet(SoLModel *this, const char
                              *fieldDataString)
     void                SoLModelGet(SoLModel *this, SbString
                              *fieldDataString)
     int                 SoLModelGetFields(const SoLModel *this, SoFieldList
                              *resultList)
     SoField *           SoLModelGetField(const SoLModel *this, const char
                              *fieldName)
     SbBool              SoLModelGetFieldName(const SoLModel *this, const
                              SoField *field, SbName *fieldName)
     SbBool              SoLModelIsNotifyEnabled(const SoLModel *this)
     SbBool              SoLModelEnableNotify(SoLModel *this, SbBool flag)

          Functions from class SoBase:

     void                SoLModelRef(SoLModel *this)
     void                SoLModelUnref(const SoLModel *this)
     void                SoLModelUnrefNoDelete(const SoLModel *this)
     void                SoLModelTouch(SoLModel *this)
     SoType              SoLModelGetTypeId(const SoLModel *this)
     SbBool              SoLModelIsOfType(const SoLModel *this, SoType type)
     void                SoLModelSetName(SoLModel *this, const char *name)
     SbName              SoLModelGetName(const SoLModel *this)


DESCRIPTION
     This node defines the lighting model to be used when rendering subsequent
     shapes. The lighting model is specified in the model field. When the
     default model (Phong lighting) is used, light sources are required in a
     scene for objects to be easily visible.

FIELDS
     SoSFEnum            model
          Lighting model to use


FUNCTIONS
     SoLightModel *      SoLModelCreate()
          Creates a light model node with default settings.

     SoType              SoLModelGetClassTypeId()
          Returns type identifier for this class.


ACTION BEHAVIOR
     SoGLRenderAction, SoCallbackAction
          Sets the current lighting model in the state.


FILE FORMAT/DEFAULTS
     LightModel {
          model  PHONG
     }

SEE ALSO
     SoBaseColor, SoEnvironment, SoLight, SoMaterial