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
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
|
/*
* This program source code file is part of KiCad, a free EDA CAD application.
*
* Copyright (C) 2015-2016 Cirilo Bernardo <cirilo.bernardo@gmail.com>
* Copyright The KiCad Developers, see AUTHORS.txt for contributors.
*
* 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; either version 2
* of the License, or (at your option) any later version.
*
* 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.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, you may find one here:
* http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
* or you may search the http://www.gnu.org website for the version 2 license,
* or you may write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
*/
/**
* @file pluginldr.h
* defines the most basic functions which all KiCad plugin loaders require.
*/
#ifndef PLUGINLDR_H
#define PLUGINLDR_H
#include <string>
#include <wx/dynlib.h>
#include <wx/string.h>
// Mask for plugin loader tracing.
extern const wxChar* const tracePluginLoader;
#define MASK_PLUGINLDR wxT( "PLUGIN_LOADER" )
// helper function to link functions in the plugin
#define LINK_ITEM( funcPtr, funcType, funcName ) \
funcPtr = (funcType) m_PluginLoader.GetSymbol( wxT( funcName ) )
// typedefs of the functions exported by the 3D Plugin Class
typedef char const* (*GET_PLUGIN_CLASS) ( void );
typedef void (*GET_CLASS_VERSION) ( unsigned char*, unsigned char*,
unsigned char*, unsigned char* );
typedef bool (*CHECK_CLASS_VERSION) ( unsigned char, unsigned char,
unsigned char, unsigned char );
typedef const char* (*GET_PLUGIN_NAME) ( void );
typedef void (*GET_VERSION) ( unsigned char*, unsigned char*,
unsigned char*, unsigned char* );
class KICAD_PLUGIN_LDR
{
public:
KICAD_PLUGIN_LDR();
virtual ~KICAD_PLUGIN_LDR();
/**
* Return the version information of the Plugin Loader for plugin compatibility checking.
*/
virtual void GetLoaderVersion( unsigned char* Major, unsigned char* Minor,
unsigned char* Patch, unsigned char* Revision ) const = 0;
/**
* Open a plugin of the given class, performs version compatibility checks,
* and links all required functions.
*
* @return true on success or false if failure. An error message may be accessible
* via GetLastError()
*/
virtual bool Open( const wxString& aFullFileName ) = 0;
/**
* Clean up and closes/unloads the plugin.
*/
virtual void Close( void ) = 0;
/**
* Return the value of the internal error string.
*/
std::string GetLastError( void ) const;
// Return the Plugin Class or NULL if no plugin loaded.
char const* GetKicadPluginClass( void );
// Return false if no plugin loaded.
bool GetClassVersion( unsigned char* Major, unsigned char* Minor,
unsigned char* Patch, unsigned char* Revision );
// Return false if the class version check fails or no plugin is loaded.
bool CheckClassVersion( unsigned char Major, unsigned char Minor,
unsigned char Patch, unsigned char Revision );
// Return the Plugin Name or NULL if no plugin loaded.
const char* GetKicadPluginName( void );
// Return false if no plugin is loaded.
bool GetVersion( unsigned char* Major, unsigned char* Minor,
unsigned char* Patch, unsigned char* Revision );
void GetPluginInfo( std::string& aPluginInfo );
protected:
/**
* Open a plugin of the specified class and links the extensions required by kicad_plugin.
*
* @return true on success otherwise false.
*/
bool open( const wxString& aFullFileName, const char* aPluginClass );
/**
* Nullify internal pointers in preparation for closing the plugin.
*/
void close( void );
/**
* Reopen a plugin.
*
* @return true on success or false on failure.
*/
bool reopen( void );
std::string m_error; // error message
// the plugin loader
wxDynamicLibrary m_PluginLoader;
private:
bool ok; // set TRUE if all functions are linked
GET_PLUGIN_CLASS m_getPluginClass;
GET_CLASS_VERSION m_getClassVersion;
CHECK_CLASS_VERSION m_checkClassVersion;
GET_PLUGIN_NAME m_getPluginName;
GET_VERSION m_getVersion;
wxString m_fileName; // name of last opened Plugin
std::string m_pluginInfo; // Name:Version tag for plugin
};
#endif // PLUGINLDR_H
|
