Engauge Digitizer  2
 All Classes Files Functions Variables Enumerations Enumerator Friends Pages
DigitizeStateAbstractBase.h
1 /******************************************************************************************************
2  * (C) 2014 markummitchell@github.com. This file is part of Engauge Digitizer, which is released *
3  * under GNU General Public License version 2 (GPLv2) or (at your option) any later version. See file *
4  * LICENSE or go to gnu.org/licenses for details. Distribution requires prior written permission. *
5  ******************************************************************************************************/
6 
7 #ifndef DIGITIZE_STATE_ABSTRACT_BASE_H
8 #define DIGITIZE_STATE_ABSTRACT_BASE_H
9 
10 #include "PointStyle.h"
11 #include <QCursor>
12 #include <QPointF>
13 
14 class CmdMediator;
18 class QGraphicsScene;
19 class QImage;
20 class QString;
21 class QStringList;
22 class QTimer;
23 
25 enum DigitizeState {
26  DIGITIZE_STATE_AXIS,
27  DIGITIZE_STATE_COLOR_PICKER,
28  DIGITIZE_STATE_CURVE,
29  DIGITIZE_STATE_EMPTY,
30  DIGITIZE_STATE_POINT_MATCH,
31  DIGITIZE_STATE_SEGMENT,
32  DIGITIZE_STATE_SELECT,
33  NUM_DIGITIZE_STATES
34 };
35 
38 {
39 public:
42  virtual ~DigitizeStateAbstractBase ();
43 
45  virtual QString activeCurve () const = 0;
46 
49  virtual void begin(CmdMediator *cmdMediator,
50  DigitizeState previousState) = 0;
51 
54 
56  const DigitizeStateContext &context() const;
57 
59  virtual void end() = 0;
60 
62  virtual void handleContextMenuEventAxis (CmdMediator *cmdMediator,
63  const QString &pointIdentifier) = 0;
64 
66  virtual void handleContextMenuEventGraph (CmdMediator *cmdMediator,
67  const QStringList &pointIdentifiers) = 0;
68 
70  virtual void handleCurveChange (CmdMediator *cmdMediator) = 0;
71 
73  virtual void handleKeyPress (CmdMediator *cmdMediator,
74  Qt::Key key,
75  bool atLeastOneSelectedItem) = 0;
76 
78  virtual void handleMouseMove (CmdMediator *cmdMediator,
79  QPointF posScreen) = 0;
80 
82  virtual void handleMousePress (CmdMediator *cmdMediator,
83  QPointF pos) = 0;
84 
86  virtual void handleMouseRelease (CmdMediator *cmdMediator,
87  QPointF pos) = 0;
88 
90  void setCursor(CmdMediator *cmdMediator);
91 
93  virtual QString state() const = 0;
94 
96  virtual void updateAfterPointAddition () = 0;
97 
99  virtual void updateModelDigitizeCurve (CmdMediator *cmdMediator,
100  const DocumentModelDigitizeCurve &modelDigitizeCurve) = 0;
101 
103  virtual void updateModelSegments(const DocumentModelSegments &modelSegments) = 0;
104 
105 protected:
107  virtual QCursor cursor (CmdMediator *cmdMediator) const = 0;
108 
109 private:
111 
112  DigitizeStateContext &m_context;
113 
114 };
115 
116 #endif // DIGITIZE_STATE_ABSTRACT_BASE_H
virtual void handleMousePress(CmdMediator *cmdMediator, QPointF pos)=0
Handle a mouse press that was intercepted earlier.
virtual QString activeCurve() const =0
Name of the active Curve. This can include AXIS_CURVE_NAME.
virtual QCursor cursor(CmdMediator *cmdMediator) const =0
Returns the state-specific cursor shape.
virtual void handleKeyPress(CmdMediator *cmdMediator, Qt::Key key, bool atLeastOneSelectedItem)=0
Handle a key press that was intercepted earlier.
virtual QString state() const =0
State name for debugging.
virtual void handleMouseRelease(CmdMediator *cmdMediator, QPointF pos)=0
Handle a mouse release that was intercepted earlier.
virtual void handleContextMenuEventAxis(CmdMediator *cmdMediator, const QString &pointIdentifier)=0
Handle a right click, on an axis point, that was intercepted earlier.
DigitizeStateContext & context()
Reference to the DigitizeStateContext that contains all the DigitizeStateAbstractBase subclasses...
virtual void end()=0
Method that is called at the exact moment a state is exited. Typically called just before begin for t...
Model for DlgSettingsDigitizeCurve and CmdSettingsDigitizeCurve.
void setCursor(CmdMediator *cmdMediator)
Update the cursor according to the current state.
Container for all DigitizeStateAbstractBase subclasses. This functions as the context class in a stan...
virtual void updateModelSegments(const DocumentModelSegments &modelSegments)=0
Update the segments given the new settings.
virtual void handleMouseMove(CmdMediator *cmdMediator, QPointF posScreen)=0
Handle a mouse move. This is part of an experiment to see if augmenting the cursor in Point Match mod...
Command queue stack.
Definition: CmdMediator.h:23
virtual void updateModelDigitizeCurve(CmdMediator *cmdMediator, const DocumentModelDigitizeCurve &modelDigitizeCurve)=0
Update the digitize curve settings.
Model for DlgSettingsSegments and CmdSettingsSegments.
virtual void handleContextMenuEventGraph(CmdMediator *cmdMediator, const QStringList &pointIdentifiers)=0
Handle a right click, on a graph point, that was intercepted earlier.
virtual void handleCurveChange(CmdMediator *cmdMediator)=0
Handle the selection of a new curve. At a minimum, DigitizeStateSegment will generate a new set of Se...
Base class for all digitizing states. This serves as an interface to DigitizeStateContext.
virtual void updateAfterPointAddition()=0
Update graphics attributes after possible new points. This is useful for highlight opacity...
virtual void begin(CmdMediator *cmdMediator, DigitizeState previousState)=0
Method that is called at the exact moment a state is entered.