SoNodeSensor(3)

💖 SoNodeSensor 💖

okay bestie, welcome to the Coin manual page for SoNodeSensor(3) — she's a sensor, she watches nodes, she's iconic, and by the end of this you're gonna be obsessed with her. no cap. ✨

---

🌸 NAME 🌸

SoNodeSensor — the class that detects changes to nodes. that's it. that's the whole job. she's nosy (affectionate) 💅

---

🦋 SYNOPSIS 🦋

#include <Inventor/sensors/SoNodeSensor.h>

Inherits SoDataSensor.

✨ Public Member Functions ✨

SoNodeSensor (void)
SoNodeSensor (SoSensorCB *func, void *data)
virtual ~SoNodeSensor (void)
void attach (SoNode *node)
void detach (void)
SoNode * getAttachedNode (void) const

🎀 Public Member Functions inherited from SoDataSensor 🎀

SoDataSensor (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
SoNotRec::OperationType getTriggerOperationType (void) const
int getTriggerIndex (void) const
int getTriggerFieldNumIndices (void) const
SoNode * getTriggerGroupChild (void) const
SoNode * getTriggerReplacedGroupChild (void) const
virtual void trigger (void)
virtual void notify (SoNotList *l)

💜 Public Member Functions inherited from SoDelayQueueSensor 💜

SoDelayQueueSensor (void)
SoDelayQueueSensor (SoSensorCB *func, void *data)
virtual ~SoDelayQueueSensor (void)
void setPriority (uint32_t pri)
uint32_t getPriority (void) const
virtual void schedule (void)
virtual void unschedule (void)
virtual SbBool isScheduled (void) const
virtual SbBool isIdleOnly (void) const

🌈 Public Member Functions inherited from SoSensor 🌈

SoSensor (void)
SoSensor (SoSensorCB *func, void *data)
virtual ~SoSensor (void)
void setFunction (SoSensorCB *callbackfunction)
SoSensorCBPtr getFunction (void) const
void setData (void *callbackdata)
void * getData (void) const
void setNextInQueue (SoSensor *next)
SoSensor * getNextInQueue (void) const

👑 Additional Inherited Members 👑

Static Public Member Functions inherited from SoDelayQueueSensor:

static uint32_t getDefaultPriority (void)

Static Public Member Functions inherited from SoSensor:

static void initClass (void)

Protected Member Functions inherited from SoDataSensor:

void invokeDeleteCallback (void)

Protected Attributes inherited from SoDelayQueueSensor:

SbBool scheduled

Protected Attributes inherited from SoSensor:

SoSensorCB * func
void * funcData

---

💫 Detailed Description 💫

so. The SoNodeSensor class detects changes to nodes. yes, we said it twice, it's that important, periodt. 💅

Attach a node to a sensor of this type to put it under surveillance — like, full main character stalker energy, but legal and also the whole point of the API — so you can act upon changes to the node. 🕵️‍♀️

Any modification to the node's fields will trigger the sensor. Also changes to the node's children (if any) will trigger it, including if nodes are added or removed as children below the node in the subgraph. so she's watching the whole family tree, not just the one node. fr fr. 🌳

An SoNodeSensor can also act for delete-callback purposes alone and does not need a regular notification-based callback. lowkey flexible of her. 🫶

---

🔥 Constructor & Destructor Documentation 🔥

💖 SoNodeSensor::SoNodeSensor (void )

Default constructor. the "no thoughts, head empty, just vibes" starting point. ✨

💖 SoNodeSensor::SoNodeSensor (SoSensorCB * func, void * data)

Constructor taking as parameters the sensor callback function and the userdata which will be passed to the callback. you hand her the function, you hand her the data, she does the rest. slay. 💅

See also

• setFunction()
• setData()

💖 SoNodeSensor::~SoNodeSensor (void ) [virtual]

Destructor. she's leaving the group chat. 😭

---

🦋 Member Function Documentation 🦋

🌸 void SoNodeSensor::attach (SoNode * node)

Attach sensor to a node. Whenever any data in the node (or its children, if it is an SoGroup or SoGroup derived node) changes, the sensor will be triggered and call the callback function. every little change, she's on it. 🔔

important detail bestie, don't skip it: attaching a node sensor to a node will not increase the node's reference count — and conversely, detach()'ing the node sensor will not decrease the reference count, either. no surprise math happening behind your back, okay? 🧮

When the attached node is deleted, the sensor will be automatically detach()ed. she knows when to let go. 😌

See also

• detach()

🌸 void SoNodeSensor::detach (void )

Detach sensor from node. As long as an SoNodeSensor is detached, it will never call its callback function. she's off the clock, do not text her. 💀

See also

• attach()

🌸 SoNode * SoNodeSensor::getAttachedNode (void ) const

Returns a pointer to the node connected to the sensor. "who you watching?" she'll tell you. 👀

See also

• attach()
• detach()

---

🎀 Author 🎀

Generated automatically by Doxygen for Coin from the source code. so like, don't blame a human for the formatting, blame the robot. 🤖✨

---

okay that's the whole page, you made it, I'm so proud of you 🥹

this little beauty is from Coin version 4.0.10, dated Thu Jun 25 2026 00:00:00, and yes she's filed under SoNodeSensor(3) — go forth and attach responsibly, bestie. mwah. 💋🎀🦋💖