osg::Referenced Class Reference

Base class for providing reference counted objects. More...

Inherited by osg::ApplicationUsage, osg::AttributeDispatch, osg::AttributeDispatchers, osg::CullingSet, osg::CullSettings::ClampProjectionMatrixCallback, osg::DisplaySettings, osg::FrameStamp, osg::GeometryCostEstimator, osg::GLBufferObjectSet, osg::GLExtensions, osg::GraphicsContext::ResizedCallback, osg::GraphicsContext::SwapCallback, osg::GraphicsContext::Traits, osg::GraphicsContext::WindowingSystemInterface, osg::GraphicsContext::WindowingSystemInterfaces, osg::GraphicsCostEstimator, osg::GraphicsObject, osg::GraphicsObjectManager, osg::Identifier, osg::Image::DimensionsChangedCallback, osg::LineSegment, osg::NodeVisitor::DatabaseRequestHandler, osg::NodeVisitor::ImageRequestHandler, osg::NotifyHandler, osg::Object, osg::ObserverSet, osg::Operation [virtual], osg::OperationQueue, osg::OperationThread, osg::Program::PerContextProgram, osg::ProgramCostEstimator, osg::RefBlock [virtual], osg::RefBlockCount [virtual], osg::Shader::PerContextShader, osg::Shader::ShaderObjects, osg::State, osg::State::DynamicObjectRenderingCompletedCallback, osg::Stats, osg::TestResult, osg::Texture1D::SubloadCallback, osg::Texture2D::SubloadCallback, osg::Texture2DArray::SubloadCallback, osg::Texture3D::SubloadCallback, osg::TextureCostEstimator, osg::TextureCubeMap::SubloadCallback, osg::TextureObjectSet, osg::TextureRectangle::SubloadCallback, osg::VertexArrayState, osg::VertexArrayState::ArrayDispatch, osg::View::Slave::UpdateSlaveCallback [virtual], osgAnimation::ActionVisitor, osgAnimation::KeyframeContainer, osgAnimation::Motion, osgAnimation::Sampler, osgAnimation::Target, osgAnimation::TemplateCompositeSampler< VALUESAMPLERTYPE, TIMESAMPLERTYPE >, osgDB::AuthenticationDetails, osgDB::AuthenticationMap, osgDB::BaseCompressor, osgDB::BaseSerializer, osgDB::DatabasePager::DatabaseRequest, osgDB::DatabasePager::DatabaseThread, osgDB::DatabasePager::PagedLODList, osgDB::DatabasePager::RequestQueue, osgDB::DeprecatedDotOsgWrapperManager, osgDB::DotOsgWrapper, osgDB::DynamicLibrary, osgDB::FileCache, osgDB::FileLocationCallback [virtual], osgDB::FindFileCallback [virtual], osgDB::FinishedObjectReadCallback, osgDB::ImageOptions::TexCoordRange, osgDB::ImagePager::ImageRequest, osgDB::ImagePager::ImageThread, osgDB::ImagePager::RequestQueue, osgDB::InputException, osgDB::InputIterator, osgDB::MethodObject, osgDB::ObjectCache, osgDB::ObjectWrapper, osgDB::ObjectWrapperManager, osgDB::OutputException, osgDB::OutputIterator, osgDB::ReaderWriterInfo, osgDB::ReadFileCallback [virtual], osgDB::Registry, osgDB::Registry::ReadFunctor, osgDB::WriteFileCallback [virtual], osgDB::XmlNode, osgFX::Registry, osgFX::Technique, osgGA::AnimationPathManipulator::AnimationCompletedCallback [virtual], osgGA::CameraManipulator::CoordinateFrameCallback, osgGA::EventQueue, osgGA::PointerData, osgGA::StandardManipulator::AnimationData, osgManipulator::CommandManager, osgManipulator::Constraint, osgManipulator::MotionCommand, osgManipulator::Projector, osgPresentation::FilePathData [virtual], osgPresentation::HUDSettings, osgPresentation::LayerAttributes [virtual], osgPresentation::LayerCallback [virtual], osgPresentation::ObjectOperator, osgShadow::ParallelSplitShadowMap::FragmentShaderGenerator, osgShadow::ViewDependentShadowMap::LightData, osgShadow::ViewDependentShadowMap::ShadowData, osgShadow::ViewDependentShadowMap::ViewDependentData, osgShadow::ViewDependentShadowTechnique::ViewData, osgSim::GeographicLocation, osgSim::ImpostorSpriteManager, osgSim::OverlayNode::OverlayData, osgSim::ScalarBar::ScalarPrinter, osgSim::ScalarsToColors, osgTerrain::GeometryPool, osgTerrain::GeometryTechnique::BufferData, osgTerrain::TerrainTile::TileLoadedCallback, osgTerrain::ValidDataOperator, osgText::Font::FontImplementation, osgText::Glyph3D, osgText::Glyph::TextureInfo, osgText::GlyphGeometry, osgUtil::CubeMapGenerator, osgUtil::CullVisitor::Identifier, osgUtil::DelaunayTriangulator, osgUtil::EdgeCollector::Edge, osgUtil::EdgeCollector::Edgeloop, osgUtil::EdgeCollector::Point, osgUtil::EdgeCollector::Triangle, osgUtil::IncrementalCompileOperation::CompileCompletedCallback [virtual], osgUtil::IncrementalCompileOperation::CompileOp, osgUtil::IncrementalCompileOperation::CompileSet, osgUtil::IntersectionVisitor::ReadCallback, osgUtil::Intersector, osgUtil::Optimizer::IsOperationPermissibleForObjectCallback, osgUtil::Optimizer::TextureAtlasBuilder::Atlas, osgUtil::Optimizer::TextureAtlasBuilder::Source, osgUtil::RenderBin::DrawCallback, osgUtil::RenderBin::SortCallback, osgUtil::RenderLeaf, osgUtil::SceneView::ComputeStereoMatricesCallback, osgUtil::Simplifier::ContinueSimplificationCallback, osgUtil::TangentSpaceGenerator, osgUtil::Tessellator, osgUtil::Tessellator::Prim, osgViewer::DepthPartitionSettings, osgViewer::GraphicsWindowWin32::WindowData, osgViewer::GraphicsWindowX11::WindowData, osgViewer::OpenGLQuerySupport, osgViewer::Scene, osgViewer::ScreenCaptureHandler::CaptureOperation, osgVolume::TileData, osgVolume::VolumeScene::ViewData, osgWidget::Callback, osgWidget::CallbackInterface, and osgWidget::ScriptEngine.

Public Member Functions
	Referenced ()
	Referenced (bool threadSafeRefUnref)
	Deprecated, Referenced is now always uses thread safe ref/unref, use default Referenced() constructor instead. More...
	Referenced (const Referenced &)
Referenced &	operator= (const Referenced &)
virtual void	setThreadSafeRefUnref (bool)
	Deprecated, Referenced is always theadsafe so there method now has no effect and does not need to be called. More...
bool	getThreadSafeRefUnref () const
	Get whether a mutex is used to ensure ref() and unref() are thread safe. More...
OpenThreads::Mutex *	getRefMutex () const
	Get the mutex used to ensure thread safety of ref()/unref(). More...
int	ref () const
	Increment the reference count by one, indicating that this object has another pointer which is referencing it. More...
int	unref () const
	Decrement the reference count by one, indicating that a pointer to this object is no longer referencing it. More...
int	unref_nodelete () const
	Decrement the reference count by one, indicating that a pointer to this object is no longer referencing it. More...
int	referenceCount () const
	Return the number of pointers currently referencing this object. More...
ObserverSet *	getObserverSet () const
	Get the ObserverSet if one is attached, otherwise return NULL. More...
ObserverSet *	getOrCreateObserverSet () const
	Get the ObserverSet if one is attached, otherwise create an ObserverSet, attach it, then return this newly created ObserverSet. More...
void	addObserver (Observer *observer) const
	Add a Observer that is observing this object, notify the Observer when this object gets deleted. More...
void	removeObserver (Observer *observer) const
	Remove Observer that is observing this object. More...

Static Public Member Functions
static OpenThreads::Mutex *	getGlobalReferencedMutex ()
	Get the optional global Referenced mutex, this can be shared between all osg::Referenced. More...
static void	setDeleteHandler (DeleteHandler *handler)
	Set a DeleteHandler to which deletion of all referenced counted objects will be delegated. More...
static DeleteHandler *	getDeleteHandler ()
	Get a DeleteHandler. More...

Protected Member Functions
virtual	~Referenced ()
void	signalObserversAndDelete (bool signalDelete, bool doDelete) const
void	deleteUsingDeleteHandler () const

Protected Attributes
OpenThreads::AtomicPtr	_observerSet
OpenThreads::Atomic	_refCount

Friends
class	DeleteHandler

Detailed Description

Base class for providing reference counted objects.

Constructor & Destructor Documentation

Referenced() [1/3]

osg::Referenced::Referenced

(

)

Referenced() [2/3]

osg::Referenced::Referenced ( bool  threadSafeRefUnref )

explicit

Deprecated, Referenced is now always uses thread safe ref/unref, use default Referenced() constructor instead.

Referenced() [3/3]

osg::Referenced::Referenced

(

const Referenced &

)

~Referenced()

virtual osg::Referenced::~Referenced ( )

protectedvirtual

Member Function Documentation

addObserver()

void osg::Referenced::addObserver

(

Observer *

observer

)

const

Add a Observer that is observing this object, notify the Observer when this object gets deleted.

deleteUsingDeleteHandler()

void osg::Referenced::deleteUsingDeleteHandler ( ) const

protected

getDeleteHandler()

static DeleteHandler* osg::Referenced::getDeleteHandler ( )

static

Get a DeleteHandler.

getGlobalReferencedMutex()

static OpenThreads::Mutex* osg::Referenced::getGlobalReferencedMutex ( )

static

Get the optional global Referenced mutex, this can be shared between all osg::Referenced.

getObserverSet()

ObserverSet* osg::Referenced::getObserverSet ( ) const

inline

Get the ObserverSet if one is attached, otherwise return NULL.

References osg::releaseGLObjects(), and osg::resizeGLObjectBuffers().

getOrCreateObserverSet()

ObserverSet* osg::Referenced::getOrCreateObserverSet

(

)

const

Get the ObserverSet if one is attached, otherwise create an ObserverSet, attach it, then return this newly created ObserverSet.

getRefMutex()

OpenThreads::Mutex* osg::Referenced::getRefMutex ( ) const

inline

Get the mutex used to ensure thread safety of ref()/unref().

getThreadSafeRefUnref()

bool osg::Referenced::getThreadSafeRefUnref ( ) const

inline

Get whether a mutex is used to ensure ref() and unref() are thread safe.

operator=()

Referenced& osg::Referenced::operator= ( const Referenced &  )

inline

ref()

int osg::Referenced::ref ( ) const

inline

Increment the reference count by one, indicating that this object has another pointer which is referencing it.

Referenced by osg::intrusive_ptr_add_ref(), and osgPresentation::PropertyManager::ref().

referenceCount()

int osg::Referenced::referenceCount ( ) const

inline

Return the number of pointers currently referencing this object.

removeObserver()

void osg::Referenced::removeObserver

(

Observer *

observer

)

const

Remove Observer that is observing this object.

setDeleteHandler()

static void osg::Referenced::setDeleteHandler ( DeleteHandler *  handler )

static

Set a DeleteHandler to which deletion of all referenced counted objects will be delegated.

setThreadSafeRefUnref()

virtual void osg::Referenced::setThreadSafeRefUnref ( bool  )

inlinevirtual

Deprecated, Referenced is always theadsafe so there method now has no effect and does not need to be called.

Reimplemented in osg::StateSet, osg::Node, osg::Drawable, osgText::GlyphTexture, osgText::Glyph3D, osg::Object, osgSim::OverlayNode::OverlayData, osgText::GlyphGeometry, osg::Group, osgText::Font, osgSim::OverlayNode, osg::LightSource, osg::Program, and osg::TexGenNode.

Referenced by osg::TestResult::TestResult().

signalObserversAndDelete()

void osg::Referenced::signalObserversAndDelete ( bool  signalDelete, bool  doDelete  ) const

protected

unref()

int osg::Referenced::unref ( ) const

inline

Decrement the reference count by one, indicating that a pointer to this object is no longer referencing it.

If the reference count goes to zero, it is assumed that this object is no longer referenced and is automatically deleted.

Referenced by osg::intrusive_ptr_release(), and osgPresentation::PropertyManager::unref().

unref_nodelete()

int osg::Referenced::unref_nodelete

(

)

const

Decrement the reference count by one, indicating that a pointer to this object is no longer 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 latter can lead to memory leaks.

Referenced by osg::observer_ptr< osgWidget::Widget >::lock().

Friends And Related Function Documentation

DeleteHandler

friend class DeleteHandler

friend

Member Data Documentation

_observerSet

OpenThreads::AtomicPtr osg::Referenced::_observerSet

mutableprotected

_refCount

OpenThreads::Atomic osg::Referenced::_refCount

mutableprotected

---

The documentation for this class was generated from the following file:

• osg/Referenced