diff --git a/src/snap.h b/src/snap.h
index c77e8df41aeb5441af1ef84da91feb0d48fc20ef..e0217948fe3cfdb4b0f7a96b2841096512dd49c1 100644 (file)
--- a/src/snap.h
+++ b/src/snap.h
/**
* \file snap.h
- * \brief Various snapping methods.
+ * \brief SnapManager class.
*
* Authors:
* Lauris Kaplinski <lauris@kaplinski.com>
* Frank Felfe <innerspace@iname.com>
* Carl Hetherington <inkscape@carlh.net>
*
+ * Copyright (C) 2006-2007 Johan Engelen <johan@shouraizou.nl>
* Copyright (C) 2000-2002 Lauris Kaplinski
*
* Released under GNU GPL, read the file 'COPYING' for more information
#include <libnr/nr-coord.h>
#include <libnr/nr-dim2.h>
#include <libnr/nr-forward.h>
-#include "grid-snapper.h"
+#include <libnr/nr-scale.h>
#include "guide-snapper.h"
#include "object-snapper.h"
class SPNamedView;
+/// Class to coordinate snapping operations
+
+/**
+ * Each SPNamedView has one of these. It offers methods to snap points to whatever
+ * snappers are defined (e.g. grid, guides etc.). It also allows callers to snap
+ * points which have undergone some transformation (e.g. translation, scaling etc.)
+ */
+
class SnapManager
{
public:
- SnapManager(SPNamedView* v);
-
- bool willSnapSomething() const;
+ SnapManager(SPNamedView const *v);
+
+ typedef std::list<const Inkscape::Snapper*> SnapperList;
+
+ bool SomeSnapperMightSnap() const;
Inkscape::SnappedPoint freeSnap(Inkscape::Snapper::PointType t,
NR::Point const &p,
Inkscape::SnappedPoint freeSnap(Inkscape::Snapper::PointType t,
NR::Point const &p,
std::list<SPItem const *> const &it) const;
-
+
+ Inkscape::SnappedPoint freeSnap( Inkscape::Snapper::PointType t,
+ NR::Point const &p,
+ std::list<SPItem const *> const &it,
+ SnapperList const &snappers ) const;
+
+ Inkscape::SnappedPoint freeSnapAlways( Inkscape::Snapper::PointType t,
+ NR::Point const &p,
+ SPItem const *it,
+ SnapperList &snappers );
+
+ Inkscape::SnappedPoint freeSnapAlways( Inkscape::Snapper::PointType t,
+ NR::Point const &p,
+ std::list<SPItem const *> const &it,
+ SnapperList &snappers );
+
Inkscape::SnappedPoint constrainedSnap(Inkscape::Snapper::PointType t,
NR::Point const &p,
- NR::Point const &c,
+ Inkscape::Snapper::ConstraintLine const &c,
SPItem const *it) const;
Inkscape::SnappedPoint constrainedSnap(Inkscape::Snapper::PointType t,
NR::Point const &p,
- NR::Point const &c,
+ Inkscape::Snapper::ConstraintLine const &c,
std::list<SPItem const *> const &it) const;
std::pair<NR::Point, bool> freeSnapTranslation(Inkscape::Snapper::PointType t,
std::pair<NR::Point, bool> constrainedSnapTranslation(Inkscape::Snapper::PointType t,
std::vector<NR::Point> const &p,
- NR::Point const &c,
std::list<SPItem const *> const &it,
+ Inkscape::Snapper::ConstraintLine const &c,
NR::Point const &tr) const;
- Inkscape::GridSnapper grid;
- Inkscape::GuideSnapper guide;
- Inkscape::ObjectSnapper object;
+ std::pair<NR::scale, bool> freeSnapScale(Inkscape::Snapper::PointType t,
+ std::vector<NR::Point> const &p,
+ std::list<SPItem const *> const &it,
+ NR::scale const &s,
+ NR::Point const &o) const;
+
+ std::pair<NR::scale, bool> constrainedSnapScale(Inkscape::Snapper::PointType t,
+ std::vector<NR::Point> const &p,
+ std::list<SPItem const *> const &it,
+ Inkscape::Snapper::ConstraintLine const &c,
+ NR::scale const &s,
+ NR::Point const &o) const;
+
+ std::pair<NR::Coord, bool> freeSnapStretch(Inkscape::Snapper::PointType t,
+ std::vector<NR::Point> const &p,
+ std::list<SPItem const *> const &it,
+ NR::Coord const &s,
+ NR::Point const &o,
+ NR::Dim2 d,
+ bool uniform) const;
+
+ std::pair<NR::Coord, bool> freeSnapSkew(Inkscape::Snapper::PointType t,
+ std::vector<NR::Point> const &p,
+ std::list<SPItem const *> const &it,
+ NR::Coord const &s,
+ NR::Point const &o,
+ NR::Dim2 d) const;
+
+ Inkscape::GuideSnapper guide; ///< guide snapper
+ Inkscape::ObjectSnapper object; ///< snapper to other objects
- typedef std::list<const Inkscape::Snapper*> SnapperList;
SnapperList getSnappers() const;
-};
-
+ SnapperList getGridSnappers() const;
-/* Single point methods */
-NR::Coord namedview_vector_snap(SPNamedView const *nv, Inkscape::Snapper::PointType t, NR::Point &req,
- NR::Point const &d, std::list<SPItem const *> const &it);
-NR::Coord namedview_vector_snap(SPNamedView const *nv, Inkscape::Snapper::PointType t, NR::Point &req,
- NR::Point const &d, SPItem const *it);
-NR::Coord namedview_dim_snap(SPNamedView const *nv, Inkscape::Snapper::PointType t, NR::Point& req,
- NR::Dim2 const dim, SPItem const *it);
-NR::Coord namedview_dim_snap(SPNamedView const *nv, Inkscape::Snapper::PointType t, NR::Point& req,
- NR::Dim2 const dim, std::list<SPItem const *> const &it);
+protected:
+ SPNamedView const *_named_view;
-/* List of points methods */
-
-std::pair<double, bool> namedview_vector_snap_list(SPNamedView const *nv,
- Inkscape::Snapper::PointType t, const std::vector<NR::Point> &p,
- NR::Point const &norm, NR::scale const &s,
- std::list<SPItem const *> const &it
- );
-
-std::pair<double, bool> namedview_dim_snap_list_scale(SPNamedView const *nv,
- Inkscape::Snapper::PointType t, const std::vector<NR::Point> &p,
- NR::Point const &norm, double const sx,
- NR::Dim2 const dim,
- std::list<SPItem const *> const &it);
-
-NR::Coord namedview_dim_snap_list_skew(SPNamedView const *nv, Inkscape::Snapper::PointType t,
- const std::vector<NR::Point> &p,
- NR::Point const &norm, double const sx, NR::Dim2 const dim);
+private:
+ enum Transformation {
+ TRANSLATION,
+ SCALE,
+ STRETCH,
+ SKEW
+ };
+
+ std::pair<NR::Point, bool> _snapTransformed(Inkscape::Snapper::PointType type,
+ std::vector<NR::Point> const &points,
+ std::list<SPItem const *> const &ignore,
+ bool constrained,
+ Inkscape::Snapper::ConstraintLine const &constraint,
+ Transformation transformation_type,
+ NR::Point const &transformation,
+ NR::Point const &origin,
+ NR::Dim2 dim,
+ bool uniform) const;
+};
#endif /* !SEEN_SNAP_H */