osg::SharedObjectHandler Class Reference

#include <OSGSharedObjectHandler.h>

List of all members.

Public Types
typedef std::map< std::string, SharedObjectP >	SharedObjectMap
typedef SharedObjectMap::iterator	SharedObjectMapIt
typedef SharedObjectMap::const_iterator	SharedObjectMapConstIt
typedef std::vector< std::string >	NameStore
typedef std::vector < std::string >::iterator	NameStoreIt
typedef std::vector < std::string > ::const_iterator	NameStoreConstIt
Public Member Functions
SharedObjectP	getSharedObject (const Char8 *szName)
SharedObjectP	getOSGSharedObject (const Char8 *szName)
SharedObjectP	findSharedObject (const Char8 *szName) const
void	removeSharedObject (const Char8 *szName)
void	removeSharedObject (SharedObjectP pObject)
void	registerLoadedObject (const Char8 *szName)
void	dump (void)
Static Public Member Functions
static SharedObjectHandlerP	the (void)
Protected Member Functions
	SharedObjectHandler (void)
virtual	~SharedObjectHandler (void)
bool	initialize (void)
void	terminate (void)
Protected Attributes
SharedObjectMap	_mSharedObjects
NameStore	_vLoadedNames
Static Protected Attributes
static SharedObjectHandlerP	_the = NULL
Private Member Functions
	SharedObjectHandler (const SharedObjectHandler &source)
void	operator= (const SharedObjectHandler &source)
Friends
bool	osgInit (Int32 argc, Char8 **argv, UInt16 major, UInt16 minor, UInt16 release, bool debug, bool dll, bool mt)
bool	osgExit (void)

---

Detailed Description

Definition at line 248 of file OSGSharedObjectHandler.h.

---

Member Typedef Documentation

typedef std::map<std::string, SharedObjectP> osg::SharedObjectHandler::SharedObjectMap

Definition at line 264 of file OSGSharedObjectHandler.h.

typedef SharedObjectMap::iterator osg::SharedObjectHandler::SharedObjectMapIt

Definition at line 266 of file OSGSharedObjectHandler.h.

typedef SharedObjectMap::const_iterator osg::SharedObjectHandler::SharedObjectMapConstIt

Definition at line 268 of file OSGSharedObjectHandler.h.

typedef std::vector<std::string> osg::SharedObjectHandler::NameStore

Definition at line 271 of file OSGSharedObjectHandler.h.

typedef std::vector<std::string>::iterator osg::SharedObjectHandler::NameStoreIt

Definition at line 272 of file OSGSharedObjectHandler.h.

typedef std::vector<std::string>::const_iterator osg::SharedObjectHandler::NameStoreConstIt

Definition at line 273 of file OSGSharedObjectHandler.h.

---

Constructor & Destructor Documentation

osg::SharedObjectHandler::SharedObjectHandler

(

const SharedObjectHandler &

source

)

[private]

SharedObjectHandler::SharedObjectHandler

(

void

)

[protected]

Definition at line 328 of file OSGSharedObjectHandler.cpp.

References FINFO.

                                             :
    _mSharedObjects(),
    _vLoadedNames  ()
{
    FINFO(("create SharedObjectHandler\n"));
}

SharedObjectHandler::~SharedObjectHandler

(

void

)

[protected, virtual]

Definition at line 335 of file OSGSharedObjectHandler.cpp.

References FINFO.

{
    FINFO(("destroy SharedObjectHandler\n"));
}

---

Member Function Documentation

void osg::SharedObjectHandler::operator=

(

const SharedObjectHandler &

source

)

[private]

bool SharedObjectHandler::initialize

(

void

)

[protected]

Definition at line 492 of file OSGSharedObjectHandler.cpp.

References _mSharedObjects, _vLoadedNames, osg::MemoryObject::addRef(), FINFO, and getSharedObject().

Referenced by osg::osgInit().

{
    SharedObjectP pAppHandle = getSharedObject(NULL);

    for(UInt32 i = 0; i < _vLoadedNames.size(); ++i)
    {
        FINFO(("Preloaded %s %p\n", _vLoadedNames[i].c_str(), pAppHandle));

        _mSharedObjects[_vLoadedNames[i]] = pAppHandle;
        pAppHandle->addRef();
    }

    _vLoadedNames.clear();

    return true;
}

void SharedObjectHandler::terminate

(

void

)

[protected]

Definition at line 340 of file OSGSharedObjectHandler.cpp.

References _mSharedObjects, _the, dump(), and FINFO.

Referenced by osg::osgExit().

{
    FINFO(("terminate SharedObjectHandler\n"));

    this->dump();

    SharedObjectMapIt soIt  = _mSharedObjects.begin();
    SharedObjectMapIt soEnd = _mSharedObjects.end  ();

    while(soIt != soEnd)
    {
        soIt->second->close();

        soIt->second->subRef();

        ++soIt;
    }

    _the = NULL;
    delete this;
}

SharedObjectHandlerP SharedObjectHandler::the

(

void

)

[static]

Definition at line 304 of file OSGSharedObjectHandler.cpp.

References _the.

Referenced by osg::osgExit(), and osg::osgInit().

{
    if(_the == NULL)
    {
        _the = new SharedObjectHandler;
    }

    return _the;
}

SharedObjectP SharedObjectHandler::getSharedObject

(

const Char8 *

szName

)

Definition at line 368 of file OSGSharedObjectHandler.cpp.

References _mSharedObjects, _vLoadedNames, osg::MemoryObject::addRef(), findSharedObject(), FINFO, osg::SharedObject::getName(), osg::GlobalSystemState, osg::SharedObject::open(), and osg::Running.

Referenced by getOSGSharedObject(), initialize(), and osg::osgInit().

{
    SharedObjectP returnValue = NULL;

    returnValue = findSharedObject(szName);

    if(returnValue == NULL)
    {
        returnValue = new SharedObject(szName);

        returnValue->open  ();
        returnValue->addRef();

        _mSharedObjects[returnValue->getName()] = returnValue;

        if(GlobalSystemState == Running)
        {
//            FactoryController::the()->initializePendingElements();
        }
    }

#if 0
    for(UInt32 i = 0; i < _vLoadedNames.size(); ++i)
    {
        FINFO(("Pulled in %s\n", _vLoadedNames[i].c_str()));
    }
#endif

    _vLoadedNames.clear();

    return returnValue;
}

SharedObjectP SharedObjectHandler::getOSGSharedObject

(

const Char8 *

szName

)

Definition at line 402 of file OSGSharedObjectHandler.cpp.

References getSharedObject().

Referenced by osg::osgInit().

{
    SharedObjectP returnValue = NULL;

    std::string tmpString; 

#ifndef WIN32    
    tmpString.append("lib");
    tmpString.append(szName);
    tmpString.append(".so");
#else
    tmpString.append(szName);
    tmpString.append(".dll");
#endif

    returnValue = getSharedObject(tmpString.c_str());

    return returnValue;
}

SharedObjectP SharedObjectHandler::findSharedObject

(

const Char8 *

szName

)

const

Definition at line 423 of file OSGSharedObjectHandler.cpp.

References _mSharedObjects, and osg::SharedObject::_szApplicationObjectName.

Referenced by getSharedObject().

{
    SharedObjectMapConstIt  mapIt;
    SharedObjectP           returnValue  = NULL;
    std::string             szSearchName;

    if(szName != NULL)
    {
        szSearchName.assign(szName);
    }
    else
    {
        szSearchName.assign(SharedObject::_szApplicationObjectName);
    }

    mapIt = _mSharedObjects.find(szSearchName);

    if(mapIt != _mSharedObjects.end())
    {
        returnValue = mapIt->second;
    }
    
    return returnValue;
}

void SharedObjectHandler::removeSharedObject

(

const Char8 *

szName

)

Definition at line 449 of file OSGSharedObjectHandler.cpp.

References _mSharedObjects, and osg::SharedObject::_szApplicationObjectName.

Referenced by removeSharedObject().

{
    SharedObjectMapIt  mapIt;
    std::string        szSearchName;

    if(szName != NULL)
    {
        szSearchName.assign(szName);
    }
    else
    {
        szSearchName.assign(SharedObject::_szApplicationObjectName);
    }

    mapIt = _mSharedObjects.find(szSearchName);

    _mSharedObjects.erase(mapIt);
}

void SharedObjectHandler::removeSharedObject

(

SharedObjectP

pObject

)

Definition at line 468 of file OSGSharedObjectHandler.cpp.

References osg::SharedObject::getCName(), and removeSharedObject().

{
    if(pObject != NULL)
    {
        removeSharedObject(pObject->getCName());
    }
}

void SharedObjectHandler::registerLoadedObject

(

const Char8 *

szName

)

Definition at line 476 of file OSGSharedObjectHandler.cpp.

References _vLoadedNames.

{
    std::string tmpString;

#ifndef WIN32    
    tmpString.append("lib");
    tmpString.append(szName);
    tmpString.append(".so");
#else
    tmpString.append(szName);
    tmpString.append(".dll");
#endif

    _vLoadedNames.push_back(tmpString);
}

void SharedObjectHandler::dump

(

void

)

Definition at line 509 of file OSGSharedObjectHandler.cpp.

References _mSharedObjects, and FINFO.

Referenced by osg::osgInit(), and terminate().

{
    SharedObjectMapIt soIt  = _mSharedObjects.begin();
    SharedObjectMapIt soEnd = _mSharedObjects.end  ();

    while(soIt != soEnd)
    {
        FINFO(("SO : %s | %p\n", soIt->first.c_str(), soIt->second));

        soIt->second->dump();
        ++soIt;
    }
}

---

Friends And Related Function Documentation

bool osgInit	(	Int32	argc,
		Char8 **	argv,
		UInt16	major,
		UInt16	minor,
		UInt16	release,
		bool	debug,
		bool	dll,
		bool	mt
	)			[friend]

Definition at line 303 of file OSGBaseFunctions.cpp.

{
    CompileConfig prog(major, minor, release, debug, dll, mt),
    lib(OSG_MAJOR_VERSION, OSG_MINOR_VERSION, 
                      OSG_RELEASE_VERSION,
#ifdef _DEBUG  
    true,
#else
    false,
#endif
#ifdef _DLL  
    true,
#else
    false,
#endif
#ifdef _MT  
    true
#else
    false
#endif
    );
    
    if(lib.compare(prog))
    {
        exit(1);
    }

    // without it floats could be written as "1,456" ...
    setlocale(LC_NUMERIC, "English");
    
    UInt32 i;
    bool   returnValue = true;

    returnValue = SharedObjectHandler::the()->initialize();

    if(osgPreloadSharedObject != NULL)
    {
        for(UInt32 i = 0; i < osgPreloadSharedObject->size(); ++i)
        {
            SharedObjectHandler::the()->getOSGSharedObject(
                (*osgPreloadSharedObject)[i].c_str());
        }
    }

#ifdef WIN32
    std::string pathSep(";");
#else
    std::string pathSep(":");
#endif

    char *szEnvLibs = getenv("OSG_LOAD_LIBS");

    if(szEnvLibs != NULL)
    {
        std::string tmpString(szEnvLibs);
        string_token_iterator libIt(tmpString, pathSep.c_str());

        string_token_iterator libEnd;

        while(libIt != libEnd)
        {
            SharedObjectHandler::the()->getOSGSharedObject(
                (*libIt).c_str());

            ++libIt;
        }
    }

    const char *szEnvPlugins       = getenv("OSG_PLUGIN_PATH");
    const char *szEnvPluginPattern = getenv("OSG_PLUGIN_PATTERN");

    if(szEnvPlugins != NULL)
    {
        if(szEnvPluginPattern == NULL)
        {
            szEnvPluginPattern = PluginPattern;
        }

        FINFO(("Get Plugins %s from %s\n", 
               szEnvPluginPattern,
               szEnvPlugins));

        std::vector<Char8 *> *pPlugins = 
            Directory::getEntries(szEnvPlugins, szEnvPluginPattern);

        if(pPlugins != NULL)
        {
            std::string szPluginName;

            for(UInt32 i = 0; i < pPlugins->size(); ++i)
            {
                if((*pPlugins)[i][0] == '.')
                {
                    if((*pPlugins)[i][1] == '\0')
                    {
                        continue;
                    }
                    else if((*pPlugins)[i][1] == '.' &&
                            (*pPlugins)[i][2] == '\0')
                    {
                        continue;
                    }
                }

                szPluginName.assign(szEnvPlugins);
                szPluginName += '/';
                szPluginName += (*pPlugins)[i];

                FINFO(("Loading plugin %s\n", 
                       szPluginName.c_str()));

                SharedObjectHandler::the()->getSharedObject(
                    szPluginName.c_str());
            }
        }

        delete pPlugins;
    }

    SharedObjectHandler::the()->dump();

    if(returnValue == false)
        return returnValue;

    if(osgPreMPInitFunctions != NULL)
    {
        for(i = 0; i < osgPreMPInitFunctions->size(); i++)
        {
            returnValue &= (*osgPreMPInitFunctions)[i]();
            
            if(returnValue == false)
                break;         
        }
    
        osgPreMPInitFunctions->clear();
    }
        
    if(returnValue == false)
        return returnValue;

    returnValue &= ThreadManager::initialize();

    if(returnValue == false)
        return returnValue;

    if(osgInitFunctions != NULL)
    {
        for(i = 0; i < osgInitFunctions->size(); i++)
        {
            returnValue &= (*osgInitFunctions)[i]();
            
            if(returnValue == false)
                break;         
        }

        osgInitFunctions->clear();
    }
    
    if(returnValue == false)
        return returnValue;

#ifdef OSG_GV_BETA
    returnValue &= FactoryController::the()->initialize();
#endif

    GlobalSystemState = Running;

    atexit(osgExitWrapper);
    
    return returnValue;
}

bool osgExit

(

void

)

[friend]

Definition at line 480 of file OSGBaseFunctions.cpp.

{
    bool returnValue = true;

    if(GlobalSystemState != Running)
        return true;
        
    GlobalSystemState = Shutdown;

#ifdef OSG_GV_BETA
    returnValue &= FactoryController::the()->terminate();
#endif
    SharedObjectHandler::the()->terminate();
    
    if(osgSystemExitFunctions != NULL)
    {
        for(Int32 i = osgSystemExitFunctions->size() - 1; i >= 0; i--)
        {
            returnValue &= (*osgSystemExitFunctions)[i]();
            
            if(returnValue == false)
                break;         
        }
    }

    returnValue &= ThreadManager::terminate();

    if(osgPostMPExitFunctions != NULL)
    {
        for(Int32 i = osgPostMPExitFunctions->size() - 1; i >= 0; i--)
        {
            returnValue &= (*osgPostMPExitFunctions)[i]();
            
            if(returnValue == false)
                break;         
        }
    }

    return returnValue;
}

---

Member Data Documentation

SharedObjectHandlerP SharedObjectHandler::_the = NULL [static, protected]

Definition at line 336 of file OSGSharedObjectHandler.h.

Referenced by terminate(), and the().

SharedObjectMap osg::SharedObjectHandler::_mSharedObjects [protected]

Definition at line 346 of file OSGSharedObjectHandler.h.

Referenced by dump(), findSharedObject(), getSharedObject(), initialize(), removeSharedObject(), and terminate().

NameStore osg::SharedObjectHandler::_vLoadedNames [protected]

Definition at line 348 of file OSGSharedObjectHandler.h.

Referenced by getSharedObject(), initialize(), and registerLoadedObject().

---

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

• OSGSharedObjectHandler.h
• OSGSharedObjectHandler.cpp