/usr/include/marble/PluginManager.h is in libmarble-dev 4:4.13.0-0ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 | //
// This file is part of the Marble Virtual Globe.
//
// This program is free software licensed under the GNU LGPL. You can
// find a copy of this license in LICENSE.txt in the top directory of
// the source code.
//
// Copyright 2006-2008 Torsten Rahn <tackat@kde.org>
// Copyright 2009 Jens-Michael Hoffmann <jensmh@gmx.de>
//
#ifndef MARBLE_PLUGINMANAGER_H
#define MARBLE_PLUGINMANAGER_H
#include <QObject>
#include <QList>
#include "marble_export.h"
namespace Marble
{
class RenderPlugin;
class PositionProviderPlugin;
class AbstractFloatItem;
class PluginManagerPrivate;
class SearchRunnerPlugin;
class ReverseGeocodingRunnerPlugin;
class RoutingRunnerPlugin;
class ParseRunnerPlugin;
/**
* @short The class that handles Marble's plugins.
*
* Ownership policy for plugins:
*
* On every invocation of createNetworkPlugins and
* createFloatItems the PluginManager creates new objects and transfers
* ownership to the calling site. In order to create
* the objects, the PluginManager internally has a list of the plugins
* which are owned by the PluginManager and destroyed by it.
*
*/
class MARBLE_EXPORT PluginManager : public QObject
{
Q_OBJECT
public:
explicit PluginManager( QObject* parent = 0 );
~PluginManager();
/**
* @brief Returns all available RenderPlugins.
*
* Ownership of the items remains in PluginManager.
* In order to use the RenderPlugins, first create new instances using
* RenderPlugin::newInstance().
*/
QList<const RenderPlugin *> renderPlugins() const;
/**
* @brief Add a RenderPlugin manually to the list of known plugins. Normally you
* don't need to call this method since all plugins are loaded automatically.
* @param plugin The plugin to add. Ownership retains with the caller.
*/
void addRenderPlugin( const RenderPlugin *plugin );
/**
* @brief Returns all available PositionProviderPlugins.
*
* Ownership of the items remains in PluginManager.
* In order to use the PositionProviderPlugins, first create new instances using
* PositionProviderPlugin::newInstance().
*/
QList<const PositionProviderPlugin *> positionProviderPlugins() const;
/**
* @brief Add a PositionProviderPlugin manually to the list of known plugins. Normally you
* don't need to call this method since all plugins are loaded automatically.
* @param plugin The plugin to add. Ownership retains with the caller.
*/
void addPositionProviderPlugin( const PositionProviderPlugin *plugin );
/**
* Returns all search runner plugins.
* @note: Runner plugins are owned by the PluginManager, do not delete them.
*/
QList<const SearchRunnerPlugin *> searchRunnerPlugins() const;
/**
* @brief Add a SearchRunnerPlugin manually to the list of known plugins. Normally you
* don't need to call this method since all plugins are loaded automatically.
* @param plugin The plugin to add. Ownership retains with the caller.
*/
void addSearchRunnerPlugin( const SearchRunnerPlugin *plugin );
/**
* Returns all reverse geocoding runner plugins.
* @note: The runner plugins are owned by the PluginManager, do not delete them.
*/
QList<const ReverseGeocodingRunnerPlugin *> reverseGeocodingRunnerPlugins() const;
/**
* @brief Add a ReverseGeocodingRunnerPlugin manually to the list of known plugins. Normally you
* don't need to call this method since all plugins are loaded automatically.
* @param plugin The plugin to add. Ownership retains with the caller.
*/
void addReverseGeocodingRunnerPlugin( const ReverseGeocodingRunnerPlugin *plugin );
/**
* Returns all routing runner plugins.
* @note: The runner plugins are owned by the PluginManager, do not delete them.
*/
QList<RoutingRunnerPlugin *> routingRunnerPlugins() const;
/**
* @brief Add a RoutingRunnerPlugin manually to the list of known plugins. Normally you
* don't need to call this method since all plugins are loaded automatically.
* @param plugin The plugin to add. Ownership retains with the caller.
*/
void addRoutingRunnerPlugin( RoutingRunnerPlugin * plugin );
/**
* Returns all parse runner plugins.
* @note: The runner plugins are owned by the PluginManager, do not delete them.
*/
QList<const ParseRunnerPlugin *> parsingRunnerPlugins() const;
/**
* @brief Add a ParseRunnerPlugin manually to the list of known plugins. Normally you
* don't need to call this method since all plugins are loaded automatically.
* @param plugin The plugin to add. Ownership retains with the caller.
*/
void addParseRunnerPlugin( const ParseRunnerPlugin *plugin );
Q_SIGNALS:
void renderPluginsChanged();
void positionProviderPluginsChanged();
void searchRunnerPluginsChanged();
void reverseGeocodingRunnerPluginsChanged();
void routingRunnerPluginsChanged();
void parseRunnerPluginsChanged();
private:
Q_DISABLE_COPY( PluginManager )
PluginManagerPrivate * const d;
};
}
#endif
|