Public Member Functions | |
Referenced () | |
Referenced (bool threadSafeRefUnref) | |
Referenced (const Referenced &) | |
Referenced & | operator= (const Referenced &) |
virtual void | setThreadSafeRefUnref (bool threadSafe) |
bool | getThreadSafeRefUnref () const |
OpenThreads::Mutex * | getRefMutex () const |
void | ref () const |
void | unref () const |
void | unref_nodelete () const |
int | referenceCount () const |
ObserverSet * | getObserverSet () const |
ObserverSet * | getOrCreateObserverSet () const |
void | addObserver (Observer *observer) const |
void | removeObserver (Observer *observer) const |
Static Public Member Functions | |
static OpenThreads::Mutex * | getGlobalReferencedMutex () |
static void | setThreadSafeReferenceCounting (bool enableThreadSafeReferenceCounting) |
static bool | getThreadSafeReferenceCounting () |
static void | setDeleteHandler (DeleteHandler *handler) |
static DeleteHandler * | getDeleteHandler () |
Protected Member Functions | |
virtual | ~Referenced () |
void | signalObserversAndDelete (bool signalUnreferened, bool signalDelete, bool doDelete) const |
void | deleteUsingDeleteHandler () const |
Protected Attributes | |
OpenThreads::AtomicPtr | _observerSet |
OpenThreads::Atomic | _refCount |
Friends | |
class | DeleteHandler |
osg::Referenced::Referenced | ( | ) |
osg::Referenced::Referenced | ( | bool | threadSafeRefUnref | ) | [explicit] |
osg::Referenced::Referenced | ( | const Referenced & | ) |
virtual osg::Referenced::~Referenced | ( | ) | [protected, virtual] |
Referenced& osg::Referenced::operator= | ( | const Referenced & | ) | [inline] |
virtual void osg::Referenced::setThreadSafeRefUnref | ( | bool | threadSafe | ) | [virtual] |
Set whether to use a mutex to ensure ref() and unref() are thread safe.
Reimplemented in osg::Drawable, osg::Geode, osg::Group, osg::LightSource, osg::Node, osg::Program, osg::StateSet, osg::TexGenNode, osgSim::OverlayNode, osgSim::OverlayNode::OverlayData, osgText::Font, osgText::Font::GlyphTexture, osgText::Font3D, osgText::Font3D::Glyph3D, osgText::Text, osgText::Text3D, and osgText::TextBase.
bool osg::Referenced::getThreadSafeRefUnref | ( | ) | const [inline] |
OpenThreads::Mutex* osg::Referenced::getRefMutex | ( | ) | const [inline] |
Get the mutex used to ensure thread safety of ref()/unref().
static OpenThreads::Mutex* osg::Referenced::getGlobalReferencedMutex | ( | ) | [static] |
Get the optional global Referenced mutex, this can be shared between all osg::Referenced.
void osg::Referenced::ref | ( | ) | const [inline] |
Increment the reference count by one, indicating that this object has another pointer which is referencing it.
References _refCount.
Referenced by osg::intrusive_ptr_add_ref().
void osg::Referenced::unref | ( | ) | const [inline] |
Decrement the reference count by one, indicating that a pointer to this object is referencing it. If the reference count goes to zero, it is assumed that this object is no longer referenced and is automatically deleted.
References _refCount, and signalObserversAndDelete().
Referenced by osg::intrusive_ptr_release().
void osg::Referenced::unref_nodelete | ( | ) | const |
Decrement the reference count by one, indicating that a pointer to this object is referencing it. However, do not delete it, even if ref count goes to 0. Warning, unref_nodelete() should only be called if the user knows exactly who will be responsible for, one should prefer unref() over unref_nodelete() as the later can lead to memory leaks.
int osg::Referenced::referenceCount | ( | ) | const [inline] |
Return the number pointers currently referencing this object.
ObserverSet* osg::Referenced::getObserverSet | ( | ) | const [inline] |
Get the ObserverSet if one is attached, otherwise return NULL.
ObserverSet* osg::Referenced::getOrCreateObserverSet | ( | ) | const |
Get the ObserverSet if one is attached, otherwise create an ObserverSet, attach it, then return this newly created ObserverSet.
void osg::Referenced::addObserver | ( | Observer * | observer | ) | const [inline] |
Add a Observer that is observing this object, notify the Observer when this object gets deleted.
Referenced by osg::State::setLastAppliedProgramObject().
void osg::Referenced::removeObserver | ( | Observer * | observer | ) | const [inline] |
remove Observer that is observing this object.
static void osg::Referenced::setThreadSafeReferenceCounting | ( | bool | enableThreadSafeReferenceCounting | ) | [static] |
Set whether reference counting should be use a mutex to create thread reference counting.
static bool osg::Referenced::getThreadSafeReferenceCounting | ( | ) | [static] |
Get whether reference counting is active.
static void osg::Referenced::setDeleteHandler | ( | DeleteHandler * | handler | ) | [static] |
Set a DeleteHandler to which deletion of all referenced counted objects will be delegated to.
static DeleteHandler* osg::Referenced::getDeleteHandler | ( | ) | [static] |
Get a DeleteHandler.
void osg::Referenced::signalObserversAndDelete | ( | bool | signalUnreferened, | |
bool | signalDelete, | |||
bool | doDelete | |||
) | const [protected] |
Referenced by unref().
void osg::Referenced::deleteUsingDeleteHandler | ( | ) | const [protected] |
friend class DeleteHandler [friend] |
OpenThreads::AtomicPtr osg::Referenced::_observerSet [mutable, protected] |
OpenThreads::Atomic osg::Referenced::_refCount [mutable, protected] |