Planet
navi homePPSaboutscreenshotsdownloaddevelopmentforum

source: downloads/OgreMain/include/OgreDynLibManager.h @ 1

Last change on this file since 1 was 1, checked in by landauf, 17 years ago
File size: 4.2 KB
Line 
1/*
2-----------------------------------------------------------------------------
3This source file is part of OGRE
4    (Object-oriented Graphics Rendering Engine)
5For the latest info, see http://www.ogre3d.org/
6
7Copyright (c) 2000-2006 Torus Knot Software Ltd
8Also see acknowledgements in Readme.html
9
10This program is free software; you can redistribute it and/or modify it under
11the terms of the GNU Lesser General Public License as published by the Free Software
12Foundation; either version 2 of the License, or (at your option) any later
13version.
14
15This program is distributed in the hope that it will be useful, but WITHOUT
16ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
17FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
18
19You should have received a copy of the GNU Lesser General Public License along with
20this program; if not, write to the Free Software Foundation, Inc., 59 Temple
21Place - Suite 330, Boston, MA 02111-1307, USA, or go to
22http://www.gnu.org/copyleft/lesser.txt.
23
24You may alternatively use this source under the terms of a specific version of
25the OGRE Unrestricted License provided you have obtained such a license from
26Torus Knot Software Ltd.
27-----------------------------------------------------------------------------
28*/
29#ifndef __DynLibManager_H__
30#define __DynLibManager_H__
31
32#include "OgrePrerequisites.h"
33#include "OgreSingleton.h"
34
35namespace Ogre {
36    /** Manager for Dynamic-loading Libraries.
37        @remarks
38            This manager keeps a track of all the open dynamic-loading
39            libraries, opens them and returns references to already-open
40            libraries.
41    */
42    class _OgreExport DynLibManager: public Singleton<DynLibManager>
43    {
44        protected:
45                typedef std::map<String, DynLib*> DynLibList;
46                DynLibList mLibList;
47    public:
48        /** Default constructor.
49            @note
50                <br>Should never be called as the singleton is automatically
51                created during the creation of the Root object.
52            @see
53                Root::Root
54        */
55        DynLibManager();
56
57        /** Default destructor.
58            @see
59                Root::~Root
60        */
61        virtual ~DynLibManager();
62
63        /** Loads the passed library.
64            @param
65                filename The name of the library. The extension can be ommitted
66        */
67        DynLib* load(const String& filename);
68
69                /** Unloads the passed library.
70                @param
71                filename The name of the library. The extension can be ommitted
72                */
73                void unload(DynLib* lib);
74
75                /** Override standard Singleton retrieval.
76        @remarks
77        Why do we do this? Well, it's because the Singleton
78        implementation is in a .h file, which means it gets compiled
79        into anybody who includes it. This is needed for the
80        Singleton template to work, but we actually only want it
81        compiled into the implementation of the class based on the
82        Singleton, not all of them. If we don't change this, we get
83        link errors when trying to use the Singleton-based class from
84        an outside dll.
85        @par
86        This method just delegates to the template version anyway,
87        but the implementation stays in this single compilation unit,
88        preventing link errors.
89        */
90        static DynLibManager& getSingleton(void);
91        /** Override standard Singleton retrieval.
92        @remarks
93        Why do we do this? Well, it's because the Singleton
94        implementation is in a .h file, which means it gets compiled
95        into anybody who includes it. This is needed for the
96        Singleton template to work, but we actually only want it
97        compiled into the implementation of the class based on the
98        Singleton, not all of them. If we don't change this, we get
99        link errors when trying to use the Singleton-based class from
100        an outside dll.
101        @par
102        This method just delegates to the template version anyway,
103        but the implementation stays in this single compilation unit,
104        preventing link errors.
105        */
106        static DynLibManager* getSingletonPtr(void);
107    };
108}
109
110#endif
Note: See TracBrowser for help on using the repository browser.