NAME

SoTimerQueueSensor — abstract base class for sensors dependent on time

INHERITS FROM

SoSensor > SoTimerQueueSensor

SYNOPSIS

#include <Inventor/sensors/SoTimerQueueSensor.h>

Methods from class SoTimerQueueSensor:

const SbTime & getTriggerTime()

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

Timer queue sensors are sensors that trigger themselves at specific times. The timer queue is normally processed as part of a programs main loop when the program is not busy doing something else. Note that processing the timer queue is not asynchronous — the program must re-enter its main loop for timers to be triggered. When the timer queue is processed, all timers scheduled to go off at or before the current time are triggered once, in order from earliest to latest.

METHODS

const SbTime & getTriggerTime()

Returns the time at which this sensor is scheduled to be triggered. If the sensor is not scheduled the results are undefined.

virtual void schedule()

Adds this sensor to the timer queue. Subclasses provide methods for setting when the sensor will be triggered.

virtual void unschedule()

If this sensor is scheduled, removes it from the timer queue so that it will not be triggered.

virtual SbBool isScheduled()

Returns TRUE if this sensor has been scheduled and is waiting in the timer queue to be triggered.

SEE ALSO

SoTimerSensor, SoAlarmSensor, SoIdleSensor, SoOneShotSensor, SoDataSensor