OpenSceneGraph
3.2.0
|
Base class/standard interface for objects which require IO support, cloning and reference counting. More...
Inherits osg::Referenced.
Inherited by osg::AnimationPath [virtual]
, osg::AudioSink, osg::AudioStream, osg::BufferData, osg::BufferData::ModifiedCallback [virtual]
, osg::BufferObject, osg::Camera::DrawCallback [virtual]
, osg::ConvexPlanarOccluder, osg::Drawable, osg::Drawable::ComputeBoundingBoxCallback, osg::Drawable::CullCallback [virtual]
, osg::Drawable::DrawCallback [virtual]
, osg::Drawable::EventCallback [virtual]
, osg::Drawable::UpdateCallback [virtual]
, osg::EllipsoidModel, osg::GraphicsContext, osg::Node, osg::Node::ComputeBoundingSphereCallback, osg::NodeCallback [virtual]
, osg::Program::ProgramBinary, osg::RefMatrixd, osg::RefMatrixf, osg::RenderBuffer, osg::Shader, osg::ShaderBinary, osg::ShaderComponent, osg::ShaderComposer, osg::Shape, osg::StateAttribute, osg::StateAttributeCallback [virtual]
, osg::StateSet, osg::StateSet::Callback [virtual]
, osg::TessellationHints, osg::TransferFunction, osg::Uniform, osg::Uniform::Callback [virtual]
, osg::UserDataContainer, osg::ValueObject, osg::View [virtual]
, osgAnimation::Action, osgAnimation::Action::Callback, osgAnimation::Animation, osgAnimation::AnimationUpdateCallbackBase [virtual]
, osgAnimation::StackedTransformElement, osgAnimation::VertexInfluenceMap, osgDB::DatabaseRevision, osgDB::DatabaseRevisions, osgDB::FileList, osgDB::ImageProcessor, osgDB::Options, osgDB::ReaderWriter, osgGA::Device, osgGA::GUIEventAdapter, osgGA::GUIEventAdapter::TouchData, osgManipulator::DraggerCallback [virtual]
, osgParticle::Counter, osgParticle::Interpolator, osgParticle::Operator, osgParticle::Placer, osgParticle::Shooter, osgShadow::ShadowSettings, osgShadow::ShadowTechnique, osgSim::BlinkSequence, osgSim::LightPointSystem, osgSim::ObjectRecordData, osgSim::Sector, osgSim::SequenceGroup, osgSim::ShapeAttributeList, osgTerrain::Layer, osgTerrain::Locator, osgTerrain::TerrainTechnique, osgText::Bevel, osgText::Font, osgText::Style, osgUtil::PositionalStateContainer, osgUtil::RenderBin, osgUtil::SceneView, osgViewer::Keystone, osgViewer::ViewConfig, osgViewer::ViewerBase [virtual]
, osgVolume::ImageDetails, osgVolume::Layer, osgVolume::Locator, osgVolume::Locator::LocatorCallback [virtual]
, osgVolume::Property, osgVolume::VolumeTechnique, osgWidget::BrowserManager, osgWidget::Style, and osgWidget::StyleManager.
Public Types | |
enum | DataVariance { DYNAMIC, STATIC, UNSPECIFIED } |
Public Member Functions | |
Object () | |
Construct an object. More... | |
Object (bool threadSafeRefUnref) | |
Object (const Object &, const CopyOp ©op=CopyOp::SHALLOW_COPY) | |
Copy constructor, optional CopyOp object can be used to control shallow vs deep copying of dynamic data. More... | |
virtual Object * | cloneType () const =0 |
Clone the type of an object, with Object* return type. More... | |
virtual Object * | clone (const CopyOp &) const =0 |
Clone an object, with Object* return type. More... | |
virtual bool | isSameKindAs (const Object *) const |
virtual const char * | libraryName () const =0 |
return the name of the object's library. More... | |
virtual const char * | className () const =0 |
return the name of the object's class type. More... | |
virtual void | setThreadSafeRefUnref (bool threadSafe) |
Set whether to use a mutex to ensure ref() and unref() are thread safe. More... | |
virtual void | setName (const std::string &name) |
Set the name of object using C++ style string. More... | |
void | setName (const char *name) |
Set the name of object using a C style string. More... | |
const std::string & | getName () const |
Get the name of object. More... | |
void | setDataVariance (DataVariance dv) |
Set the data variance of this object. More... | |
DataVariance | getDataVariance () const |
Get the data variance of this object. More... | |
virtual void | computeDataVariance () |
Compute the DataVariance based on an assessment of callback etc. More... | |
void | setUserDataContainer (osg::UserDataContainer *udc) |
set the UserDataContainer object. More... | |
osg::UserDataContainer * | getUserDataContainer () |
get the UserDataContainer attached to this object. More... | |
const osg::UserDataContainer * | getUserDataContainer () const |
get the const UserDataContainer attached to this object. More... | |
osg::UserDataContainer * | getOrCreateUserDataContainer () |
Convinience method that returns the UserDataContainer, and if one doesn't already exist creates and assigns a DefaultUserDataContainer to the Object and then return this new UserDataContainer. More... | |
virtual void | setUserData (Referenced *obj) |
Set user data, data must be subclassed from Referenced to allow automatic memory handling. More... | |
virtual Referenced * | getUserData () |
Get user data. More... | |
virtual const Referenced * | getUserData () const |
Get const user data. More... | |
template<typename T > | |
bool | getUserValue (const std::string &name, T &value) const |
Convinience method that casts the named UserObject to osg::TemplateValueObject<T> and gets the value. More... | |
template<typename T > | |
void | setUserValue (const std::string &name, const T &value) |
Convinience method that creates the osg::TemplateValueObject<T> to store the specified value and adds it as a named UserObject. More... | |
virtual void | resizeGLObjectBuffers (unsigned int) |
Resize any per context GLObject buffers to specified size. More... | |
virtual void | releaseGLObjects (osg::State *=0) const |
If State is non-zero, this function releases any associated OpenGL objects for the specified graphics context. More... | |
template<typename T > | |
BoolValueObject UCharValueObject UShortValueObject UIntValueObject DoubleValueObject Vec3fValueObject Vec2dValueObject Vec4dValueObject PlaneValueObject MatrixdValueObject bool | getUserValue (const std::string &name, T &value) const |
provide implementation of osg::Object::getUserValue(..) template More... | |
![]() | |
Referenced () | |
Referenced (bool threadSafeRefUnref) | |
Referenced (const Referenced &) | |
Referenced & | operator= (const Referenced &) |
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... | |
Protected Member Functions | |
virtual | ~Object () |
Object destructor. More... | |
![]() | |
virtual | ~Referenced () |
void | signalObserversAndDelete (bool signalDelete, bool doDelete) const |
void | deleteUsingDeleteHandler () const |
Protected Attributes | |
std::string | _name |
DataVariance | _dataVariance |
osg::UserDataContainer * | _userDataContainer |
![]() | |
OpenThreads::AtomicPtr | _observerSet |
OpenThreads::Atomic | _refCount |
Additional Inherited Members | |
![]() | |
static OpenThreads::Mutex * | getGlobalReferencedMutex () |
Get the optional global Referenced mutex, this can be shared between all osg::Referenced. More... | |
static void | setThreadSafeReferenceCounting (bool enableThreadSafeReferenceCounting) |
Set whether reference counting should use a mutex for thread safe reference counting. More... | |
static bool | getThreadSafeReferenceCounting () |
Get whether reference counting is active. 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... | |
Base class/standard interface for objects which require IO support, cloning and reference counting.
Based on GOF Composite, Prototype and Template Method patterns.
|
inline |
Construct an object.
Note Object is a pure virtual base class and therefore cannot be constructed on its own, only derived classes which override the clone and className methods are concrete classes and can be constructed.
|
inlineexplicit |
osg::Object::Object | ( | const Object & | , |
const CopyOp & | copyop = CopyOp::SHALLOW_COPY |
||
) |
Copy constructor, optional CopyOp object can be used to control shallow vs deep copying of dynamic data.
|
protectedvirtual |
Object destructor.
Note, is protected so that Objects cannot be deleted other than by being dereferenced and the reference count being zero (see osg::Referenced), preventing the deletion of nodes which are still in use. This also means that Nodes cannot be created on stack i.e Node node will not compile, forcing all nodes to be created on the heap i.e Node* node = new Node().
|
pure virtual |
return the name of the object's class type.
Must be defined by derived classes.
Implemented in osg::BufferData, osg::DrawElementsUInt, osg::RefMatrixf, osg::BufferObject, osg::GraphicsContext, osg::DrawElementsUShort, osg::RefMatrixd, osg::Texture, osg::DrawElementsUByte, osg::DrawArrayLengths, osg::DrawArrays, osgText::GlyphTexture, osgViewer::GraphicsWindowEmbedded, osg::StateAttribute, osgShadow::ShadowVolumeGeometry, osg::PrimitiveSet, osg::Array, osg::ShapeDrawable, osg::Image, osg::TemplateValueObject< T >, osg::Drawable, osg::Node, osgText::Font, osgViewer::GraphicsWindowX11, osg::Shape, osgFX::Effect, osgUtil::RenderBin, osgAnimation::MorphGeometry, osg::Light, osgGA::UFOManipulator, osg::AudioStream, osg::ClipPlane, osg::StateSet, osgSim::ImpostorSprite, osgGA::StandardManipulator, osgParticle::ParticleProcessor, osgUtil::RenderStage, osgViewer::GraphicsWindow, osgGA::CameraManipulator, osgShadow::OccluderGeometry, osg::Hint, osg::Geometry, osgGA::AnimationPathManipulator, osgParticle::Program, osg::DrawPixels, osgParticle::Emitter, osgParticle::Operator, osgParticle::ParticleEffect, osg::ImageSequence, osg::ImageStream, osg::UserDataContainer, osgParticle::Interpolator, osgUtil::PositionalStateContainer, osgGA::KeySwitchMatrixManipulator, osgGA::StateSetManipulator, osgSim::Sector, osgViewer::GraphicsWindowWin32, osgViewer::PixelBufferWin32, osg::AutoTransform, osgParticle::Placer, osgText::Text, osg::ShaderAttribute, osgDB::Archive, osgParticle::PrecipitationEffect, osgParticle::Shooter, osgText::TextBase, osgViewer::PixelBufferX11, osgGA::DriveManipulator, osgParticle::CenteredPlacer, osgParticle::VariableRateCounter, osg::AudioSink, osgParticle::Counter, osgGA::SphericalManipulator, and osgGA::CameraViewSwitchManipulator.
Clone an object, with Object* return type.
Must be defined by derived classes.
Implemented in osg::DrawElementsUInt, osg::RefMatrixf, osg::GraphicsContext, osg::DrawElementsUShort, osg::RefMatrixd, osg::Texture, osg::DrawElementsUByte, osg::TemplateIndexArray< T, ARRAYTYPE, DataSize, DataType >, osg::DrawArrayLengths, osg::TemplateArray< T, ARRAYTYPE, DataSize, DataType >, osg::DrawArrays, osg::StateAttribute, osgShadow::ShadowVolumeGeometry, osg::ShapeDrawable, osg::Image, osg::TemplateValueObject< T >, osg::Node, osgText::Font, osgUtil::RenderBin, osgAnimation::MorphGeometry, osg::Light, osg::Shape, osg::ClipPlane, osg::StateSet, osgSim::ImpostorSprite, osgUtil::RenderStage, osgManipulator::AntiSquish, osgShadow::OccluderGeometry, osg::Hint, osg::Geometry, osg::ImageSequence, osg::ImageStream, osg::DrawPixels, osgUtil::PositionalStateContainer, osg::AutoTransform, osgText::Text, and osg::ShaderAttribute.
Referenced by osg::clone().
|
pure virtual |
Clone the type of an object, with Object* return type.
Must be defined by derived classes.
Implemented in osg::DrawElementsUInt, osg::RefMatrixf, osg::GraphicsContext, osg::DrawElementsUShort, osg::RefMatrixd, osg::Texture, osg::DrawElementsUByte, osg::TemplateIndexArray< T, ARRAYTYPE, DataSize, DataType >, osg::DrawArrayLengths, osg::TemplateArray< T, ARRAYTYPE, DataSize, DataType >, osg::DrawArrays, osg::StateAttribute, osgShadow::ShadowVolumeGeometry, osg::ShapeDrawable, osg::Image, osg::TemplateValueObject< T >, osg::Node, osgText::Font, osgUtil::RenderBin, osgAnimation::MorphGeometry, osg::Light, osg::Shape, osg::ClipPlane, osg::StateSet, osgUtil::RenderStage, osgSim::ImpostorSprite, osgManipulator::AntiSquish, osgShadow::OccluderGeometry, osg::Hint, osg::Geometry, osg::ImageSequence, osg::ImageStream, osgUtil::PositionalStateContainer, osg::AutoTransform, osg::DrawPixels, osgText::Text, and osg::ShaderAttribute.
Referenced by osg::cloneType().
|
inlinevirtual |
Compute the DataVariance based on an assessment of callback etc.
Reimplemented in osg::Drawable, and osg::StateSet.
|
inline |
Get the data variance of this object.
Referenced by osgUtil::RenderLeaf::RenderLeaf(), osgUtil::RenderLeaf::set(), and osgUtil::StateGraph::StateGraph().
|
inline |
Get the name of object.
Referenced by osgTerrain::CompositeLayer::addLayer(), osg::State::applyShaderCompositionUniform(), and osgAnimation::RigGeometry::UpdateVertex::update().
osg::UserDataContainer* osg::Object::getOrCreateUserDataContainer | ( | ) |
Convinience method that returns the UserDataContainer, and if one doesn't already exist creates and assigns a DefaultUserDataContainer to the Object and then return this new UserDataContainer.
|
virtual |
Get user data.
Reimplemented in osg::DefaultUserDataContainer, and osg::UserDataContainer.
Referenced by osgUtil::Optimizer::isOperationPermissibleForObjectImplementation().
|
virtual |
Get const user data.
Reimplemented in osg::DefaultUserDataContainer, and osg::UserDataContainer.
|
inline |
get the UserDataContainer attached to this object.
|
inline |
get the const UserDataContainer attached to this object.
bool osg::Object::getUserValue | ( | const std::string & | name, |
T & | value | ||
) | const |
Convinience method that casts the named UserObject to osg::TemplateValueObject<T> and gets the value.
To use this template method you need to include the osg/ValueObject header.
BoolValueObject UCharValueObject UShortValueObject UIntValueObject DoubleValueObject Vec3fValueObject Vec2dValueObject Vec4dValueObject PlaneValueObject MatrixdValueObject bool osg::Object::getUserValue | ( | const std::string & | name, |
T & | value | ||
) | const |
provide implementation of osg::Object::getUserValue(..) template
References osg::UserDataContainer::getUserObject().
|
inlinevirtual |
Reimplemented in osg::BufferData, osg::DrawElementsUInt, osg::RefMatrixf, osg::BufferObject, osg::GraphicsContext, osg::DrawElementsUShort, osg::RefMatrixd, osg::Texture, osg::DrawElementsUByte, osg::DrawArrayLengths, osg::IndexArray, osg::DrawArrays, osg::StateAttribute, osgShadow::ShadowVolumeGeometry, osg::PrimitiveSet, osg::Array, osg::ShapeDrawable, osg::Image, osg::TemplateValueObject< T >, osg::Drawable, osg::Node, osgText::Font, osgFX::Effect, osgUtil::RenderBin, osgAnimation::MorphGeometry, osg::Shape, osg::Light, osg::AudioStream, osg::ClipPlane, osg::StateSet, osgParticle::ParticleProcessor, osgSim::ImpostorSprite, osgUtil::RenderStage, osgManipulator::AntiSquish, osgParticle::Program, osgShadow::OccluderGeometry, osg::Hint, osgParticle::Emitter, osgParticle::Operator, osgParticle::ParticleEffect, osg::Geometry, osgParticle::Interpolator, osgSim::Sector, osg::DrawPixels, osg::ImageSequence, osg::ImageStream, osgParticle::Placer, osgParticle::PrecipitationEffect, osgParticle::Shooter, osgUtil::PositionalStateContainer, osg::AutoTransform, osgParticle::CenteredPlacer, osgText::Text, osgText::TextBase, osg::ShaderAttribute, osgParticle::VariableRateCounter, osg::UserDataContainer, and osgParticle::Counter.
|
pure virtual |
return the name of the object's library.
Must be defined by derived classes. The OpenSceneGraph convention is that the namespace of a library is the same as the library name.
Implemented in osg::BufferData, osg::DrawElementsUInt, osg::RefMatrixf, osg::BufferObject, osg::GraphicsContext, osg::DrawElementsUShort, osg::RefMatrixd, osg::Texture, osg::DrawElementsUByte, osg::DrawArrayLengths, osg::DrawArrays, osgViewer::GraphicsWindowEmbedded, osg::StateAttribute, osgShadow::ShadowVolumeGeometry, osg::PrimitiveSet, osg::Array, osg::ShapeDrawable, osg::Image, osg::TemplateValueObject< T >, osg::Drawable, osg::Node, osgText::Font, osgViewer::GraphicsWindowX11, osgFX::Effect, osgUtil::RenderBin, osg::Shape, osgAnimation::MorphGeometry, osg::Light, osg::AudioStream, osg::ClipPlane, osg::StateSet, osgSim::ImpostorSprite, osgParticle::ParticleProcessor, osgViewer::GraphicsWindow, osgShadow::OccluderGeometry, osg::Hint, osg::Geometry, osgParticle::Program, osg::DrawPixels, osgParticle::Emitter, osgParticle::Operator, osgParticle::ParticleEffect, osg::ImageSequence, osg::ImageStream, osg::AutoTransform, osgParticle::Interpolator, osgText::Text, osgUtil::PositionalStateContainer, osgSim::Sector, osgText::TextBase, osgViewer::GraphicsWindowWin32, osgViewer::PixelBufferWin32, osg::UserDataContainer, osgParticle::Placer, osg::ShaderAttribute, osgParticle::PrecipitationEffect, osgParticle::Shooter, osgViewer::PixelBufferX11, osgDB::Archive, osgParticle::CenteredPlacer, osgParticle::VariableRateCounter, osg::AudioSink, and osgParticle::Counter.
|
inlinevirtual |
If State is non-zero, this function releases any associated OpenGL objects for the specified graphics context.
Otherwise, releases OpenGL objects for all graphics contexts.
Reimplemented in osg::Texture, osg::BufferData, osg::Camera, osg::BufferObject, osg::FrameBufferObject, osg::StateSet, osg::Node, osg::StateAttribute, osg::Drawable, osg::ShaderComponent, osgText::Text, osgText::TextBase, osgUtil::RenderStage, osg::VertexProgram, osg::FragmentProgram, osg::RenderBuffer, osgTerrain::TerrainTile, osg::Shader, osgText::Font, osg::Group, osgUtil::RenderBin, osg::Geode, osg::Geometry, osgSim::OverlayNode, osgText::Text3D, osg::OcclusionQueryNode, osgTerrain::TerrainTechnique, osg::Program, osg::QueryGeometry, osgTerrain::GeometryTechnique, osg::ShaderAttribute, osgShadow::ShadowedScene, and osgShadow::ViewDependentShadowMap.
|
inlinevirtual |
Resize any per context GLObject buffers to specified size.
Reimplemented in osg::PixelDataBufferObject, osg::Texture, osg::BufferData, osg::Camera, osg::BufferObject, osg::FrameBufferObject, osg::StateSet, osg::Node, osg::StateAttribute, osg::Drawable, osg::ShaderComponent, osgText::Text, osgText::GlyphTexture, osgText::TextBase, osg::VertexProgram, osg::FragmentProgram, osg::RenderBuffer, osg::Shader, osgText::Font, osg::Group, osg::Geode, osg::Geometry, osgSim::OverlayNode, osgText::Text3D, osg::Program, osg::ShaderAttribute, osgShadow::ShadowedScene, and osgShadow::ViewDependentShadowMap.
|
inline |
Set the data variance of this object.
Can be set to either STATIC for values that do not change over the lifetime of the object, or DYNAMIC for values that vary over the lifetime of the object. The DataVariance value can be used by routines such as optimization codes that wish to share static data. UNSPECIFIED is used to specify that the DataVariance hasn't been set yet.
|
inlinevirtual |
Set the name of object using C++ style string.
Reimplemented in osg::Uniform.
Referenced by osg::ValueObject::ValueObject().
|
inline |
Set the name of object using a C style string.
|
virtual |
Set whether to use a mutex to ensure ref() and unref() are thread safe.
Reimplemented from osg::Referenced.
Reimplemented in osg::StateSet, osg::Node, osg::Drawable, osgText::Text, osgText::GlyphTexture, osgText::TextBase, osgText::Font, osg::Group, osg::Geode, osgSim::OverlayNode, osgText::Text3D, osg::LightSource, osg::Program, and osg::TexGenNode.
|
virtual |
Set user data, data must be subclassed from Referenced to allow automatic memory handling.
If your own data isn't directly subclassed from Referenced then create an adapter object which points to your own object and handles the memory addressing.
Reimplemented in osg::DefaultUserDataContainer, and osg::UserDataContainer.
void osg::Object::setUserDataContainer | ( | osg::UserDataContainer * | udc) |
set the UserDataContainer object.
void osg::Object::setUserValue | ( | const std::string & | name, |
const T & | value | ||
) |
Convinience method that creates the osg::TemplateValueObject<T> to store the specified value and adds it as a named UserObject.
provide implementation of osg::Object::setUserValue(..) template.
To use this template method you need to include the osg/ValueObject header.
References osg::UserDataContainer::addUserObject(), osg::UserDataContainer::getUserObjectIndex(), and osg::UserDataContainer::setUserObject().
|
protected |
|
protected |
Referenced by osgWidget::NotifyWidget::focus(), osgWidget::NotifyWidget::keyPress(), osgWidget::NotifyWidget::keyRelease(), osgWidget::NotifyWidget::mouseDrag(), osgWidget::NotifyWidget::mouseEnter(), osgWidget::NotifyWidget::mouseLeave(), osgWidget::NotifyWidget::mouseOver(), osgWidget::NotifyWidget::mousePush(), osgWidget::NotifyWidget::mouseRelease(), osgWidget::NotifyWidget::mouseScroll(), and osgWidget::NotifyWidget::unfocus().
|
protected |
![]() | Generated at Thu Aug 15 2013 02:43:46 for the OpenSceneGraph by doxygen 1.8.4. |