]> Shamusworld >> Repos - architektonas/blob - src/base/rs_snapper.h
Initial import
[architektonas] / src / base / rs_snapper.h
1 #ifndef RS_SNAPPER_H
2 #define RS_SNAPPER_H
3
4 #include <QtCore>
5
6 #include "rs.h"
7 #include "rs_entitycontainer.h"
8 #include "rs_coordinateevent.h"
9
10 class RS_Entity;
11 class RS_GraphicView;
12 class Vector;
13
14 /**
15  * This class is used for snapping functions in a graphic view.
16  * Actions are usually derrived from this base class if they need
17  * to catch entities or snap to coordinates. Use the methods to
18  * retrieve a graphic coordinate from a mouse coordinate.
19  *
20  * Possible snapping functions are described in RS_SnapMode.
21  *
22  * @author Andrew Mustun
23  */
24 class RS_Snapper
25 {
26         public:
27                 RS_Snapper(RS_EntityContainer & container, RS_GraphicView & graphicView);
28                 virtual ~RS_Snapper();
29
30                 void init();
31                 void finish();
32
33                 RS_Entity * getKeyEntity();
34                 void setSnapMode(RS2::SnapMode snapMode);
35                 void setSnapRestriction(RS2::SnapRestriction snapRes);
36                 void setSnapRange(int r);
37
38                 Vector snapPoint(QMouseEvent * e);
39                 Vector snapFree(Vector coord);
40                 Vector snapEndpoint(Vector coord);
41                 Vector snapGrid(Vector coord);
42                 Vector snapOnEntity(Vector coord);
43                 Vector snapCenter(Vector coord);
44                 Vector snapMiddle(Vector coord);
45                 Vector snapDist(Vector coord);
46                 Vector snapIntersection(Vector coord);
47                 //Vector snapDirect(Vector coord, bool abs);
48
49                 Vector restrictOrthogonal(Vector coord);
50                 Vector restrictHorizontal(Vector coord);
51                 Vector restrictVertical(Vector coord);
52
53                 //RS_Entity* catchLeafEntity(const Vector& pos);
54                 //RS_Entity* catchLeafEntity(QMouseEvent* e);
55                 RS_Entity * catchEntity(const Vector & pos, RS2::ResolveLevel level = RS2::ResolveNone);
56                 RS_Entity * catchEntity(QMouseEvent * e, RS2::ResolveLevel level = RS2::ResolveNone);
57
58                 virtual void suspend();
59                 virtual void resume();
60                 virtual void hideOptions();
61                 virtual void showOptions();
62
63                 void drawSnapper();
64                 void deleteSnapper();
65
66         private:
67                 void xorSnapper();
68
69         protected:
70                 RS_EntityContainer * container;
71                 RS_GraphicView * graphicView;
72                 RS_Entity * keyEntity;
73                 Vector snapCoord;
74                 Vector snapSpot;
75                 RS2::SnapMode snapMode;
76                 RS2::SnapRestriction snapRes;
77                 /**
78                  * Snap distance for snaping to points with a
79                  * given distance from endpoints.
80                  */
81                 double distance;
82                 /**
83                  * Keeps track of the drawings in XOR mode.
84                  */
85                 bool visible;
86                 /**
87                  * Snap range for catching entities.
88                  */
89                 int snapRange;
90                 /**
91                  * Show large cross hairs.
92                  */
93                 bool showCrosshairs;
94                 bool finished;
95 };
96
97 #endif