com.openinventor.inventor.sensors

Class SoOneShotSensor

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.sensors.SoSensor

com.openinventor.inventor.sensors.SoDelayQueueSensor

com.openinventor.inventor.sensors.SoOneShotSensor

public class SoOneShotSensor
extends SoDelayQueueSensor

Sensor for one-time only callbacks. A one-shot sensor is triggered once after it is scheduled, when the delay queue is processed. Like all delay queue sensors, one-shot sensors with a non-zero priority are just added to the delay queue when scheduled; if they are scheduled again before the delay queue is processed nothing happens, and they are guaranteed to be called only once when the delay queue is processed. For example, a one-shot sensor whose callback redraws the scene might be scheduled whenever the scene graph changes and whenever a window-system event reporting that the window changed size occurs. By using a one-shot, the scene will only be redrawn once even if a window-changed-size event occurs just after the scene graph is modified (or if several window-changed-size events occur in a row).

Calling schedule() in the callback is a useful way of getting something to happen repeatedly as often as possible, while still handling events and timeouts.

A priority 0 one-shot sensor isn't very useful, since scheduling it is exactly the same as directly calling its callback .

See also:

SoIdleSensor, SoDelayQueueSensor

Nested Class Summary

Nested classes/interfaces inherited from class com.openinventor.inventor.Inventor

Inventor.ConstructorCommand

Field Summary

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Constructor Summary

Constructors

Constructor and Description
SoOneShotSensor() Default constructor.
SoOneShotSensor(java.lang.Runnable task) Builds a new one shot sensor with the task to be run when this sensor is triggered

Method Summary

Methods inherited from class com.openinventor.inventor.sensors.SoDelayQueueSensor

getDefaultPriority, getPriority, isIdleOnly, setPriority

Methods inherited from class com.openinventor.inventor.sensors.SoSensor

isScheduled, schedule, setTask, unschedule

Methods inherited from class com.openinventor.inventor.Inventor

dispose, getAddress, getNativeResourceHandle, startInternalThreads, stopInternalThreads

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SoOneShotSensor

public SoOneShotSensor(java.lang.Runnable task)

Builds a new one shot sensor with the task to be run when this sensor is triggered

SoOneShotSensor

public SoOneShotSensor()

Default constructor.