SoDataSensor - Online Linux Manual Page

Section : 3
Updated : Mon Jan 25 2021
Source : Version 3.1.3
Note : Coin

NAMESoDataSensor − The SoDataSensor class is the abstract base class for sensors monitoring changes in a scene graph​.

SYNOPSIS
#include <Inventor/sensors/SoDataSensor​.h> Inherits SoDelayQueueSensor​. Inherited by SoFieldSensor, SoNodeSensor, and SoPathSensor​.

Public Member FunctionsSoDataSensor (void)
SoDataSensor (SoSensorCB *func, void *data)
virtual ~SoDataSensor (void)
void setDeleteCallback (SoSensorCB *function, void *data=NULL)
SoNode * getTriggerNode (void) const
SoField * getTriggerField (void) const
SoPath * getTriggerPath (void) const
void setTriggerPathFlag (SbBool flag)
SbBool getTriggerPathFlag (void) const
virtual void trigger (void)
virtual void notify (SoNotList *l)
virtual void dyingReference (void)=0

Protected Member Functionsvoid invokeDeleteCallback (void)

Additional Inherited Members

Detailed DescriptionThe SoDataSensor class is the abstract base class for sensors monitoring changes in a scene graph​. If you need to know when a particular entity (as a field or a node) changes, subclasses of SoDataSensor can be used to monitor the entity and notify you when it changes​.

Constructor & Destructor Documentation

SoDataSensor::SoDataSensor (void)Default constructor​.

SoDataSensor::SoDataSensor (SoSensorCB * func, void * data)Constructor taking as parameters the sensor callback function and the userdata which will be passed the callback​. See also setFunction(), setData()

SoDataSensor::~SoDataSensor (void) [virtual]Destructor​.

Member Function Documentation

void SoDataSensor::setDeleteCallback (SoSensorCB * function, void * data = NULL)If an object monitored by a data sensor is deleted, the given callback function will be called with the given userdata​. The sensor priority setting does not affect the delete callback​. It will be called immediately, before the object is deleted​.

SoNode * SoDataSensor::getTriggerNode (void) constReturns a pointer to the node causing the sensor to trigger, or NULL if there was no such node​. NULL will also be returned for sensors which are not immediate sensors (i​.e​. with priority equal to 0), as the result could otherwise be misleading (non-immediate sensors could have been scheduled and rescheduled multiple times, so there wouldn't be a single node responsible for the sensor triggering)​. The result is only valid within the scope of a trigger(), so if you need to use the pointer outside your sensor callback, you must store it​. See also getTriggerField()

SoField * SoDataSensor::getTriggerField (void) constReturns a pointer to the field causing the sensor to trigger, or NULL if the change didn't start at a field​. Only valid for immediate sensors (will return NULL otherwise), for the same reason as described for SoDataSensor::getTriggerNode()​. The result is only valid within the scope of a trigger(), so if you need to use the pointer outside your sensor callback, you must store it​.

SoPath * SoDataSensor::getTriggerPath (void) constReturns a pointer to the path from the node under the surveillance of this sensor (either directly or indirectly through a field watch) down to the node which caused the sensor to be triggered​. Will only work for immediate mode sensors, for the same reason explained under getTriggerNode()​. The resulting path is only valid within the scope of trigger(), so if you need to use the path outside your sensor callback, you must store the pointer and call SoPath::ref() to avoid its destruction at the end of SoDataSensor::trigger()​.

void SoDataSensor::setTriggerPathFlag (SbBool flag)This flag indicates whether or not the path should be queried whenever a node triggers the data sensor​. This flag is provided because finding a node path through a scene graph is an expensive operation​. See also getTriggerPathFlag(), getTriggerPath()

SbBool SoDataSensor::getTriggerPathFlag (void) constReturns whether or not any node induced trigger operations will make the sensor find the path of the node which caused it​. See also setTriggerPathFlag(), getTriggerPath()

void SoDataSensor::trigger (void) [virtual]Trigger the sensor's callback function​. Reimplemented from SoDelayQueueSensor​. Reimplemented in SoFieldSensor​.

void SoDataSensor::notify (SoNotList * l) [virtual]Called from entity we are monitoring when it changes​. If this is an immediate sensor, the field and node (if any) causing the change will be stored and can be fetched by getTriggerField() and getTriggerNode()​. If the triggerpath flag has been set, the path down to the node is also found and stored for later retrieval by getTriggerPath()​. See also setTriggerPathFlag() Reimplemented in SoPathSensor​.

void SoDataSensor::dyingReference (void) [pure virtual]This method is called when the entity we are connected to is about to be deleted​.

void SoDataSensor::invokeDeleteCallback (void) [protected]Runs the callback set in setDeleteCallback()​. Called from subclasses when the entity we're monitoring is about to be deleted​.

AuthorGenerated automatically by Doxygen for Coin from the source code​.
0
Johanes Gumabo
Data Size   :   25,649 byte
man-SoDataSensor.3coin3Build   :   2025-03-22, 13:26   :  
Visitor Screen   :   x
Visitor Counter ( page / site )   :   5 / 2,337,633
Visitor ID   :     :  
Visitor IP   :   216.73.216.115   :  
Visitor Provider   :   AMAZON-02   :  
Provider Position ( lat x lon )   :   39.962500 x -83.006100   :   x
Provider Accuracy Radius ( km )   :   20   :  
Provider City   :   Columbus   :  
Provider Province   :   Ohio ,   :   ,
Provider Country   :   United States   :  
Provider Continent   :   North America   :  
Visitor Recorder   :   Version   :  
Visitor Recorder   :   Library   :  
Online Linux Manual Page   :   Version   :   Online Linux Manual Page - Fedora.40 - march=x86-64 - mtune=generic - 25.03.22
Online Linux Manual Page   :   Library   :   lib_c - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Online Linux Manual Page   :   Library   :   lib_m - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Data Base   :   Version   :   Online Linux Manual Page Database - 24.04.13 - march=x86-64 - mtune=generic - fedora-38
Data Base   :   Library   :   lib_c - 23.02.07 - march=x86-64 - mtune=generic - fedora.36


Very long time ago, I have the best tutor, Wenzel Svojanovsky. If someone knows the email address of Wenzel Svojanovsky, please send an email to johanesgumabo@gmail.com.
Help me, linux0001.com will expire on July 16, 2025. I have no money to renew it. View detail

If error, please print screen and send to johanes_gumabo@yahoo.co.id
Under development. Support me via PayPal.