Stellarium 0.12.0
Home · All Namespaces · All Classes · Functions · Coding Style · Scripting · Plugins · Renderer · File Structure

StelModuleMgr Class Reference

Manage a collection of StelModules including both core and plugin modules. More...

#include <StelModuleMgr.hpp>

List of all members.

Classes

struct  PluginDescriptor
 Contains the information read from the module.ini file. More...

Public Member Functions

void update ()
 Regenerate calling lists if necessary.
void registerModule (StelModule *m, bool generateCallingLists=false)
 Register a new StelModule to the list The module is later referenced by its QObject name.
void unloadModule (const QString &moduleID, bool alsoDelete=true)
 Unregister and delete a StelModule.
StelModuleloadPlugin (const QString &moduleID)
 Load dynamically a module.
void unloadAllPlugins ()
 Unload all plugins.
void setPluginLoadAtStartup (const QString &key, bool b)
 Define whether a plugin should be loaded at startup.
StelModulegetModule (const QString &moduleID, bool noWarning=false)
 Get the corresponding module or NULL if can't find it.
QList< StelModule * > getAllModules ()
 Get the list of all the currently registered modules.
const QList< StelModule * > & getCallOrders (StelModule::StelModuleActionName action)
 Get the list of modules in the correct order for calling the given action.
QList< PluginDescriptorgetPluginsList ()
 Return the list of all the external module found in the modules directories.

Detailed Description

Manage a collection of StelModules including both core and plugin modules.

The order in which some actions like draw or update are called for each module can be retrieved with the getCallOrders() method.

Definition at line 36 of file StelModuleMgr.hpp.


Member Function Documentation

QList<StelModule*> StelModuleMgr::getAllModules (  )  [inline]

Get the list of all the currently registered modules.

Definition at line 76 of file StelModuleMgr.hpp.

const QList<StelModule*>& StelModuleMgr::getCallOrders ( StelModule::StelModuleActionName  action  )  [inline]

Get the list of modules in the correct order for calling the given action.

Definition at line 79 of file StelModuleMgr.hpp.

StelModule* StelModuleMgr::getModule ( const QString &  moduleID,
bool  noWarning = false 
)

Get the corresponding module or NULL if can't find it.

Parameters:
moduleID the QObject name of the module instance, by convention it is equal to the class name.
noWarning if true, don't display any warning if the module is not found.
QList<PluginDescriptor> StelModuleMgr::getPluginsList (  ) 

Return the list of all the external module found in the modules directories.

StelModule* StelModuleMgr::loadPlugin ( const QString &  moduleID  ) 

Load dynamically a module.

Parameters:
moduleID the name of the module = name of the dynamic library file without extension (e.g "mymodule" for mymodule.so or mymodule.dll)
Returns:
the loaded module or NULL in case of error. The returned Stelmodule still needs to be initialized
void StelModuleMgr::registerModule ( StelModule m,
bool  generateCallingLists = false 
)

Register a new StelModule to the list The module is later referenced by its QObject name.

void StelModuleMgr::setPluginLoadAtStartup ( const QString &  key,
bool  b 
)

Define whether a plugin should be loaded at startup.

Parameters:
key the key of the plugin as in the PluginDescriptor class.
b the value to set.
void StelModuleMgr::unloadAllPlugins (  ) 

Unload all plugins.

void StelModuleMgr::unloadModule ( const QString &  moduleID,
bool  alsoDelete = true 
)

Unregister and delete a StelModule.

The program will hang if other modules depend on the removed one

Parameters:
moduleID the unique ID of the module, by convention equal to the class name
alsoDelete if true also delete the StelModule instance, otherwise it has to be deleted by external code.
void StelModuleMgr::update (  ) 

Regenerate calling lists if necessary.


The documentation for this class was generated from the following file:
Generated on Thu Jan 31 14:05:45 2013 for Stellarium by  doxygen 1.6.3