object-snapper.h revision 2b7ee786ac3f40bb6b0d6e19f565b802f29f50e0
1192N/A#ifndef SEEN_OBJECT_SNAPPER_H
1434N/A#define SEEN_OBJECT_SNAPPER_H
492N/A
492N/A/**
919N/A * \file object-snapper.h
919N/A * \brief Snapping things to objects.
919N/A *
919N/A * Authors:
919N/A * Carl Hetherington <inkscape@carlh.net>
919N/A * Diederik van Lierop <mail@diedenrezi.nl>
919N/A *
919N/A * Copyright (C) 2005 - 2008 Authors
919N/A *
919N/A * Released under GNU GPL, read the file 'COPYING' for more information
919N/A */
919N/A
919N/A#include "snapper.h"
919N/A#include "sp-path.h"
919N/A#include "splivarot.h"
919N/A
919N/Astruct SPNamedView;
492N/Astruct SPItem;
492N/Astruct SPObject;
908N/A
908N/Anamespace Inkscape
492N/A{
492N/A
1466N/Aclass SnapCandidate
1466N/A
1434N/A{
1434N/Apublic:
492N/A SnapCandidate(SPItem* item, bool clip_or_mask, Geom::Matrix _additional_affine);
908N/A ~SnapCandidate();
908N/A
908N/A SPItem* item; // An item that is to be considered for snapping to
1434N/A bool clip_or_mask; // If true, then item refers to a clipping path or a mask
492N/A
492N/A /* To find out the absolute position of a clipping path or mask, we not only need to know
492N/A * the transformation of the clipping path or mask itself, but also the transformation of
492N/A * the object to which the clip or mask is being applied; that transformation is stored here
492N/A */
492N/A Geom::Matrix additional_affine;
492N/A};
492N/A
908N/Aclass ObjectSnapper : public Snapper
908N/A{
492N/A
908N/Apublic:
908N/A ObjectSnapper(SnapManager *sm, Geom::Coord const d);
492N/A ~ObjectSnapper();
492N/A
492N/A enum DimensionToSnap {
492N/A GUIDE_TRANSL_SNAP_X, // For snapping a vertical guide (normal in the X-direction) to objects,
492N/A GUIDE_TRANSL_SNAP_Y, // For snapping a horizontal guide (normal in the Y-direction) to objects
492N/A ANGLED_GUIDE_TRANSL_SNAP, // For snapping an angled guide, while translating it accross the desktop
492N/A ANGLED_GUIDE_ROT_SNAP, // For snapping an angled guide, while rotating it around some pivot point
492N/A TRANSL_SNAP_XY}; // All other cases; for snapping to objects, other than guides
492N/A
492N/A void setSnapToItemNode(bool s) {_snap_to_itemnode = s;}
492N/A bool getSnapToItemNode() const {return _snap_to_itemnode;}
492N/A void setSnapToItemPath(bool s) {_snap_to_itempath = s;}
492N/A bool getSnapToItemPath() const {return _snap_to_itempath;}
492N/A void setSnapToBBoxNode(bool s) {_snap_to_bboxnode = s;}
bool getSnapToBBoxNode() const {return _snap_to_bboxnode;}
void setSnapToBBoxPath(bool s) {_snap_to_bboxpath = s;}
bool getSnapToBBoxPath() const {return _snap_to_bboxpath;}
void setSnapToPageBorder(bool s) {_snap_to_page_border = s;}
bool getSnapToPageBorder() const {return _snap_to_page_border;}
void guideSnap(SnappedConstraints &sc,
Geom::Point const &p,
Geom::Point const &guide_normal) const;
bool ThisSnapperMightSnap() const;
bool GuidesMightSnap() const;
void freeSnap(SnappedConstraints &sc,
Inkscape::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;
void constrainedSnap(SnappedConstraints &sc,
Inkscape::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;
private:
//store some lists of candidates, points and paths, so we don't have to rebuild them for each point we want to snap
std::vector<SnapCandidate> *_candidates;
std::vector<Geom::Point> *_points_to_snap_to;
std::vector<Geom::PathVector*> *_paths_to_snap_to;
void _findCandidates(SPObject* parent,
std::vector<SPItem const *> const *it,
bool const &first_point,
Geom::Rect const &bbox_to_snap,
DimensionToSnap snap_dim,
bool const _clip_or_mask,
Geom::Matrix const additional_affine) const;
void _snapNodes(SnappedConstraints &sc,
Inkscape::SnapPreferences::PointType const &t,
Geom::Point const &p, // in desktop coordinates
bool const &first_point,
std::vector<Geom::Point> *unselected_nodes) const; // in desktop coordinates
void _snapTranslatingGuideToNodes(SnappedConstraints &sc,
Inkscape::SnapPreferences::PointType const &t,
Geom::Point const &p,
Geom::Point const &guide_normal) const;
void _collectNodes(Inkscape::SnapPreferences::PointType const &t,
bool const &first_point) const;
void _snapPaths(SnappedConstraints &sc,
Inkscape::SnapPreferences::PointType const &t,
Geom::Point const &p, // in desktop coordinates
bool const &first_point,
std::vector<Geom::Point> *unselected_nodes, // in desktop coordinates
SPPath const *selected_path) const;
void _snapPathsConstrained(SnappedConstraints &sc,
Inkscape::SnapPreferences::PointType const &t,
Geom::Point const &p, // in desktop coordinates
bool const &first_point,
ConstraintLine const &c) const;
bool isUnselectedNode(Geom::Point const &point, std::vector<Geom::Point> const *unselected_nodes) const;
void _collectPaths(Inkscape::SnapPreferences::PointType const &t,
bool const &first_point) const;
void _clear_paths() const;
Geom::PathVector* _getBorderPathv() const;
Geom::PathVector* _getPathvFromRect(Geom::Rect const rect) const;
void _getBorderNodes(std::vector<Geom::Point> *points) const;
bool _snap_to_itemnode;
bool _snap_to_itempath;
bool _snap_to_bboxnode;
bool _snap_to_bboxpath;
bool _snap_to_page_border;
//If enabled, then bbox corners will only snap to bboxes,
//and nodes will only snap to nodes and paths. We will not
//snap bbox corners to nodes, or nodes to bboxes.
//(snapping to grids and guides is not affected by this)
bool _strict_snapping;
};
}
#endif