Code

now that selection description includes style (filtered, clipped), we need to update...
[inkscape.git] / src / snapper.h
index 2f3c487d6b9bd672f4c987d154f07d6a201408f3..49f2774113d8062ee5afe6942e3f38d6fc8b2847 100644 (file)
@@ -7,6 +7,7 @@
  *
  *    Authors:
  *      Carl Hetherington <inkscape@carlh.net>
+ *      Diederik van Lierop <mail@diedenrezi.nl>
  *
  *    Released under GNU GPL, read the file 'COPYING' for more information.
  */
 #include <list>
 #include "libnr/nr-coord.h"
 #include "libnr/nr-point.h"
+#include <boost/optional.hpp>
+
 #include "snapped-point.h"
+#include "snapped-line.h"
+#include "snapped-curve.h"
+#include "snap-preferences.h"
+
+struct SnappedConstraints {
+    std::list<Inkscape::SnappedPoint> points;
+    std::list<Inkscape::SnappedLineSegment> lines;
+    std::list<Inkscape::SnappedLine> grid_lines;
+    std::list<Inkscape::SnappedLine> guide_lines;
+    std::list<Inkscape::SnappedCurve> curves;
+};
 
-struct SPNamedView;
+class SnapManager;
 struct SPItem;
 
 namespace Inkscape
@@ -27,75 +41,72 @@ namespace Inkscape
 class Snapper
 {
 public:
-    Snapper() {}
-    Snapper(SPNamedView const *nv, ::NR::Coord const d);
-    virtual ~Snapper() {}
-
-    /// Point types to snap.
-    typedef int PointType;
-    static const PointType SNAP_POINT;
-    static const PointType BBOX_POINT;
-
-    typedef std::pair<PointType, NR::Point> PointWithType;
-
-    void setSnapTo(PointType t, bool s);
-    void setDistance(::NR::Coord d);
-
-    bool getSnapTo(PointType t) const;
-    ::NR::Coord getDistance() const;
+       Snapper() {}
+       Snapper(SnapManager *sm, ::Geom::Coord const t);
+       virtual ~Snapper() {}
 
-    bool willSnapSomething() const;
+    virtual Geom::Coord getSnapperTolerance() const = 0; //returns the tolerance of the snapper in screen pixels (i.e. independent of zoom)
+    virtual bool getSnapperAlwaysSnap() const = 0; //if true, then the snapper will always snap, regardless of its tolerance
 
-    SnappedPoint freeSnap(PointType t,
-                          NR::Point const &p,
-                          SPItem const *it) const;
-
-    SnappedPoint freeSnap(PointType t,
-                          NR::Point const &p,
-                          std::list<SPItem const *> const &it) const;
-
-    SnappedPoint constrainedSnap(PointType t,
-                                 NR::Point const &p,
-                                 NR::Point const &c,
-                                 SPItem const *it) const;
+    /**
+    *  \return true if this Snapper will snap at least one kind of point.
+    */
+    virtual bool ThisSnapperMightSnap() const {return _snap_enabled;} // will likely be overridden by derived classes
+
+    void setEnabled(bool s); // This is only used for grids, for which snapping can be enabled individually
+    bool getEnabled() const {return _snap_enabled;}
+
+    virtual void freeSnap(SnappedConstraints &/*sc*/,
+                          SnapPreferences::PointType const &/*t*/,
+                          Geom::Point const &/*p*/,
+                          bool const &/*first_point*/,
+                          Geom::OptRect const &/*bbox_to_snap*/,
+                          std::vector<SPItem const *> const */*it*/,
+                          std::vector<Geom::Point> */*unselected_nodes*/) const {};
+
+    class ConstraintLine
+    {
+    public:
+        ConstraintLine(Geom::Point const &d) : _has_point(false), _direction(d) {}
+        ConstraintLine(Geom::Point const &p, Geom::Point const &d) : _has_point(true), _point(p), _direction(d) {}
+
+        bool hasPoint() const {
+            return _has_point;
+        }
+
+        Geom::Point getPoint() const {
+            return _point;
+        }
+
+        Geom::Point getDirection() const {
+            return _direction;
+        }
+
+        void setPoint(Geom::Point const &p) {
+            _point = p;
+            _has_point = true;
+        }
+
+    private:
+
+        bool _has_point;
+        Geom::Point _point;
+        Geom::Point _direction;
+    };
+
+    virtual void constrainedSnap(SnappedConstraints &/*sc*/,
+                                                        SnapPreferences::PointType const &/*t*/,
+                                 Geom::Point const &/*p*/,
+                                 bool const &/*first_point*/,
+                                 Geom::OptRect const &/*bbox_to_snap*/,
+                                 ConstraintLine const &/*c*/,
+                                 std::vector<SPItem const *> const */*it*/) const {};
 
-    SnappedPoint constrainedSnap(PointType t,
-                                 NR::Point const &p,
-                                 NR::Point const &c,
-                                 std::list<SPItem const *> const &it) const;
 protected:
-    SPNamedView const *_named_view;
-    
-private:
+       SnapManager *_snapmanager;
 
-    /**
-     *  Try to snap a point to whatever this snapper is interested in.  Any
-     *  snap that occurs will be to the nearest "interesting" thing (e.g. a
-     *  grid or guide line)
-     *
-     *  \param p Point to snap (desktop coordinates).
-     *  \param it Items that should not be snapped to.
-     *  \return Snapped point.
-     */
-    virtual SnappedPoint _doFreeSnap(NR::Point const &p,
-                                     std::list<SPItem const *> const &it) const = 0;
-
-    /**
-     *  Try to snap a point to whatever this snapper is interested in, where
-     *  the snap point is constrained to lie along a specified vector from the
-     *  original point.
-     *
-     *  \param p Point to snap (desktop coordinates).
-     *  \param c Vector to constrain the snap to.
-     *  \param it Items that should not be snapped to.
-     *  \return Snapped point.
-     */    
-    virtual SnappedPoint _doConstrainedSnap(NR::Point const &p,
-                                            NR::Point const &c,
-                                            std::list<SPItem const *> const &it) const = 0;
-    
-    ::NR::Coord _distance; ///< snap distance (desktop coordinates)
-    int _snap_to; ///< bitmap of point types that we will snap to 
+       bool _snap_enabled; ///< true if this snapper is enabled, otherwise false
+                                               // This is only used for grids, for which snapping can be enabled individually
 };
 
 }