tlp::Plugin Class Reference

#include <Plugin.h>

Inheritance diagram for tlp::Plugin:

Public Member Functions
virtual std::string	author () const =0
virtual std::string	category () const =0
virtual std::string	date () const =0
void	declareDeprecatedName (const std::string &oldName)
std::string	deprecatedName ()
virtual std::string	group () const =0
virtual std::string	icon () const
virtual int	id () const
virtual std::string	info () const =0
virtual std::string	major () const
virtual std::string	minor () const
virtual std::string	name () const =0
virtual std::string	programmingLanguage () const
virtual std::string	release () const =0
virtual std::string	tulipMajor () const
virtual std::string	tulipMinor () const
virtual std::string	tulipRelease () const =0

Protected Attributes
std::string	oldName

Detailed Description

Top-level interface for plug-ins.

This class holds meta-information about a plug-in (group/author/version...). It stands as a unique base-class for every plugin type. This interface is not intended to be directly subclassed. Plugin objects are mainly used internally into the plugin lister system.

This class also holds extra information about the Tulip system such as the library version the plugin was built against. Plugin creation is handled by factories generated by the PLUGIN macro and the default Plugin constructor should never be called as is.

See also

tlp::WithParameters for the ). What follows in the @defgroup declaration is the pretty name that will appear into the final HTML document. and retrieval of parameters

tlp::WithDependencies for the ). What follows in the @defgroup declaration is the pretty name that will appear into the final HTML document. and retrieval of dependencies

tlp::PluginFactory for plugin creation and registration

tlp::PluginContext and its subclasses for passing runtime parameters.

tlp::Algorithm for plugins operating on the tlp::Graph structure.

tlp::PropertyAlgorithm and its subclasses for plugins operating on graph properties

tlp::View for panel plugins

tlp::Interactor for plugins responsible for user interactions.

tlp::Perspective for plugins handling the main GUI

Definition at line 86 of file Plugin.h.

Member Function Documentation

author()

virtual std::string tlp::Plugin::author ( ) const

pure virtual

The name of the author of this plug-in.

Returns

the name of the author.

category()

virtual std::string tlp::Plugin::category ( ) const

pure virtual

A string identifier for a plugin used for categorization purposes.

Returns

std::string the category of the plugin.

Implemented in tlp::View, tlp::Perspective, tlp::Interactor, tlp::StringAlgorithm, tlp::SizeAlgorithm, tlp::LayoutAlgorithm, tlp::IntegerAlgorithm, tlp::DoubleAlgorithm, tlp::ColorAlgorithm, tlp::BooleanAlgorithm, tlp::PropertyAlgorithm, and tlp::Algorithm.

date()

virtual std::string tlp::Plugin::date ( ) const

pure virtual

The creation date of the plug-in. This date is in a free format, but most Tulip plug-ins use a DD/MM/YYYY.

Returns

the creation date.

declareDeprecatedName()

void tlp::Plugin::declareDeprecatedName

(

const std::string &

oldName

)

Allow to declare the previous name of a plugin as deprecated in order to keep an ascending compatibility at running time.

deprecatedName()

std::string tlp::Plugin::deprecatedName ( )

inline

Returns

the old name of the plugin if any; returns an empty string if not.

Definition at line 204 of file Plugin.h.

group()

virtual std::string tlp::Plugin::group ( ) const

pure virtual

Returns the name of the group this plug-in belongs to. Groups and sub-groups are separated by two colons. e.g. trees::planar trees.

Returns

the group name of this plug-in.

icon()

virtual std::string tlp::Plugin::icon ( ) const

virtual

The icon (preferably a thumbnail) of the plugin.

Returns

std::string the icon path

Reimplemented in tlp::View, tlp::Perspective, tlp::Interactor, and tlp::Algorithm.

id()

virtual int tlp::Plugin::id ( ) const

virtual

Returns the ID of the glyph this factory builds. @TODO this member should be removed once there is a system in Tulip to handle glyphs.

Returns

int the id of the glyph.

info()

virtual std::string tlp::Plugin::info ( ) const

pure virtual

Information about the plug-in, from the plug-in author. This information can contains anything, and the developer is completely free to put anything here. Most plug-ins by the Tulip team use an html format to generate help from these information.

Returns

string The information associated with this plug-in.

major()

virtual std::string tlp::Plugin::major ( ) const

virtual

Only the major of the plug-in version. A version should be X.Y, X being the major.

Returns

The major part of the plug-in version.

minor()

virtual std::string tlp::Plugin::minor ( ) const

virtual

Only the minor of the plug-in version. A version should be X.Y, Y being the major.

Returns

The minor part of the plug-in version.

name()

virtual std::string tlp::Plugin::name ( ) const

pure virtual

Returns the name of the plug-in, as registered in the Tulip plug-in system. This name must be unique, and if multiple plug-ins have the same name, only the latest encountered will be considered.

Returns

string the name of the plug-in.

programmingLanguage()

virtual std::string tlp::Plugin::programmingLanguage ( ) const

virtual

Returns

Return the a string indicating the programming language used to write the plugin (C++, Python).

release()

virtual std::string tlp::Plugin::release ( ) const

pure virtual

The release version of the plug-in, including major and minor. The version should be X.Y, X being the major, and Y the minor.

Returns

string The release version.

tulipMajor()

virtual std::string tlp::Plugin::tulipMajor ( ) const

virtual

Returns

The major Tulip version the plug-in was built with.

tulipMinor()

virtual std::string tlp::Plugin::tulipMinor ( ) const

virtual

Returns

Return the minor Tulip version this plug-in was built with.

tulipRelease()

virtual std::string tlp::Plugin::tulipRelease ( ) const

pure virtual

The version of Tulip this plug-in was built with. Tulip versions are X.Y.Z, X being the major, Y the minor, and Z the patch.

Returns

The Tulip version the plug-in was built with.