Editor API
UnigineEditor public API
Editor::PluginManager Class Referencefinal

The Editor::PluginManager is the main controller class of the Plugin System, it is responsible for:

More...

#include <PluginManager.h>

Inherits QObject.

Signals

void initializationCompleted ()
 This signal is emitted when the PluginManager initialization is completed (i.e. all plugins from the loading queue are loaded and initialized). More...
 

Static Public Member Functions

static PluginManagerinstance ()
 Returns the instance of the PluginManager class. This method is used to subscribe to signals. More...
 
static void loadPluginSpecs (const Unigine::Vector< Unigine::String > &search_paths)
 Loads specifications for all plugins found in the specified directories and tries to read all plugins metadata and resolve all dependencies (change the state of all PluginInfo instances from INVALID to RESOLVED). This method builds the list of all available plugins. More...
 
static void loadPlugins ()
 Loads and initializes all available plugins from the list generated by calling the loadPluginSpecs() method (PluginInfo states LOADED and RUNNING). More...
 
static void unloadPlugins ()
 Destroys all currently loaded plugins and unloads dynamic libraries from memory (PluginInfo states STOPPED and UNLOADED). More...
 
static bool loadPlugin (PluginInfo *plugin_info)
 Loads and initializes the plugin. (PluginInfo states LOADED and RUNNING). More...
 
static bool unloadPlugin (PluginInfo *plugin_info)
 Destroys the loaded plugin and unloads its dynamic library from memory. (PluginInfo states STOPPED and UNLOADED). More...
 
static Unigine::Vector< PluginInfo * > plugins ()
 Returns information on all plugins currently available as a vector of PluginInfo items containing all necessary information on each plugin. More...
 
static bool hasError ()
 Returns true if at least one error has occurred when loading any of the plugins available. If the result is positive, you can use the allErrors() method to get detailed information on all errors. More...
 
static Unigine::Vector< Unigine::String > allErrors ()
 Returns detailed information on all plugin errors accurred as a vector of strings (one string per error). More...
 
static bool isInitialized ()
 Returns a value indicating if the PluginManager is initialized successfully (i.e. all plugins from the loading queue are loaded and initialized). More...
 

Detailed Description

The Editor::PluginManager is the main controller class of the Plugin System, it is responsible for:

  • Locating dynamic libraries in folders specified by the user.
  • Plugins initialization their lifecycle management and destruction via the instances of PluginInfo class.
  • Building plugins loading queue, as the order in which the plugins are loaded is important. If a plugin has a required dependency it expects for certain symbols to be loaded.
  • Providing the user with information on plugins. Currently used to build target UI in the Editor.

Member Function Documentation

◆ allErrors()

static Unigine::Vector<Unigine::String> Editor::PluginManager::allErrors ( )
static

Returns detailed information on all plugin errors accurred as a vector of strings (one string per error).

◆ hasError()

static bool Editor::PluginManager::hasError ( )
static

Returns true if at least one error has occurred when loading any of the plugins available. If the result is positive, you can use the allErrors() method to get detailed information on all errors.

◆ initializationCompleted

void Editor::PluginManager::initializationCompleted ( )
signal

This signal is emitted when the PluginManager initialization is completed (i.e. all plugins from the loading queue are loaded and initialized).

◆ instance()

static PluginManager* Editor::PluginManager::instance ( )
static

Returns the instance of the PluginManager class. This method is used to subscribe to signals.

Returns
PluginManager class instance.

Example:

, this, &SomeClass::plugin_manager_initialized);

◆ isInitialized()

static bool Editor::PluginManager::isInitialized ( )
static

Returns a value indicating if the PluginManager is initialized successfully (i.e. all plugins from the loading queue are loaded and initialized).

Returns
true if the PluginManager was successfully initialized; otherwise, false.

◆ loadPlugin()

static bool Editor::PluginManager::loadPlugin ( PluginInfo plugin_info)
static

Loads and initializes the plugin. (PluginInfo states LOADED and RUNNING).

◆ loadPlugins()

static void Editor::PluginManager::loadPlugins ( )
static

Loads and initializes all available plugins from the list generated by calling the loadPluginSpecs() method (PluginInfo states LOADED and RUNNING).

◆ loadPluginSpecs()

static void Editor::PluginManager::loadPluginSpecs ( const Unigine::Vector< Unigine::String > &  search_paths)
static

Loads specifications for all plugins found in the specified directories and tries to read all plugins metadata and resolve all dependencies (change the state of all PluginInfo instances from INVALID to RESOLVED). This method builds the list of all available plugins.

Parameters
search_pathsList of directories to look for plugin binary files in.

◆ plugins()

static Unigine::Vector<PluginInfo *> Editor::PluginManager::plugins ( )
static

Returns information on all plugins currently available as a vector of PluginInfo items containing all necessary information on each plugin.

◆ unloadPlugin()

static bool Editor::PluginManager::unloadPlugin ( PluginInfo plugin_info)
static

Destroys the loaded plugin and unloads its dynamic library from memory. (PluginInfo states STOPPED and UNLOADED).

◆ unloadPlugins()

static void Editor::PluginManager::unloadPlugins ( )
static

Destroys all currently loaded plugins and unloads dynamic libraries from memory (PluginInfo states STOPPED and UNLOADED).