Ra::Plugins::RadiumPluginInterface Class Reference

Interface class for Radiums plugins. More...

#include <PluginBase/RadiumPluginInterface.hpp>

Collaboration diagram for Ra::Plugins::RadiumPluginInterface:

Public Member Functions
virtual void	registerPlugin (const Context &context)=0
	Pass arguments for plugin initialization. This method must create and register all the services that the plugin wants to offer : system, renderers, materials, Ui ... More...
virtual bool	doAddWidget (QString &name)=0
	Tells wether the plugin wants to add a widget (inside the UI tab widget) or not. If it does, it must provide a name for it, and getWidget() will be called. More...
virtual QWidget *	getWidget ()=0
	Creates the widget to be added to the ui and then returns it. If connections are needed (between plugin ui and plugin internals) they have to be created here. More...
virtual bool	doAddMenu ()=0
	Tells wether the plugin wants to add a menu or not. If it does, getMenu() will be called. More...
virtual QMenu *	getMenu ()=0
	Creates to menu to be added to the ui and then returns it. More...
virtual bool	doAddAction (int &nb)=0
	Tells wether the plugin wants to add actions or not. If it does, getAction() will be called for each one of them. More...
virtual QAction *	getAction (int id)=0
	Returns the action to be added to the ui and then returns it. More...
virtual bool	doAddRenderer ()
virtual void	addRenderers (std::vector< std::shared_ptr< Ra::Engine::Rendering::Renderer >> *)
	addRenderers More...
virtual bool	doAddFileLoader ()
virtual void	addFileLoaders (std::vector< std::shared_ptr< Core::Asset::FileLoaderInterface >> *)
virtual void	openGlInitialize (const Context &)
	openGlInitialize More...
virtual bool	doAddROpenGLInitializer ()

Detailed Description

Interface class for Radiums plugins.

To write your own plugin, you need to write a class as follow:

class MyPlugin : public QObject, Ra::Plugins::RadiumPluginInterface
{
    Q_OBJECT
    Q_RADIUM_PLUGIN_METADATA
    Q_INTERFACES( Ra::Plugins::RadiumPluginInterface )
 
public:
    MyPlugin();
    ~MyPlugin() override;
 
    virtual void registerPlugin( const Ra::Plugins::Context& context ) override;
 
    virtual bool doAddWidget( QString& name ) override;
    virtual QWidget* getWidget() override;
 
    virtual bool doAddMenu() override;
    virtual QMenu* getMenu() override;
 
    virtual bool doAddAction( int &nb ) override;
    virtual QAction* getAction( int id ) override;
};

Note

Q_RADIUM_PLUGIN_METADATA: we use this macro to load a default metadata files, which sets the basic metadata required by Radium. The macro is defined in RaPluginBase.hpp. If you need to use your own file, you have to extend the filespluginMetaDataXXXX.json, packaged with Radium in the following folder

• source tree: src/PluginBase/
• install tree: lib/cmake/Radium/ Then, replace Q_RADIUM_PLUGIN_METADATA by Q_PLUGIN_METADATA( IID "RadiumEngine.PluginInterface" FILE "yourPluginMetaDataRelease.json" ) or Q_PLUGIN_METADATA( IID "RadiumEngine.PluginInterface" FILE "yourPluginMetaDataDebug.json" ) depending on the debug mode

Definition at line 72 of file RadiumPluginInterface.hpp.

Member Function Documentation

addFileLoaders()

virtual void Ra::Plugins::RadiumPluginInterface::addFileLoaders ( std::vector< std::shared_ptr< Core::Asset::FileLoaderInterface >> *  )

inlinevirtual

Add the file loader services offered by the plugin

Parameters

fl	The set of file loader to add

Definition at line 162 of file RadiumPluginInterface.hpp.

addRenderers()

virtual void Ra::Plugins::RadiumPluginInterface::addRenderers ( std::vector< std::shared_ptr< Ra::Engine::Rendering::Renderer >> *  )

inlinevirtual

addRenderers

Parameters

rds	the renderers that the plugin wants to expose to the application.

Warning

Allocated renderers are given to the application that takes ownership. They MUST not be destroyed by the plugin

Definition at line 149 of file RadiumPluginInterface.hpp.

doAddAction()

virtual bool Ra::Plugins::RadiumPluginInterface::doAddAction ( int &  nb )

pure virtual

Tells wether the plugin wants to add actions or not. If it does, getAction() will be called for each one of them.

Parameters

nb	the number of action the plugin wants to add.

Returns

True if the plugin wants to add a menu, false otherwise

doAddFileLoader()

virtual bool Ra::Plugins::RadiumPluginInterface::doAddFileLoader ( )

inlinevirtual

Tells if the system will add a file loader

Returns

true if a file loader service is offered

Definition at line 155 of file RadiumPluginInterface.hpp.

doAddMenu()

virtual bool Ra::Plugins::RadiumPluginInterface::doAddMenu ( )

pure virtual

Tells wether the plugin wants to add a menu or not. If it does, getMenu() will be called.

Returns

True if the plugin wants to add a menu, false otherwise

doAddRenderer()

virtual bool Ra::Plugins::RadiumPluginInterface::doAddRenderer ( )

inlinevirtual

Tells if the plugin will add a renderer

Returns

true if the plugin offer rendering service

Definition at line 139 of file RadiumPluginInterface.hpp.

doAddROpenGLInitializer()

virtual bool Ra::Plugins::RadiumPluginInterface::doAddROpenGLInitializer ( )

inlinevirtual

Tells if the plugin offer OpenGL based services that need to be initialized after the OpenGL context is created.

Returns

true if plugin offers OppenGL services

Definition at line 191 of file RadiumPluginInterface.hpp.

doAddWidget()

virtual bool Ra::Plugins::RadiumPluginInterface::doAddWidget ( QString &  name )

pure virtual

Tells wether the plugin wants to add a widget (inside the UI tab widget) or not. If it does, it must provide a name for it, and getWidget() will be called.

Parameters

name	Name of the tab to be added, if needed.

Returns

True if the plugin wants to add a widget, false otherwise

getAction()

virtual QAction* Ra::Plugins::RadiumPluginInterface::getAction ( int  id )

pure virtual

Returns the action to be added to the ui and then returns it.

Returns

The action to add.

Warning

This mechanism implies QAction copies and does not allow to control the appearance of multiple actions with interlocked behaviors, e.g. play/pause and stop buttons.

getMenu()

virtual QMenu* Ra::Plugins::RadiumPluginInterface::getMenu ( )

pure virtual

Creates to menu to be added to the ui and then returns it.

Returns

The created menu

Todo:

Find a better name ?

getWidget()

virtual QWidget* Ra::Plugins::RadiumPluginInterface::getWidget ( )

pure virtual

Creates the widget to be added to the ui and then returns it. If connections are needed (between plugin ui and plugin internals) they have to be created here.

Returns

The created and configured widget

Todo:

Find a better name for this ?

openGlInitialize()

virtual void Ra::Plugins::RadiumPluginInterface::openGlInitialize ( const Context &  )

inlinevirtual

openGlInitialize

Parameters

context

(const PluginContext& context) the Plugin context

See also

https://herbsutter.com/2013/06/05/gotw-91-solution-smart-pointer-parameters/ for the reason a const QOpenGLContext * is given

Warning

Allocated renderers are given to the application and MUST not be destroyed by the plugin

Note

Plugins that want to manage OpenGL resources MUST ENSURE at the time they create/access these resources that the current openGLContext is the one pass when initializing OpenGL here and stored in the PluginContext ...

When this function is called from the application, The active OpenGL Context is the one that will be used for rendering.

Developers of plugins that need to manage OpenGL resources in a direct way (recommended for plugins that manage OpenGL resources for rendering or interaction with rendering) must implement this method and memorize the viewer of the PluginContext. Each time they need to create or destroy an OpenGL resource, they must activate this context (viewer->makeCurrent()) and realease it after usage (viewer->doneCurrent())

See also

Ra::Gui::Viewer

Definition at line 184 of file RadiumPluginInterface.hpp.

registerPlugin()

virtual void Ra::Plugins::RadiumPluginInterface::registerPlugin ( const Context &  context )

pure virtual

Pass arguments for plugin initialization. This method must create and register all the services that the plugin wants to offer : system, renderers, materials, Ui ...

Parameters

context

: plugin context containing the engine and UI interfaces.

---

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

• /home/runner/work/Radium-Engine/Radium-Engine/src/Radium-Engine/src/PluginBase/RadiumPluginInterface.hpp