src/live_effects/effect.h

   1 #ifndef INKSCAPE_LIVEPATHEFFECT_H
   2 #define INKSCAPE_LIVEPATHEFFECT_H
   3
   4 /*
   5  * Inkscape::LivePathEffect
   6  *
   7 * Copyright (C) Johan Engelen 2007-2008 <j.b.c.engelen@utwente.nl>
   8  *
   9  * Released under GNU GPL, read the file 'COPYING' for more information
  10  */
  11
  12
  13 #include "display/display-forward.h"
  14 #include <map>
  15 #include <glibmm/ustring.h>
  16 #include <2geom/path.h>
  17 #include "ui/widget/registry.h"
  18 #include "util/enums.h"
  19 #include "sp-lpe-item.h"
  20 #include "knotholder.h"
  21 #include "parameter/bool.h"
  22
  23 #define  LPE_CONVERSION_TOLERANCE 0.01    // FIXME: find good solution for this.
  24
  25 #define LPE_ENABLE_TEST_EFFECTS
  26
  27 struct SPDocument;
  28 struct SPDesktop;
  29 struct SPItem;
  30 class NArtBpath;
  31 struct LivePathEffectObject;
  32
  33 namespace Gtk {
  34     class Widget;
  35     class VBox;
  36     class Tooltips;
  37 }
  38
  39 namespace Geom {
  40     class Matrix;
  41 }
  42
  43 namespace Inkscape {
  44
  45 namespace XML {
  46     class Node;
  47 }
  48
  49 namespace NodePath {
  50     class Path ;
  51 }
  52
  53 namespace LivePathEffect {
  54
  55 enum EffectType {
  56     BEND_PATH = 0,
  57     PATTERN_ALONG_PATH,
  58     SKETCH,
  59     VONKOCH,
  60     KNOT,
  61 #ifdef LPE_ENABLE_TEST_EFFECTS
  62     DOEFFECTSTACK_TEST,
  63 #endif
  64     GEARS,
  65     CURVE_STITCH,
  66     CIRCLE_WITH_RADIUS,
  67     PERSPECTIVE_PATH,
  68     SPIRO,
  69     LATTICE,
  70     ENVELOPE,
  71     CONSTRUCT_GRID,
  72     PERP_BISECTOR,
  73     TANGENT_TO_CURVE,
  74     MIRROR_REFLECT,
  75     INVALID_LPE // This must be last
  76 };
  77
  78 extern const Util::EnumData<EffectType> LPETypeData[INVALID_LPE];
  79 extern const Util::EnumDataConverter<EffectType> LPETypeConverter;
  80
  81 enum LPEPathFlashType {
  82     SUPPRESS_FLASH,
  83     PERMANENT_FLASH,
  84     DEFAULT
  85 };
  86
  87 class Effect {
  88 public:
  89     static Effect* New(EffectType lpenr, LivePathEffectObject *lpeobj);
  90     static void createAndApply(const char* name, SPDocument *doc, SPItem *item);
  91     static void createAndApply(EffectType type, SPDocument *doc, SPItem *item);
  92
  93     virtual ~Effect();
  94
  95     EffectType effectType ();
  96
  97     virtual void doOnApply (SPLPEItem *lpeitem);
  98
  99     virtual void doBeforeEffect (SPLPEItem *lpeitem);
 100     void writeParamsToSVG();
 101
 102     virtual void doEffect (SPCurve * curve);
 103
 104     virtual Gtk::Widget * newWidget(Gtk::Tooltips * tooltips);
 105
 106     virtual void resetDefaults(SPItem * item);
 107
 108     virtual void setup_nodepath(Inkscape::NodePath::Path *np);
 109
 110     virtual void transform_multiply(Geom::Matrix const& postmul, bool set);
 111
 112     bool providesKnotholder() { return (kh_entity_vector.size() > 0); }
 113     virtual LPEPathFlashType pathFlashType() { return DEFAULT; }
 114     void addHandles(KnotHolder *knotholder, SPDesktop *desktop, SPItem *item);
 115
 116     Glib::ustring          getName();
 117     Inkscape::XML::Node *  getRepr();
 118     SPDocument *           getSPDoc();
 119     LivePathEffectObject * getLPEObj() {return lpeobj;};
 120     Parameter *            getParameter(const char * key);
 121
 122     void readallParameters(Inkscape::XML::Node * repr);
 123     void setParameter(const gchar * key, const gchar * new_value);
 124
 125     inline bool isVisible() { return is_visible; }
 126
 127     void editNextParamOncanvas(SPItem * item, SPDesktop * desktop);
 128
 129 protected:
 130     Effect(LivePathEffectObject *lpeobject);
 131
 132     // provide a set of doEffect functions so the developer has a choice
 133     // of what kind of input/output parameters he desires.
 134     // the order in which they appear is the order in which they are
 135     // called by this base class. (i.e. doEffect(SPCurve * curve) defaults to calling
 136     // doEffect(std::vector<Geom::Path> )
 137     virtual std::vector<Geom::Path>
 138             doEffect_path (std::vector<Geom::Path> const & path_in);
 139     virtual Geom::Piecewise<Geom::D2<Geom::SBasis> >
 140             doEffect_pwd2 (Geom::Piecewise<Geom::D2<Geom::SBasis> > const & pwd2_in);
 141
 142     void registerParameter(Parameter * param);
 143     void registerKnotHolderHandle(KnotHolderEntity* entity, const char* descr);
 144     void addPointParamHandles(KnotHolder *knotholder, SPDesktop *desktop, SPItem *item);
 145     Parameter * getNextOncanvasEditableParam();
 146
 147     std::vector<Parameter *> param_vector;
 148     std::vector<std::pair<KnotHolderEntity*, const char*> > kh_entity_vector;
 149     int oncanvasedit_it;
 150     BoolParam is_visible;
 151
 152     Inkscape::UI::Widget::Registry wr;
 153
 154     LivePathEffectObject *lpeobj;
 155
 156     // this boolean defaults to false, it concatenates the input path to one pwd2,
 157     // instead of normally 'splitting' the path into continuous pwd2 paths.
 158     bool concatenate_before_pwd2;
 159
 160 private:
 161     Effect(const Effect&);
 162     Effect& operator=(const Effect&);
 163 };
 164
 165
 166 } //namespace LivePathEffect
 167 } //namespace Inkscape
 168
 169 #endif
 170
 171 /*
 172   Local Variables:
 173   mode:c++
 174   c-file-style:"stroustrup"
 175   c-file-offsets:((innamespace . 0)(inline-open . 0)(case-label . +))
 176   indent-tabs-mode:nil
 177   fill-column:99
 178   End:
 179 */
 180 // vim: filetype=cpp:expandtab:shiftwidth=4:tabstop=8:softtabstop=4 :