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
|
//##########################################################################
//# #
//# CLOUDCOMPARE #
//# #
//# This program is free software; you can redistribute it and/or modify #
//# it under the terms of the GNU General Public License as published by #
//# the Free Software Foundation; version 2 of the License. #
//# #
//# This program is distributed in the hope that it will be useful, #
//# but WITHOUT ANY WARRANTY; without even the implied warranty of #
//# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the #
//# GNU General Public License for more details. #
//# #
//# COPYRIGHT: EDF R&D / TELECOM ParisTech (ENST-TSI) #
//# #
//##########################################################################
#ifndef CC_STD_PLUGIN_INTERFACE_HEADER
#define CC_STD_PLUGIN_INTERFACE_HEADER
//Qt
#include <QWidget>
#include <QActionGroup>
//qCC_db
#include <ccHObject.h>
//qCC
#include "ccDefaultPluginInterface.h"
#include "ccMainAppInterface.h"
//UI Modification flags
#define CC_PLUGIN_REFRESH_GL_WINDOWS 0x00000001
#define CC_PLUGIN_REFRESH_ENTITY_BROWSER 0x00000002
#define CC_PLUGIN_EXPAND_DB_TREE 0x00000004
//! Standard CC plugin interface
/** Version 1.5
The plugin is now responsible for its own actions (QAction ;)
and the associated ccMainAppInterface member should give it
access to everything it needs in the main application.
**/
class ccStdPluginInterface : public ccDefaultPluginInterface
{
public:
//! Default constructor
ccStdPluginInterface( const QString &resourcePath = QString() ) :
ccDefaultPluginInterface( resourcePath )
, m_app(nullptr)
{
}
//! Destructor
virtual ~ccStdPluginInterface() = default;
//inherited from ccPluginInterface
virtual CC_PLUGIN_TYPE getType() const override { return CC_STD_PLUGIN; }
//! Sets application entry point
/** Called just after plugin creation by qCC
**/
virtual void setMainAppInterface(ccMainAppInterface* app)
{
m_app = app;
if (m_app)
{
//we use the same 'unique ID' generator in plugins as in the main
//application (otherwise we'll have issues with 'unique IDs'!)
ccObject::SetUniqueIDGenerator(m_app->getUniqueIDGenerator());
}
}
//! A callback pointer to the main app interface for use by plugins
/** Any plugin (and its tools) may need to access methods of this interface
**/
virtual ccMainAppInterface * getMainAppInterface() { return m_app; }
//! Get a list of actions for this plugin
virtual QList<QAction *> getActions() = 0;
//! This method is called by the main application whenever the entity selection changes
/** Does nothing by default. Should be re-implemented by the plugin if necessary.
\param selectedEntities currently selected entities
**/
virtual void onNewSelection(const ccHObject::Container& selectedEntities) { /*ignored by default*/ }
//! Shortcut to ccMainAppInterface::dispToConsole
inline virtual void dispToConsole(QString message, ccMainAppInterface::ConsoleMessageLevel level = ccMainAppInterface::STD_CONSOLE_MESSAGE)
{
if (m_app)
{
m_app->dispToConsole(message, level);
}
}
protected:
//! Main application interface
ccMainAppInterface* m_app;
};
Q_DECLARE_METATYPE(const ccStdPluginInterface *);
Q_DECLARE_INTERFACE(ccStdPluginInterface,"edf.rd.CloudCompare.ccStdPluginInterface/1.4")
#endif //CC_STD_PLUGIN_INTERFACE_HEADER
|
