diff --git a/src/snap.h b/src/snap.h
index 12996f04d0e54e1f3a9243086e4036d0657e88c1..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-dim2.h>
#include <libnr/nr-forward.h>
#include <libnr/nr-scale.h>
-#include "grid-snapper.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 const *v);
-
- bool willSnapSomething() const;
+
+ 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,
Inkscape::Snapper::ConstraintLine const &c,
NR::Point const &o,
NR::Dim2 d) const;
- Inkscape::GridSnapper grid;
- Inkscape::GuideSnapper guide;
- Inkscape::ObjectSnapper object;
+ 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;
+
+protected:
+ SPNamedView const *_named_view;
private: