Marble::RenderPlugin

#include <RenderPlugin.h>

Inheritance diagram for Marble::RenderPlugin:

[legend]

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

Public Types inherited from QObject
typedef	QObjectList

Properties
QString	description

bool	enabled

QString	name

QString	nameId

bool	userCheckable

QString	version

bool	visible

Properties inherited from QObject
	objectName

Signals
void	actionGroupsChanged ()

void	enabledChanged (bool enable)

void	repaintNeeded (const QRegion &dirtyRegion=QRegion())

void	settingsChanged (const QString &nameId)

void	userCheckableChanged (bool isUserCheckable)

void	visibilityChanged (bool visible, const QString &nameId)

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)

Public Member Functions
	RenderPlugin (const MarbleModel *marbleModel)

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 override

virtual RenderType	renderType () const

QString	runtimeTrace () const override

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)

QBindable< QString >	bindableObjectName ()

bool	blockSignals (bool block)

const QObjectList &	children () const const

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

void	deleteLater ()

void	destroyed (QObject *obj)

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

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

void	dumpObjectInfo () const const

void	dumpObjectTree () const const

QList< QByteArray >	dynamicPropertyNames () const const

virtual bool	event (QEvent *e)

T	findChild (const QString &name, Qt::FindChildOptions options) const const

QList< T >	findChildren (const QRegularExpression &re, Qt::FindChildOptions options) const const

QList< T >	findChildren (const QString &name, Qt::FindChildOptions options) const const

QList< T >	findChildren (Qt::FindChildOptions options) const const

bool	inherits (const char *className) const const

void	installEventFilter (QObject *filterObj)

bool	isQuickItemType () const const

bool	isWidgetType () const const

bool	isWindowType () const const

void	killTimer (int id)

virtual const QMetaObject *	metaObject () const const

void	moveToThread (QThread *targetThread)

QString	objectName () const const

void	objectNameChanged (const QString &objectName)

QObject *	parent () const const

QVariant	property (const char *name) const const

	Q_CLASSINFO (Name, Value)

	Q_EMIT Q_EMIT

	Q_ENUM (...)

	Q_ENUM_NS (...)

	Q_ENUMS (...)

	Q_FLAG (...)

	Q_FLAG_NS (...)

	Q_FLAGS (...)

	Q_GADGET Q_GADGET

	Q_GADGET_EXPORT (EXPORT_MACRO)

	Q_INTERFACES (...)

	Q_INVOKABLE Q_INVOKABLE

	Q_MOC_INCLUDE Q_MOC_INCLUDE

	Q_NAMESPACE Q_NAMESPACE

	Q_NAMESPACE_EXPORT (EXPORT_MACRO)

	Q_OBJECT Q_OBJECT

	Q_PROPERTY (...)

	Q_REVISION Q_REVISION

	Q_SET_OBJECT_NAME (Object)

	Q_SIGNAL Q_SIGNAL

	Q_SIGNALS Q_SIGNALS

	Q_SLOT Q_SLOT

	Q_SLOTS Q_SLOTS

T	qobject_cast (const QObject *object)

T	qobject_cast (QObject *object)

	QT_NO_NARROWING_CONVERSIONS_IN_CONNECT QT_NO_NARROWING_CONVERSIONS_IN_CONNECT

void	removeEventFilter (QObject *obj)

void	setObjectName (const QString &name)

void	setObjectName (QAnyStringView name)

void	setParent (QObject *parent)

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

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

bool	signalsBlocked () const const

int	startTimer (int interval, Qt::TimerType timerType)

int	startTimer (std::chrono::milliseconds interval, Qt::TimerType timerType)

QThread *	thread () const const

Public Member Functions inherited from Marble::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 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

Protected Member Functions
bool	eventFilter (QObject , QEvent ) override

Protected Member Functions inherited from QObject
virtual void	childEvent (QChildEvent *event)

virtual void	connectNotify (const QMetaMethod &signal)

virtual void	customEvent (QEvent *event)

virtual void	disconnectNotify (const QMetaMethod &signal)

bool	isSignalConnected (const QMetaMethod &signal) const const

int	receivers (const char *signal) const const

QObject *	sender () const const

int	senderSignalIndex () const const

virtual void	timerEvent (QTimerEvent *event)

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

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

QMetaObject::Connection	connect (const QObject sender, PointerToMemberFunction signal, const QObject context, Functor functor, Qt::ConnectionType type)

QMetaObject::Connection	connect (const QObject sender, PointerToMemberFunction signal, const QObject receiver, PointerToMemberFunction method, Qt::ConnectionType type)

QMetaObject::Connection	connect (const QObject *sender, PointerToMemberFunction signal, Functor functor)

bool	disconnect (const QMetaObject::Connection &connection)

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)

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

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

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 37 of file RenderPlugin.h.

Member Enumeration Documentation

◆ RenderType

enum Marble::RenderPlugin::RenderType

A Type of plugin.

Definition at line 53 of file RenderPlugin.h.

Property Documentation

◆ description

QString Marble::RenderPlugin::description

read

Definition at line 44 of file RenderPlugin.h.

◆ enabled

bool Marble::RenderPlugin::enabled

readwrite

Definition at line 45 of file RenderPlugin.h.

◆ name

QString Marble::RenderPlugin::name

read

Definition at line 41 of file RenderPlugin.h.

◆ nameId

QString Marble::RenderPlugin::nameId

read

Definition at line 42 of file RenderPlugin.h.

◆ userCheckable

bool Marble::RenderPlugin::userCheckable

readwrite

Definition at line 47 of file RenderPlugin.h.

◆ version

QString Marble::RenderPlugin::version

read

Definition at line 43 of file RenderPlugin.h.

◆ visible

bool Marble::RenderPlugin::visible

readwrite

Definition at line 46 of file RenderPlugin.h.

Constructor & Destructor Documentation

◆ RenderPlugin()

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

explicit

Definition at line 51 of file RenderPlugin.cpp.

◆ ~RenderPlugin()

Marble::RenderPlugin::~RenderPlugin ( )

override

Definition at line 63 of file RenderPlugin.cpp.

Member Function Documentation

◆ action

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 73 of file RenderPlugin.cpp.

◆ actionGroups()

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

Definition at line 83 of file RenderPlugin.cpp.

◆ actionGroupsChanged

void Marble::RenderPlugin::actionGroupsChanged ( )

signal

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

◆ enabled()

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

Definition at line 155 of file RenderPlugin.cpp.

◆ enabledChanged

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

signal

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

See also: setEnabled

◆ eventFilter()

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

overrideprotectedvirtual

Reimplemented from QObject.

Definition at line 201 of file RenderPlugin.cpp.

◆ guiString()

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

◆ isUserCheckable()

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 165 of file RenderPlugin.cpp.

◆ marbleModel()

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 68 of file RenderPlugin.cpp.

◆ newInstance()

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.

◆ renderState()

RenderState Marble::RenderPlugin::renderState ( ) const

override

Definition at line 191 of file RenderPlugin.cpp.

◆ renderType()

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::AbstractDataPlugin, and Marble::AbstractFloatItem.

Definition at line 186 of file RenderPlugin.cpp.

◆ repaintNeeded

void Marble::RenderPlugin::repaintNeeded ( const 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.

◆ restoreDefaultSettings

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 206 of file RenderPlugin.cpp.

◆ runtimeTrace()

QString Marble::RenderPlugin::runtimeTrace ( ) const

override

Definition at line 196 of file RenderPlugin.cpp.

◆ setEnabled

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

slot

setting 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 124 of file RenderPlugin.cpp.

◆ setSetting

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 216 of file RenderPlugin.cpp.

◆ setSettings()

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::AbstractFloatItem.

Definition at line 180 of file RenderPlugin.cpp.

◆ setting

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 228 of file RenderPlugin.cpp.

◆ settingKeys

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 211 of file RenderPlugin.cpp.

◆ settings()

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::AbstractFloatItem.

Definition at line 170 of file RenderPlugin.cpp.

◆ settingsChanged

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

signal

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

◆ setUserCheckable

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

slot

setting 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 146 of file RenderPlugin.cpp.

◆ setVisible

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

slot

setting visible

If visible = true, plugin will be visible

Parameters

visible visibility of the plugin

See also: visible

Definition at line 136 of file RenderPlugin.cpp.

◆ toolbarActionGroups()

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

Definition at line 88 of file RenderPlugin.cpp.

◆ userCheckableChanged

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

signal

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

See also: setUserCheckable

◆ visibilityChanged

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

signal

This signal is emitted if the visibility is changed with.

See also: setVisible

◆ visible()

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

Definition at line 160 of file RenderPlugin.cpp.

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

KDE's Doxygen guidelines are available online.

Class Picker

Quick Links

About Marble

Marble::RenderPlugin

Public Types

Properties

Signals

Public Slots

Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ RenderType

Property Documentation

◆ description

◆ enabled

◆ name

◆ nameId

◆ userCheckable

◆ version

◆ visible

Constructor & Destructor Documentation

◆ RenderPlugin()

◆ ~RenderPlugin()

Member Function Documentation

◆ action

◆ actionGroups()

◆ actionGroupsChanged

◆ enabled()

◆ enabledChanged

◆ eventFilter()

◆ guiString()

◆ isUserCheckable()

◆ marbleModel()

◆ newInstance()

◆ renderState()

◆ renderType()

◆ repaintNeeded

◆ restoreDefaultSettings

◆ runtimeTrace()

◆ setEnabled

◆ setSetting

◆ setSettings()

◆ setting

◆ settingKeys

◆ settings()

◆ settingsChanged

◆ setUserCheckable

◆ setVisible

◆ toolbarActionGroups()

◆ userCheckableChanged

◆ visibilityChanged

◆ visible()