NAME

       SoFieldSensor — sensor class that can be attached to Inventor fields

INHERITS FROM

       SoSensor > SoDelayQueueSensor > SoDataSensor > SoFieldSensor

SYNOPSIS

       #include <Inventor/sensors/SoFieldSensor.h>

          Methods from class SoFieldSensor:

                         SoFieldSensor()
                         SoFieldSensor(SoSensorCB *func, void *data)
                         ~SoFieldSensor()
     void                attach(SoField *field)
     void                detach()
     SoField *           getAttachedField() const

          Methods from class SoDataSensor:

     void                setDeleteCallback(SoSensorCB *function, void *data)
     SoNode *            getTriggerNode() const
     SoField *           getTriggerField() const
     SoPath *            getTriggerPath() const
     void                setTriggerPathFlag(SbBool flag)
     SbBool              getTriggerPathFlag() const

          Methods from class SoDelayQueueSensor:

     void                setPriority(uint32_t pri)
     uint32_t            getPriority()
     static uint32_t     getDefaultPriority()
     virtual void        schedule()
     virtual void        unschedule()
     virtual SbBool      isScheduled()

          Methods from class SoSensor:

     void                setFunction(SoSensorCB *callbackFunction)
     SoSensorCB *        getFunction() const
     void                setData(void *callbackData)
     void *              getData() const

DESCRIPTION

       Field  sensors  detect  changes  to fields, calling a callback function whenever the field
       changes. The field may be part of a node, an input of an engine, or a global field.

METHODS

                         SoFieldSensor()
                         SoFieldSensor(SoSensorCB *func, void *data)
          Creation methods. The second method takes the callback function and data to  be  called
          when the sensor is triggered.

                         ~SoFieldSensor()
          Destroys the sensor, freeing up any memory associated with it after unscheduling it.

     void                attach(SoField *field)
     void                detach()
     SoField *           getAttachedField() const
          The  attach()  method makes this sensor detect changes to the given field. The detach()
          method unschedules this sensor (if it is scheduled) and makes it ignore changes to  the
          scene  graph.  The  getAttachedField()  method  returns  the  field that this sensor is
          sensing, or NULL if it is not attached to any field.

SEE ALSO

       SoNodeSensor, SoPathSensor, SoDataSensor

                                                                             SoFieldSensor(3IV)()