OpenSceneGraph
Public Types | Public Member Functions | Static Public Member Functions | Protected Types | Protected Member Functions | Protected Attributes | List of all members
osg::ContextData Class Reference
Inheritance diagram for osg::ContextData:
Inheritance graph
[legend]

Public Types

typedef GraphicsContext::GraphicsContexts GraphicsContexts
 

Public Member Functions

 ContextData (unsigned int contextID)
 
void incrementUsageCount ()
 
void decrementUsageCount ()
 
void setNumContexts (unsigned int numContexts)
 
unsigned int getNumContexts () const
 
void setCompileContext (osg::GraphicsContext *gc)
 
osg::GraphicsContextgetCompileContext ()
 
template<typename T >
T * get ()
 Get a specific GL extensions object or GraphicsObjectManager, initialize if not already present. More...
 
template<typename T >
const T * get () const
 Get a specific GL extensions object or GraphicsObjectManager if it already exists in the extension map. More...
 
template<typename T >
void set (T *ptr)
 Set a specific GL extensions object pr GraphicsObjectManager. More...
 
virtual void newFrame (osg::FrameStamp *)
 Signal that a new frame has started. More...
 
virtual void resetStats ()
 
virtual void reportStats (std::ostream &out)
 
virtual void recomputeStats (std::ostream &out) const
 
virtual void flushDeletedGLObjects (double currentTime, double &availableTime)
 Flush all deleted OpenGL objects within the specified availableTime. More...
 
virtual void flushAllDeletedGLObjects ()
 Flush all deleted OpenGL objects. More...
 
virtual void deleteAllGLObjects ()
 Do a GL delete all OpenGL objects. More...
 
virtual void discardAllGLObjects ()
 Discard all OpenGL objects. More...
 
- Public Member Functions inherited from osg::GraphicsObjectManager
 GraphicsObjectManager (const std::string &name, unsigned int contextID)
 
unsigned int getContextID () const
 
- Public Member Functions inherited from osg::Referenced
 Referenced ()
 
 Referenced (bool threadSafeRefUnref)
 Deprecated, Referenced is now always uses thread safe ref/unref, use default Referenced() constructor instead. More...
 
 Referenced (const Referenced &)
 
Referencedoperator= (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::MutexgetRefMutex () 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...
 
ObserverSetgetObserverSet () const
 Get the ObserverSet if one is attached, otherwise return NULL. More...
 
ObserverSetgetOrCreateObserverSet () 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 unsigned int createNewContextID ()
 Create a contextID for a new graphics context, this contextID is used to set up the osg::State associate with context. More...
 
static unsigned int getMaxContextID ()
 Get the current max ContextID. More...
 
static void incrementContextIDUsageCount (unsigned int contextID)
 Increment the usage count associate with a contextID. More...
 
static void decrementContextIDUsageCount (unsigned int contextID)
 Decrement the usage count associate with a contextID. More...
 
static GraphicsContexts getAllRegisteredGraphicsContexts ()
 Get all the registered graphics contexts. More...
 
static GraphicsContexts getRegisteredGraphicsContexts (unsigned int contextID)
 Get all the registered graphics contexts associated with a specific contextID. More...
 
static void setCompileContext (unsigned int contextID, GraphicsContext *gc)
 Get the GraphicsContext for doing background compilation for GraphicsContexts associated with specified contextID. More...
 
static GraphicsContextgetOrCreateCompileContext (unsigned int contextID)
 Get existing or create a new GraphicsContext to do background compilation for GraphicsContexts associated with specified contextID. More...
 
static GraphicsContextgetCompileContext (unsigned int contextID)
 Get the GraphicsContext for doing background compilation for GraphicsContexts associated with specified contextID. More...
 
static void registerGraphicsContext (GraphicsContext *gc)
 Register a GraphicsContext. More...
 
static void unregisterGraphicsContext (GraphicsContext *gc)
 Unregister a GraphicsContext. More...
 
- Static Public Member Functions inherited from osg::Referenced
static OpenThreads::MutexgetGlobalReferencedMutex ()
 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 DeleteHandlergetDeleteHandler ()
 Get a DeleteHandler. More...
 

Protected Types

typedef std::map< const std::type_info *, osg::ref_ptr< osg::Referenced > > ManagerMap
 

Protected Member Functions

virtual ~ContextData ()
 
- Protected Member Functions inherited from osg::GraphicsObjectManager
virtual ~GraphicsObjectManager ()
 
- Protected Member Functions inherited from osg::Referenced
virtual ~Referenced ()
 
void signalObserversAndDelete (bool signalDelete, bool doDelete) const
 
void deleteUsingDeleteHandler () const
 

Protected Attributes

unsigned int _numContexts
 
osg::ref_ptr< osg::GraphicsContext_compileContext
 
ManagerMap _managerMap
 
- Protected Attributes inherited from osg::GraphicsObjectManager
std::string _name
 
unsigned int _contextID
 
- Protected Attributes inherited from osg::Referenced
OpenThreads::AtomicPtr _observerSet
 
OpenThreads::Atomic _refCount
 

Member Typedef Documentation

◆ GraphicsContexts

◆ ManagerMap

typedef std::map<const std::type_info*, osg::ref_ptr<osg::Referenced> > osg::ContextData::ManagerMap
protected

Constructor & Destructor Documentation

◆ ContextData()

osg::ContextData::ContextData ( unsigned int  contextID)

◆ ~ContextData()

virtual osg::ContextData::~ContextData ( )
protectedvirtual

Member Function Documentation

◆ createNewContextID()

static unsigned int osg::ContextData::createNewContextID ( )
static

Create a contextID for a new graphics context, this contextID is used to set up the osg::State associate with context.

Automatically increments the usage count of the contextID to 1.

◆ decrementContextIDUsageCount()

static void osg::ContextData::decrementContextIDUsageCount ( unsigned int  contextID)
static

Decrement the usage count associate with a contextID.

Once the contextID goes to 0 the contextID is then free to be reused.

◆ decrementUsageCount()

void osg::ContextData::decrementUsageCount ( )
inline

◆ deleteAllGLObjects()

virtual void osg::ContextData::deleteAllGLObjects ( )
virtual

Do a GL delete all OpenGL objects.

Note, must be called from a thread which has current the graphics context associated with contextID.

Implements osg::GraphicsObjectManager.

◆ discardAllGLObjects()

virtual void osg::ContextData::discardAllGLObjects ( )
virtual

Discard all OpenGL objects.

Note, unlike deleteAllGLjects discard does not do any OpenGL calls so can be called from any thread, but as a consequence it also doesn't remove the associated OpenGL resource so discard should only be called when the associated graphics context is being/has been closed.

Implements osg::GraphicsObjectManager.

◆ flushAllDeletedGLObjects()

virtual void osg::ContextData::flushAllDeletedGLObjects ( )
virtual

Flush all deleted OpenGL objects.

Note, must be called from a thread which has current the graphics context associated with contextID.

Implements osg::GraphicsObjectManager.

◆ flushDeletedGLObjects()

virtual void osg::ContextData::flushDeletedGLObjects ( double  currentTime,
double &  availableTime 
)
virtual

Flush all deleted OpenGL objects within the specified availableTime.

Note, must be called from a thread which has current the graphics context associated with contextID.

Implements osg::GraphicsObjectManager.

◆ get() [1/2]

template<typename T >
T* osg::ContextData::get ( )
inline

Get a specific GL extensions object or GraphicsObjectManager, initialize if not already present.

Note, must only be called from a the graphics context thread associated with this osg::State.

References osg::ref_ptr< T >::get().

Referenced by osg::get().

◆ get() [2/2]

template<typename T >
const T* osg::ContextData::get ( ) const
inline

Get a specific GL extensions object or GraphicsObjectManager if it already exists in the extension map.

Note, safe to call outwith a the graphics context thread associated with this osg::State. Returns NULL if the desired extension object has not been created yet.

◆ getAllRegisteredGraphicsContexts()

static GraphicsContexts osg::ContextData::getAllRegisteredGraphicsContexts ( )
static

Get all the registered graphics contexts.

◆ getCompileContext() [1/2]

osg::GraphicsContext* osg::ContextData::getCompileContext ( )
inline

◆ getCompileContext() [2/2]

static GraphicsContext* osg::ContextData::getCompileContext ( unsigned int  contextID)
static

Get the GraphicsContext for doing background compilation for GraphicsContexts associated with specified contextID.

◆ getMaxContextID()

static unsigned int osg::ContextData::getMaxContextID ( )
static

Get the current max ContextID.

◆ getNumContexts()

unsigned int osg::ContextData::getNumContexts ( ) const
inline

◆ getOrCreateCompileContext()

static GraphicsContext* osg::ContextData::getOrCreateCompileContext ( unsigned int  contextID)
static

Get existing or create a new GraphicsContext to do background compilation for GraphicsContexts associated with specified contextID.

◆ getRegisteredGraphicsContexts()

static GraphicsContexts osg::ContextData::getRegisteredGraphicsContexts ( unsigned int  contextID)
static

Get all the registered graphics contexts associated with a specific contextID.

◆ incrementContextIDUsageCount()

static void osg::ContextData::incrementContextIDUsageCount ( unsigned int  contextID)
static

Increment the usage count associate with a contextID.

The usage count specifies how many graphics contexts a specific contextID is shared between.

◆ incrementUsageCount()

void osg::ContextData::incrementUsageCount ( )
inline

◆ newFrame()

virtual void osg::ContextData::newFrame ( osg::FrameStamp )
virtual

Signal that a new frame has started.

Reimplemented from osg::GraphicsObjectManager.

◆ recomputeStats()

virtual void osg::ContextData::recomputeStats ( std::ostream &  out) const
virtual

Reimplemented from osg::GraphicsObjectManager.

◆ registerGraphicsContext()

static void osg::ContextData::registerGraphicsContext ( GraphicsContext gc)
static

Register a GraphicsContext.

◆ reportStats()

virtual void osg::ContextData::reportStats ( std::ostream &  out)
virtual

Reimplemented from osg::GraphicsObjectManager.

◆ resetStats()

virtual void osg::ContextData::resetStats ( )
virtual

Reimplemented from osg::GraphicsObjectManager.

◆ set()

template<typename T >
void osg::ContextData::set ( T *  ptr)
inline

◆ setCompileContext() [1/2]

void osg::ContextData::setCompileContext ( osg::GraphicsContext gc)
inline

◆ setCompileContext() [2/2]

static void osg::ContextData::setCompileContext ( unsigned int  contextID,
GraphicsContext gc 
)
static

Get the GraphicsContext for doing background compilation for GraphicsContexts associated with specified contextID.

◆ setNumContexts()

void osg::ContextData::setNumContexts ( unsigned int  numContexts)
inline

◆ unregisterGraphicsContext()

static void osg::ContextData::unregisterGraphicsContext ( GraphicsContext gc)
static

Unregister a GraphicsContext.

Member Data Documentation

◆ _compileContext

osg::ref_ptr<osg::GraphicsContext> osg::ContextData::_compileContext
protected

◆ _managerMap

ManagerMap osg::ContextData::_managerMap
protected

◆ _numContexts

unsigned int osg::ContextData::_numContexts
protected

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