#include <RenderPlugin.h>

Inheritance diagram for Marble::RenderPlugin:

Public Types
enum	RenderType { UnknownRenderType, TopLevelRenderType, PanelRenderType, OnlineRenderType, ThemeRenderType }

Public Slots
QAction *	action () const

void	restoreDefaultSettings ()

void	setEnabled (bool enabled)

bool	setSetting (const QString &key, const QVariant &value)

QVariant	setting (const QString &key) const

QStringList	settingKeys () const

void	setUserCheckable (bool isUserCheckable)

void	setVisible (bool visible)

Signals
void	actionGroupsChanged ()

void	enabledChanged (bool enable)

void	repaintNeeded (QRegion dirtyRegion=QRegion())

void	settingsChanged (QString nameId)

void	userCheckableChanged (bool isUserCheckable)

void	visibilityChanged (bool visible, const QString &nameId)

Public Member Functions
	RenderPlugin (const MarbleModel *marbleModel)

virtual	~RenderPlugin ()

virtual const QList < QActionGroup * > *	actionGroups () const

bool	enabled () const

virtual QString	guiString () const =0

bool	isUserCheckable () const

const MarbleModel *	marbleModel () const

virtual RenderPlugin *	newInstance (const MarbleModel *marbleModel) const =0

RenderState	renderState () const

virtual RenderType	renderType () const

virtual QString	runtimeTrace () const

virtual void	setSettings (const QHash< QString, QVariant > &settings)

virtual QHash< QString, QVariant >	settings () const

virtual const QList < QActionGroup * > *	toolbarActionGroups () const

bool	visible () const

Public Member Functions inherited from QObject
	QObject (QObject *parent)

	QObject (QObject parent, const char name)

virtual	~QObject ()

bool	blockSignals (bool block)

QObject *	child (const char objName, const char inheritsClass, bool recursiveSearch) const

const QObjectList &	children () const

const char *	className () const

bool	connect (const QObject sender, const char signal, const char *method, Qt::ConnectionType type) const

void	deleteLater ()

void	destroyed (QObject *obj)

bool	disconnect (const QObject receiver, const char method)

bool	disconnect (const char signal, const QObject receiver, const char *method)

void	dumpObjectInfo ()

void	dumpObjectTree ()

QList< QByteArray >	dynamicPropertyNames () const

virtual bool	event (QEvent *e)

T	findChild (const QString &name) const

QList< T >	findChildren (const QRegExp &regExp) const

QList< T >	findChildren (const QString &name) const

bool	inherits (const char *className) const

void	insertChild (QObject *object)

void	installEventFilter (QObject *filterObj)

bool	isA (const char *className) const

bool	isWidgetType () const

void	killTimer (int id)

virtual const QMetaObject *	metaObject () const

void	moveToThread (QThread *targetThread)

const char *	name () const

const char *	name (const char *defaultName) const

QString	objectName () const

QObject *	parent () const

QVariant	property (const char *name) const

void	removeChild (QObject *object)

void	removeEventFilter (QObject *obj)

void	setName (const char *name)

void	setObjectName (const QString &name)

void	setParent (QObject *parent)

bool	setProperty (const char *name, const QVariant &value)

bool	signalsBlocked () const

int	startTimer (int interval)

QThread *	thread () const

Public Member Functions inherited from Marble::RenderPluginInterface
virtual	~RenderPluginInterface ()

virtual QStringList	backendTypes () const =0

virtual void	initialize ()=0

virtual bool	isInitialized () const =0

virtual QString	renderPolicy () const =0

Public Member Functions inherited from Marble::PluginInterface
virtual	~PluginInterface ()

virtual QString	aboutDataText () const

virtual QString	copyrightYears () const =0

virtual QString	description () const =0

virtual QIcon	icon () const =0

virtual QString	name () const =0

virtual QString	nameId () const =0

virtual QList< PluginAuthor >	pluginAuthors () const =0

virtual QString	version () const =0

Public Member Functions inherited from Marble::LayerInterface
virtual	~LayerInterface ()

virtual bool	render (GeoPainter painter, ViewportParams viewport, const QString &renderPos, GeoSceneLayer *layer)=0

virtual QStringList	renderPosition () const =0

virtual qreal	zValue () const

Protected Member Functions
bool	eventFilter (QObject , QEvent )

Protected Member Functions inherited from QObject
bool	checkConnectArgs (const char signal, const QObject object, const char *method)

virtual void	childEvent (QChildEvent *event)

virtual void	connectNotify (const char *signal)

virtual void	customEvent (QEvent *event)

virtual void	disconnectNotify (const char *signal)

int	receivers (const char *signal) const

QObject *	sender () const

int	senderSignalIndex () const

virtual void	timerEvent (QTimerEvent *event)

Properties
QString	description

bool	enabled

QString	name

QString	nameId

bool	userCheckable

QString	version

bool	visible

Properties inherited from QObject
	objectName

Additional Inherited Members
Static Public Member Functions inherited from QObject
bool	connect (const QObject sender, const char signal, const QObject receiver, const char method, Qt::ConnectionType type)

bool	connect (const QObject sender, const QMetaMethod &signal, const QObject receiver, const QMetaMethod &method, Qt::ConnectionType type)

bool	disconnect (const QObject sender, const char signal, const QObject receiver, const char method)

bool	disconnect (const QObject sender, const QMetaMethod &signal, const QObject receiver, const QMetaMethod &method)

QString	tr (const char sourceText, const char disambiguation, int n)

QString	trUtf8 (const char sourceText, const char disambiguation, int n)

Static Protected Member Functions inherited from QObject
QByteArray	normalizeSignalSlot (const char *signalSlot)

Detailed Description

The abstract class that creates a renderable item.

Renderable Plugins can be used to extend Marble's functionality: They allow to draw stuff on top of the map / globe

Definition at line 43 of file RenderPlugin.h.

Member Enumeration Documentation

enum Marble::RenderPlugin::RenderType

A Type of plugin.

Enumerator
UnknownRenderType
TopLevelRenderType
PanelRenderType
OnlineRenderType
ThemeRenderType

Definition at line 59 of file RenderPlugin.h.

Constructor & Destructor Documentation

Marble::RenderPlugin::RenderPlugin ( const MarbleModel * marbleModel )

explicit

Definition at line 60 of file RenderPlugin.cpp.

Marble::RenderPlugin::~RenderPlugin ( )

virtual

Definition at line 78 of file RenderPlugin.cpp.

Member Function Documentation

QAction * Marble::RenderPlugin::action ( ) const

slot

Plugin's menu action.

The action is checkable and controls the visibility of the plugin.

Returns: action, displayed in menu

Definition at line 88 of file RenderPlugin.cpp.

const QList< QActionGroup * > * Marble::RenderPlugin::actionGroups ( ) const

virtual

Getting all actions.

This method is used by the main window to get all of the actions that this plugin defines. There is no guarantee where the main window will place the actions but it will generally be in a Menu. The returned QList should also contain all of the actions returned by

See also: toolbarActions().

Returns: a list of grouped actions

Reimplemented in Marble::AnnotatePlugin, and Marble::EclipsesPlugin.

Definition at line 98 of file RenderPlugin.cpp.

void Marble::RenderPlugin::actionGroupsChanged ( )

signal

This signal is emitted if the actions that the plugin supports change in any way.

bool Marble::RenderPlugin::enabled ( ) const

is enabled

This method indicates enableability of the plugin

If plugin is enabled it going to be displayed in Marble Menu as active action which can be

See also: setUserCheckable

Returns: enableability of the plugin

See also: setEnabled

void Marble::RenderPlugin::enabledChanged ( bool enable )

signal

This signal is emitted if the enabled property is changed with.

See also: setEnabled

bool Marble::RenderPlugin::eventFilter	(	QObject *	,
		QEvent *
	)

protectedvirtual

Reimplemented from QObject.

Reimplemented in Marble::StarsPlugin, Marble::AnnotatePlugin, Marble::OverviewMap, Marble::ElevationProfileFloatItem, Marble::EclipsesPlugin, Marble::NavigationFloatItem, Marble::PhotoPlugin, Marble::WikipediaPlugin, Marble::WeatherPlugin, Marble::FileViewFloatItem, Marble::OpenDesktopPlugin, Marble::SatellitesPlugin, Marble::RoutingPlugin, and Marble::License.

Definition at line 216 of file RenderPlugin.cpp.

virtual QString Marble::RenderPlugin::guiString ( ) const

pure virtual

String that should be displayed in GUI.

Using a "&" you can suggest key shortcuts

Example: "&Stars"

Returns: string for gui usage

Implemented in Marble::StarsPlugin, Marble::GraticulePlugin, Marble::AnnotatePlugin, Marble::FITemplateFloatItem, Marble::CrosshairsPlugin, Marble::EclipsesPlugin, Marble::ElevationProfileFloatItem, DeclarativeDataPlugin, Marble::twitterPlugin, Marble::OverviewMap, Marble::AprsPlugin, Marble::NavigationFloatItem, Marble::OpenCachingComPlugin, Marble::PositionMarker, Marble::GpsInfo, Marble::MeasureToolPlugin, Marble::Speedometer, Marble::OpenCachingPlugin, Marble::ElevationProfileMarker, Marble::PhotoPlugin, Marble::CompassFloatItem, Marble::InhibitScreensaverPlugin, Marble::SatellitesPlugin, Marble::WeatherPlugin, Marble::RoutingPlugin, Marble::FileViewFloatItem, Marble::MapScaleFloatItem, Marble::WikipediaPlugin, Marble::EarthquakePlugin, Marble::SunPlugin, Marble::License, Marble::OpenDesktopPlugin, Marble::ProgressFloatItem, Marble::AtmospherePlugin, Marble::PanoramioPlugin, Marble::FoursquarePlugin, and Marble::PostalCodePlugin.

bool Marble::RenderPlugin::isUserCheckable ( ) const

is user checkable

This method indicates user checkability of plugin's action displayed in application menu

Can control plugin visibility

Warning: User can do it only if

See also: enabled is true

Returns: checkability of the plugin

See also: setUserCheckable

Definition at line 180 of file RenderPlugin.cpp.

const MarbleModel * Marble::RenderPlugin::marbleModel ( ) const

Access to the MarbleModel.

Internal way to access the model of marble. Can be used to interact with the main application

Returns: marble model

See also: MarbleModel

Definition at line 83 of file RenderPlugin.cpp.

virtual RenderPlugin* Marble::RenderPlugin::newInstance ( const MarbleModel * marbleModel ) const

pure virtual

Creation a new instance of the plugin.

This method is used to create a new object of the current plugin using the marbleModel given.

Parameters

marbleModel base model

Returns: new instance of current plugin

Note: Typically this method is implemented with the help of the MARBLE_PLUGIN() macro.

Implemented in DeclarativeDataPlugin.

RenderState Marble::RenderPlugin::renderState ( ) const

virtual

Reimplemented from Marble::LayerInterface.

Reimplemented in DeclarativeDataPlugin.

Definition at line 206 of file RenderPlugin.cpp.

RenderPlugin::RenderType Marble::RenderPlugin::renderType ( ) const

virtual

Render type of the plugin.

Function for returning the type of plugin this is for. This affects where in the menu tree the action() is placed.

See also: RenderType

Returns: : The type of render plugin this is

Reimplemented in Marble::StarsPlugin, Marble::AbstractDataPlugin, Marble::EclipsesPlugin, Marble::CrosshairsPlugin, Marble::AbstractFloatItem, Marble::SatellitesPlugin, and Marble::AtmospherePlugin.

Definition at line 201 of file RenderPlugin.cpp.

void Marble::RenderPlugin::repaintNeeded ( QRegion dirtyRegion = QRegion() )

signal

This signal is emitted if an update of the view is needed.

If available with the dirtyRegion which is the region the view will change in. If dirtyRegion.isEmpty() returns true, the whole viewport has to be repainted.

void Marble::RenderPlugin::restoreDefaultSettings ( )

slot

Passes an empty set of settings to the plugin.

Well behaving plugins restore their settings to default values as a result of calling this method.

Definition at line 221 of file RenderPlugin.cpp.

QString Marble::RenderPlugin::runtimeTrace ( ) const

virtual

Returns a debug line for perfo/tracing issues.

Reimplemented from Marble::LayerInterface.

Reimplemented in Marble::AnnotatePlugin.

Definition at line 211 of file RenderPlugin.cpp.

void Marble::RenderPlugin::setEnabled ( bool enabled )

slot

settting enabled

If enabled = true, plugin will be enabled

If plugin is enabled it will be possible to show/hide it from menu (access from UI)

Parameters

enabled plugin's enabled state

See also: enabled

Definition at line 139 of file RenderPlugin.cpp.

bool Marble::RenderPlugin::setSetting	(	const QString &	key,
		const QVariant &	value
	)

slot

Change setting key's values.

Parameters

key	setting key
value	new value

This method applies value for the key

Returns: successfully changed or not

Definition at line 231 of file RenderPlugin.cpp.

void Marble::RenderPlugin::setSettings ( const QHash< QString, QVariant > & settings )

virtual

Set the settings of the plugin.

Usually this is called at startup to restore saved settings.

Parameters

new	plugin's settings

See also: settings

Reimplemented in Marble::StarsPlugin, Marble::GraticulePlugin, Marble::CrosshairsPlugin, Marble::PositionMarker, Marble::OverviewMap, Marble::EclipsesPlugin, Marble::NavigationFloatItem, Marble::CompassFloatItem, Marble::AprsPlugin, Marble::MeasureToolPlugin, Marble::PhotoPlugin, Marble::WikipediaPlugin, Marble::EarthquakePlugin, Marble::WeatherPlugin, Marble::SatellitesPlugin, Marble::OpenCachingPlugin, Marble::RoutingPlugin, Marble::OpenDesktopPlugin, and Marble::AbstractFloatItem.

Definition at line 195 of file RenderPlugin.cpp.

QVariant Marble::RenderPlugin::setting ( const QString & key ) const

slot

Getting setting value from the settings.

Parameters

key	setting's key index

This method should be used to get current value of key in settings hash table

Returns: setting value

Definition at line 244 of file RenderPlugin.cpp.

QStringList Marble::RenderPlugin::settingKeys ( ) const

slot

Full list of the settings keys.

This method should be used to get all possible settings' keys for the plugin's settings

Returns: list with the keys of settings

Definition at line 226 of file RenderPlugin.cpp.

QHash< QString, QVariant > Marble::RenderPlugin::settings ( ) const

virtual

Settings of the plugin.

Settings is the map (hash table) of plugin's settings This method is called to determine the current settings of the plugin for serialization, e.g. when closing the application.

Returns: plugin's settings

See also: setSettings

Reimplemented in Marble::StarsPlugin, Marble::GraticulePlugin, Marble::CrosshairsPlugin, Marble::PositionMarker, Marble::OverviewMap, Marble::EclipsesPlugin, Marble::NavigationFloatItem, Marble::CompassFloatItem, Marble::AprsPlugin, Marble::MeasureToolPlugin, Marble::PhotoPlugin, Marble::WikipediaPlugin, Marble::SatellitesPlugin, Marble::WeatherPlugin, Marble::EarthquakePlugin, Marble::RoutingPlugin, Marble::OpenCachingPlugin, Marble::OpenDesktopPlugin, and Marble::AbstractFloatItem.

Definition at line 185 of file RenderPlugin.cpp.

void Marble::RenderPlugin::settingsChanged ( QString nameId )

signal

This signal is emitted if the settings of the RenderPlugin changed.

void Marble::RenderPlugin::setUserCheckable ( bool isUserCheckable )

slot

settting user checkable

If isUserCheckable = true, user will get an option to control visibility in application menu

Parameters

isUserCheckable user checkability of the plugin

See also: isUserCheckable

Definition at line 161 of file RenderPlugin.cpp.

void Marble::RenderPlugin::setVisible ( bool visible )

slot

settting visible

If visible = true, plugin will be visible

Parameters

visible visibility of the plugin

See also: visible

Definition at line 151 of file RenderPlugin.cpp.

const QList< QActionGroup * > * Marble::RenderPlugin::toolbarActionGroups ( ) const

virtual

Getting all actions which should be placed in the toolbar.

This method returns a subset of the actions returned by

See also: actions() which are intended to be placed in a more prominent place such as a toolbar above the Marble Widget. You are not guaranteed that they will be in an actual toolbar but they will be visible and discoverable

Returns: a list of grouped toolbar actions

Reimplemented in Marble::AnnotatePlugin.

Definition at line 103 of file RenderPlugin.cpp.

void Marble::RenderPlugin::userCheckableChanged ( bool isUserCheckable )

signal

This signal is emitted if the user checkable property is changed with.

See also: setUserCheckable

void Marble::RenderPlugin::visibilityChanged	(	bool	visible,
		const QString &	nameId
	)

signal

This signal is emitted if the visibility is changed with.

See also: setVisible

bool Marble::RenderPlugin::visible ( ) const

is visible

This method indicates visibility of the plugin

If plugin is visible you can see it on the map/globe

Returns: visibility of the plugin

See also: setVisible

Property Documentation

QString Marble::RenderPlugin::description

read

Definition at line 50 of file RenderPlugin.h.

bool Marble::RenderPlugin::enabled

readwrite

Definition at line 51 of file RenderPlugin.h.

QString Marble::RenderPlugin::name

read

Definition at line 47 of file RenderPlugin.h.

QString Marble::RenderPlugin::nameId

read

Definition at line 48 of file RenderPlugin.h.

bool Marble::RenderPlugin::userCheckable

readwrite

Definition at line 53 of file RenderPlugin.h.

QString Marble::RenderPlugin::version

read

Definition at line 49 of file RenderPlugin.h.

bool Marble::RenderPlugin::visible

readwrite

Definition at line 52 of file RenderPlugin.h.

The documentation for this class was generated from the following files:

marble

Public Types

Public Slots

Signals

Public Member Functions

Protected Member Functions

Properties

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Property Documentation

marble

kdeedu API Reference

Search