OpenSceneGraph/include/osgDB/DynamicLibrary
2005-11-17 17:44:48 +00:00

80 lines
2.6 KiB
C++

/* -*-c++-*- OpenSceneGraph - Copyright (C) 1998-2005 Robert Osfield
*
* This library is open source and may be redistributed and/or modified under
* the terms of the OpenSceneGraph Public License (OSGPL) version 0.0 or
* (at your option) any later version. The full license is in LICENSE file
* included with this distribution, and on the openscenegraph.org website.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* OpenSceneGraph Public License for more details.
*/
#ifndef OSGDB_DYNAMICLIBRARY
#define OSGDB_DYNAMICLIBRARY 1
#include <osg/Referenced>
#include <osgDB/Export>
#include <string>
namespace osgDB {
/** DynamicLibrary - encapsulates the loading and unloading of dynamic libraries,
typically used for loading ReaderWriter plug-ins.
*/
class OSGDB_EXPORT DynamicLibrary : public osg::Referenced
{
public:
typedef void* HANDLE;
typedef void* PROC_ADDRESS;
/** returns a pointer to a DynamicLibrary object on successfully
* opening of library returns NULL on failure.
*/
static DynamicLibrary* loadLibrary(const std::string& libraryName);
/** return name of library stripped of path.*/
const std::string& getName() const { return _name; }
/** return name of library including full path to it.*/
const std::string& getFullName() const { return _fullName; }
/** return handle to .dso/.dll dynamic library itself.*/
HANDLE getHandle() const { return _handle; }
/** return address of function located in library.*/
PROC_ADDRESS getProcAddress(const std::string& procName);
protected:
/** get handle to library file */
static HANDLE getLibraryHandle( const std::string& libraryName);
/** disallow default constructor.*/
DynamicLibrary():osg::Referenced() {}
/** disallow copy constructor.*/
DynamicLibrary(const DynamicLibrary&):osg::Referenced() {}
/** disallow copy operator.*/
DynamicLibrary& operator = (const DynamicLibrary&) { return *this; }
/** Disallow public construction so that users have to go
* through loadLibrary() above which returns NULL on
* failure, a valid DynamicLibrary object on success.
*/
DynamicLibrary(const std::string& name,HANDLE handle);
~DynamicLibrary();
HANDLE _handle;
std::string _name;
std::string _fullName;
};
}
#endif // __DYNAMIC_LIBRARY_H