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
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
|
// SPDX-License-Identifier: GPL-2.0-or-later
/*
Author: Ted Gould <ted@gould.cx>
Copyright (c) 2003-2005,2007
Released under GNU GPL v2+, read the file 'COPYING' for more information.
This file is the backend to the extensions system. These are
the parts of the system that most users will never see, but are
important for implementing the extensions themselves. This file
contains the base class for all of that.
*/
#ifndef SEEN_INKSCAPE_EXTENSION_IMPLEMENTATION_H
#define SEEN_INKSCAPE_EXTENSION_IMPLEMENTATION_H
#include <vector>
#include <sigc++/signal.h>
#include <glibmm/value.h>
#include <2geom/forward.h>
namespace Gtk {
class Widget;
}
class SPDocument;
class SPStyle;
namespace Inkscape {
namespace UI {
namespace View {
class View;
}
}
namespace XML {
class Node;
}
namespace Extension {
class Effect;
class Extension;
class Input;
class Output;
class Print;
namespace Implementation {
/**
* A cache for the document and this implementation.
*/
class ImplementationDocumentCache {
/**
* The document that this instance is working on.
*/
Inkscape::UI::View::View * _view;
public:
explicit ImplementationDocumentCache (Inkscape::UI::View::View * view) { _view = view;};
virtual ~ImplementationDocumentCache ( ) { return; };
Inkscape::UI::View::View const * view ( ) { return _view; };
};
/**
* Base class for all implementations of modules. This is whether they are done systematically by
* having something like the scripting system, or they are implemented internally they all derive
* from this class.
*/
class Implementation {
public:
// ----- Constructor / destructor -----
Implementation() = default;
virtual ~Implementation() = default;
// ----- Basic functions for all Extension -----
virtual bool load(Inkscape::Extension::Extension * /*module*/) { return true; }
virtual void unload(Inkscape::Extension::Extension * /*module*/) {}
/**
* Create a new document cache object.
* This function just returns \c NULL. Subclasses are likely
* to reimplement it to do something useful.
* @param ext The extension that is referencing us
* @param doc The document to create the cache of
* @return A new document cache that is valid as long as the document
* is not changed.
*/
virtual ImplementationDocumentCache * newDocCache (Inkscape::Extension::Extension * /*ext*/, Inkscape::UI::View::View * /*doc*/) { return nullptr; }
/** Verify any dependencies. */
virtual bool check(Inkscape::Extension::Extension * /*module*/) { return true; }
virtual bool cancelProcessing () { return true; }
virtual void commitDocument () {}
// ----- Input functions -----
/** Find out information about the file. */
virtual Gtk::Widget *prefs_input(Inkscape::Extension::Input *module,
gchar const *filename);
virtual SPDocument *open(Inkscape::Extension::Input * /*module*/,
gchar const * /*filename*/) { return nullptr; }
// ----- Output functions -----
/** Find out information about the file. */
virtual Gtk::Widget *prefs_output(Inkscape::Extension::Output *module);
virtual void save(Inkscape::Extension::Output * /*module*/, SPDocument * /*doc*/, gchar const * /*filename*/) {}
virtual void export_raster(
Inkscape::Extension::Output * /*module*/,
const SPDocument * /*doc*/,
std::string const &/*png_file*/,
gchar const * /*filename*/) {}
// ----- Effect functions -----
/** Find out information about the file. */
virtual Gtk::Widget * prefs_effect(Inkscape::Extension::Effect *module,
Inkscape::UI::View::View *view,
sigc::signal<void> *changeSignal,
ImplementationDocumentCache *docCache);
virtual void effect(Inkscape::Extension::Effect * /*module*/,
Inkscape::UI::View::View * /*document*/,
ImplementationDocumentCache * /*docCache*/) {}
// ----- Print functions -----
virtual unsigned setup(Inkscape::Extension::Print * /*module*/) { return 0; }
virtual unsigned set_preview(Inkscape::Extension::Print * /*module*/) { return 0; }
virtual unsigned begin(Inkscape::Extension::Print * /*module*/,
SPDocument * /*doc*/) { return 0; }
virtual unsigned finish(Inkscape::Extension::Print * /*module*/) { return 0; }
/**
* Tell the printing engine whether text should be text or path.
* Default value is false because most printing engines will support
* paths more than they'll support text. (at least they do today)
* \retval true Render the text as a path
* \retval false Render text using the text function (above)
*/
virtual bool textToPath(Inkscape::Extension::Print * /*ext*/) { return false; }
/**
* Get "fontEmbedded" param, i.e. tell the printing engine whether fonts should be embedded.
* Only available for Adobe Type 1 fonts in EPS output as of now
* \retval true Fonts have to be embedded in the output so that the user might not need
* to install fonts to have the interpreter read the document correctly
* \retval false Do not embed fonts
*/
virtual bool fontEmbedded(Inkscape::Extension::Print * /*ext*/) { return false; }
// ----- Rendering methods -----
virtual unsigned bind(Inkscape::Extension::Print * /*module*/,
Geom::Affine const & /*transform*/,
float /*opacity*/) { return 0; }
virtual unsigned release(Inkscape::Extension::Print * /*module*/) { return 0; }
virtual unsigned fill(Inkscape::Extension::Print * /*module*/,
Geom::PathVector const & /*pathv*/,
Geom::Affine const & /*ctm*/,
SPStyle const * /*style*/,
Geom::OptRect const & /*pbox*/,
Geom::OptRect const & /*dbox*/,
Geom::OptRect const & /*bbox*/) { return 0; }
virtual unsigned stroke(Inkscape::Extension::Print * /*module*/,
Geom::PathVector const & /*pathv*/,
Geom::Affine const & /*transform*/,
SPStyle const * /*style*/,
Geom::OptRect const & /*pbox*/,
Geom::OptRect const & /*dbox*/,
Geom::OptRect const & /*bbox*/) { return 0; }
virtual unsigned image(Inkscape::Extension::Print * /*module*/,
unsigned char * /*px*/,
unsigned int /*w*/,
unsigned int /*h*/,
unsigned int /*rs*/,
Geom::Affine const & /*transform*/,
SPStyle const * /*style*/) { return 0; }
virtual unsigned text(Inkscape::Extension::Print * /*module*/,
char const * /*text*/,
Geom::Point const & /*p*/,
SPStyle const * /*style*/) { return 0; }
virtual void processPath(Inkscape::XML::Node * /*node*/) {}
/**
* If detach = true, when saving to a file, don't store URIs relative to the filename
*/
virtual void setDetachBase(bool detach) {}
};
} // namespace Implementation
} // namespace Extension
} // namespace Inkscape
#endif // __INKSCAPE_EXTENSION_IMPLEMENTATION_H__
/*
Local Variables:
mode:c++
c-file-style:"stroustrup"
c-file-offsets:((innamespace . 0)(inline-open . 0)(case-label . +))
indent-tabs-mode:nil
fill-column:99
End:
*/
// vim: filetype=cpp:expandtab:shiftwidth=4:tabstop=8:softtabstop=4 :
|
