Code

Split SPCanvasItem and SPCanvasGroup to individual .h files. Removed forward header.
[inkscape.git] / src / live_effects / effect.h
index 714bcdcab0e7b3224f7bb5792df2303ab0cf4df1..6acba000ce5f9376dc7802190dfcaf37f68a1959 100644 (file)
-#ifndef INKSCAPE_LIVEPATHEFFECT_H\r
-#define INKSCAPE_LIVEPATHEFFECT_H\r
-\r
-/*\r
- * Inkscape::LivePathEffect\r
- *\r
-* Copyright (C) Johan Engelen 2007 <j.b.c.engelen@utwente.nl>\r
- *\r
- * Released under GNU GPL, read the file 'COPYING' for more information\r
- */\r
-\r
-\r
-#include "display/display-forward.h"\r
-#include <map>\r
-#include <glibmm/ustring.h>\r
-#include <2geom/path.h>\r
-#include "ui/widget/registry.h"\r
-#include "util/enums.h"\r
-\r
-#define  LPE_CONVERSION_TOLERANCE 0.01    // FIXME: find good solution for this.\r
-\r
-struct SPShape;\r
-struct SPDocument;\r
-class NArtBpath;\r
-struct LivePathEffectObject;\r
-\r
-namespace Gtk {\r
-    class Widget;\r
-    class VBox;\r
-    class Tooltips;\r
-}\r
-\r
-namespace Inkscape {\r
-\r
-namespace XML {\r
-    class Node;\r
-};\r
-\r
-namespace LivePathEffect {\r
-\r
-enum EffectType {\r
-    SKELETAL_STROKES = 0,\r
-    SLANT,\r
-    DOEFFECTSTACK_TEST,\r
-    GEARS,\r
-    INVALID_LPE // This must be last\r
-};\r
-\r
-extern const Util::EnumData<EffectType> LPETypeData[INVALID_LPE];\r
-extern const Util::EnumDataConverter<EffectType> LPETypeConverter;\r
-\r
-class Parameter;\r
-\r
-class Effect {\r
-public:\r
-    virtual ~Effect();\r
-\r
-    Glib::ustring getName();\r
-\r
-    virtual void doEffect (SPCurve * curve);\r
-\r
-    static Effect* New(EffectType lpenr, LivePathEffectObject *lpeobj);\r
-\r
-    virtual Gtk::Widget * getWidget();\r
-\r
-    Inkscape::XML::Node * getRepr();\r
-    SPDocument * getSPDoc();\r
-\r
-    void readallParameters(Inkscape::XML::Node * repr);\r
-    void setParameter(Inkscape::XML::Node * repr, const gchar * key, const gchar * old_value, const gchar * new_value);\r
-\r
-protected:\r
-    Effect(LivePathEffectObject *lpeobject);\r
-\r
-    // provide a set of doEffect functions so the developer has a choice \r
-    // of what kind of input/output parameters he desires.\r
-    // the order in which they appear is the order in which they are \r
-    // called by this base class. (i.e. doEffect(SPCurve * curve) defaults to calling\r
-    // doEffect(std::vector<Geom::Path> )\r
-    virtual NArtBpath *\r
-            doEffect (NArtBpath * path_in);\r
-    virtual std::vector<Geom::Path> \r
-            doEffect (std::vector<Geom::Path> & path_in);\r
-    virtual Geom::Piecewise<Geom::D2<Geom::SBasis> > \r
-            doEffect (Geom::Piecewise<Geom::D2<Geom::SBasis> > & pwd2_in);\r
-\r
-    void registerParameter(Parameter * param);\r
-\r
-    typedef std::map<Glib::ustring, Parameter *> param_map_type;\r
-    param_map_type param_map;\r
-\r
-    Inkscape::UI::Widget::Registry wr; \r
-    Gtk::VBox * vbox;\r
-    Gtk::Tooltips * tooltips;\r
-\r
-    LivePathEffectObject *lpeobj;\r
-\r
-private:\r
-    Effect(const Effect&);\r
-    Effect& operator=(const Effect&);\r
-};\r
-\r
-\r
-} //namespace LivePathEffect\r
-} //namespace Inkscape\r
-\r
-#endif\r
+#ifndef INKSCAPE_LIVEPATHEFFECT_H
+#define INKSCAPE_LIVEPATHEFFECT_H
+
+/*
+ * Inkscape::LivePathEffect
+ *
+* Copyright (C) Johan Engelen 2007-2008 <j.b.c.engelen@utwente.nl>
+ *
+ * Released under GNU GPL, read the file 'COPYING' for more information
+ */
+
+
+#include <map>
+#include <glibmm/ustring.h>
+#include <2geom/forward.h>
+#include "ui/widget/registry.h"
+#include "parameter/bool.h"
+#include "effect-enum.h"
+
+#define  LPE_CONVERSION_TOLERANCE 0.01    // FIXME: find good solution for this.
+
+struct SPDocument;
+struct SPDesktop;
+struct SPItem;
+class SPNodeContext;
+struct LivePathEffectObject;
+class SPLPEItem;
+class KnotHolder;
+class KnotHolderEntity;
+class SPPath;
+struct SPCurve;
+
+namespace Gtk {
+    class Widget;
+    class VBox;
+    class Tooltips;
+}
+
+namespace Inkscape {
+
+namespace XML {
+    class Node;
+}
+
+namespace NodePath {
+    class Path ;
+}
+
+namespace LivePathEffect {
+
+enum LPEPathFlashType {
+    SUPPRESS_FLASH,
+//    PERMANENT_FLASH,
+    DEFAULT
+};
+
+class Effect {
+public:
+    static Effect* New(EffectType lpenr, LivePathEffectObject *lpeobj);
+    static void createAndApply(const char* name, SPDocument *doc, SPItem *item);
+    static void createAndApply(EffectType type, SPDocument *doc, SPItem *item);
+
+    virtual ~Effect();
+
+    EffectType effectType ();
+
+    virtual void doOnApply (SPLPEItem *lpeitem);
+    virtual void doBeforeEffect (SPLPEItem *lpeitem);
+
+    void writeParamsToSVG();
+
+    virtual void acceptParamPath (SPPath *param_path);
+    static int acceptsNumClicks(EffectType type);
+    int acceptsNumClicks() { return acceptsNumClicks(effectType()); }
+    void doAcceptPathPreparations(SPLPEItem *lpeitem);
+
+    /*
+     * isReady() indicates whether all preparations which are necessary to apply the LPE are done,
+     * e.g., waiting for a parameter path either before the effect is created or when it needs a
+     * path as argument. This is set in sp_lpe_item_add_path_effect().
+     */
+    inline bool isReady() { return is_ready; }
+    inline void setReady(bool ready = true) { is_ready = ready; }
+
+    virtual void doEffect (SPCurve * curve);
+
+    virtual Gtk::Widget * newWidget(Gtk::Tooltips * tooltips);
+
+    /**
+     * Sets all parameters to their default values and writes them to SVG.
+     */
+    virtual void resetDefaults(SPItem * item);
+
+    /// /todo: is this method really necessary? it causes UI inconsistensies... (johan)
+    virtual void transform_multiply(Geom::Matrix const& postmul, bool set);
+
+    // /TODO: providesKnotholder() is currently used as an indicator of whether a nodepath is
+    // created for an item or not. When we allow both at the same time, this needs rethinking!
+    bool providesKnotholder();
+    // /TODO: in view of providesOwnFlashPaths() below, this is somewhat redundant
+    //       (but spiro lpe still needs it!)
+    virtual LPEPathFlashType pathFlashType() { return DEFAULT; }
+    void addHandles(KnotHolder *knotholder, SPDesktop *desktop, SPItem *item);
+    std::vector<Geom::PathVector> getHelperPaths(SPLPEItem *lpeitem);
+
+    inline bool providesOwnFlashPaths() {
+        return provides_own_flash_paths || show_orig_path;
+    }
+    inline bool showOrigPath() { return show_orig_path; }
+
+    Glib::ustring          getName();
+    Inkscape::XML::Node *  getRepr();
+    SPDocument *           getSPDoc();
+    LivePathEffectObject * getLPEObj() {return lpeobj;};
+    Parameter *            getParameter(const char * key);
+
+    void readallParameters(Inkscape::XML::Node * repr);
+    void setParameter(const gchar * key, const gchar * new_value);
+
+    inline bool isVisible() { return is_visible; }
+
+    void editNextParamOncanvas(SPItem * item, SPDesktop * desktop);
+
+protected:
+    Effect(LivePathEffectObject *lpeobject);
+
+    // provide a set of doEffect functions so the developer has a choice
+    // of what kind of input/output parameters he desires.
+    // the order in which they appear is the order in which they are
+    // called by this base class. (i.e. doEffect(SPCurve * curve) defaults to calling
+    // doEffect(std::vector<Geom::Path> )
+    virtual std::vector<Geom::Path>
+            doEffect_path (std::vector<Geom::Path> const & path_in);
+    virtual Geom::Piecewise<Geom::D2<Geom::SBasis> >
+            doEffect_pwd2 (Geom::Piecewise<Geom::D2<Geom::SBasis> > const & pwd2_in);
+
+    void registerParameter(Parameter * param);
+    void registerKnotHolderHandle(KnotHolderEntity* entity, const char* descr);
+    Parameter * getNextOncanvasEditableParam();
+
+    void addKnotHolderEntities(KnotHolder *knotholder, SPDesktop *desktop, SPItem *item);
+
+    //virtual std::vector<Geom::PathVector> getCanvasIndicators(SPLPEItem *lpeitem);
+    virtual void addCanvasIndicators(SPLPEItem *lpeitem, std::vector<Geom::PathVector> &hp_vec);
+
+
+    std::vector<Parameter *> param_vector;
+    std::vector<std::pair<KnotHolderEntity*, const char*> > kh_entity_vector;
+    int oncanvasedit_it;
+    BoolParam is_visible;
+
+    bool show_orig_path; // set this to true in derived effects to automatically have the original
+                         // path displayed as helperpath
+
+    Inkscape::UI::Widget::Registry wr;
+
+    LivePathEffectObject *lpeobj;
+
+    // this boolean defaults to false, it concatenates the input path to one pwd2,
+    // instead of normally 'splitting' the path into continuous pwd2 paths.
+    bool concatenate_before_pwd2;
+
+private:
+    bool provides_own_flash_paths; // if true, the standard flash path is suppressed
+
+    bool is_ready;
+
+    Effect(const Effect&);
+    Effect& operator=(const Effect&);
+};
+
+} //namespace LivePathEffect
+} //namespace Inkscape
+
+#endif
+
+/*
+  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 :