Engauge Digitizer  2
DigitizeStatePointMatch.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_POINT_MATCH_H
8 #define DIGITIZE_STATE_POINT_MATCH_H
9 
10 #include "DigitizeStateAbstractBase.h"
11 #include "PointMatchPixel.h"
12 #include <QList>
13 #include <QPoint>
14 
16 class QGraphicsEllipseItem;
17 class QGraphicsPixmapItem;
18 class QImage;
19 
22 {
23 public:
26  virtual ~DigitizeStatePointMatch();
27 
28  virtual QString activeCurve () const;
29  virtual void begin(CmdMediator *cmdMediator,
30  DigitizeState previousState);
31  virtual QCursor cursor (CmdMediator *cmdMediator) const;
32  virtual void end();
33  virtual void handleContextMenuEventAxis (CmdMediator *cmdMediator,
34  const QString &pointIdentifier);
35  virtual void handleContextMenuEventGraph (CmdMediator *cmdMediator,
36  const QStringList &pointIdentifiers);
37  virtual void handleCurveChange(CmdMediator *cmdMediator);
38  virtual void handleKeyPress (CmdMediator *cmdMediator,
39  Qt::Key key,
40  bool atLeastOneSelectedItem);
41  virtual void handleMouseMove (CmdMediator *cmdMediator,
42  QPointF posScreen);
43  virtual void handleMousePress (CmdMediator *cmdMediator,
44  QPointF posScreen);
45  virtual void handleMouseRelease (CmdMediator *cmdMediator,
46  QPointF posScreen);
47  virtual QString state() const;
48  virtual void updateAfterPointAddition ();
49  virtual void updateModelDigitizeCurve (CmdMediator *cmdMediator,
50  const DocumentModelDigitizeCurve &modelDigitizeCurve);
51  virtual void updateModelSegments(const DocumentModelSegments &modelSegments);
52 
53 private:
55 
56  void createPermanentPoint (CmdMediator *cmdMediator,
57  const QPointF &posScreen);
58  void createTemporaryPoint (CmdMediator *cmdMediator,
59  const QPoint &posScreen);
60  QList<PointMatchPixel> extractSamplePointPixels (const QImage &img,
61  const DocumentModelPointMatch &modelPointMatch,
62  const QPointF &posScreen) const;
63  void findPointsAndShowFirstCandidate (CmdMediator *cmdMediator,
64  const QPointF &posScreen);
65  bool pixelIsOnInImage (const QImage &img,
66  int x,
67  int y,
68  int radiusLimit) const;
69  void popCandidatePoint (CmdMediator *cmdMediator);
70  void promoteCandidatePointToPermanentPoint(CmdMediator *cmdMediator);
71 
72  QGraphicsEllipseItem *m_outline;
73  QGraphicsPixmapItem *m_candidatePoint;
74 
75  // Candidate points sorted from best match to worst match. Once accepted, each is removed since there
76  // is now an "official" point in the Document and GraphicsScene
77  QList<QPoint> m_candidatePoints;
78 
79  QPoint m_posCandidatePoint;
80 };
81 
82 #endif // DIGITIZE_STATE_POINT_MATCH_H
virtual void handleContextMenuEventGraph(CmdMediator *cmdMediator, const QStringList &pointIdentifiers)
Handle a right click, on a graph point, that was intercepted earlier.
Model for DlgSettingsPointMatch and CmdSettingsPointMatch.
virtual void updateModelSegments(const DocumentModelSegments &modelSegments)
Update the segments given the new settings.
virtual void updateAfterPointAddition()
Update graphics attributes after possible new points. This is useful for highlight opacity...
virtual QCursor cursor(CmdMediator *cmdMediator) const
Returns the state-specific cursor shape.
DigitizeStateContext & context()
Reference to the DigitizeStateContext that contains all the DigitizeStateAbstractBase subclasses...
virtual void handleMousePress(CmdMediator *cmdMediator, QPointF posScreen)
Handle a mouse press that was intercepted earlier.
virtual void handleMouseMove(CmdMediator *cmdMediator, QPointF posScreen)
Handle a mouse move. This is part of an experiment to see if augmenting the cursor in Point Match mod...
Digitizing state for matching Curve Points, one at a time.
Model for DlgSettingsDigitizeCurve and CmdSettingsDigitizeCurve.
virtual void handleKeyPress(CmdMediator *cmdMediator, Qt::Key key, bool atLeastOneSelectedItem)
Handle a key press that was intercepted earlier.
virtual QString state() const
State name for debugging.
Container for all DigitizeStateAbstractBase subclasses. This functions as the context class in a stan...
virtual void handleMouseRelease(CmdMediator *cmdMediator, QPointF posScreen)
Handle a mouse release that was intercepted earlier.
virtual void handleContextMenuEventAxis(CmdMediator *cmdMediator, const QString &pointIdentifier)
Handle a right click, on an axis point, that was intercepted earlier.
virtual void handleCurveChange(CmdMediator *cmdMediator)
Handle the selection of a new curve. At a minimum, DigitizeStateSegment will generate a new set of Se...
virtual void begin(CmdMediator *cmdMediator, DigitizeState previousState)
Method that is called at the exact moment a state is entered.
virtual void end()
Method that is called at the exact moment a state is exited. Typically called just before begin for t...
Command queue stack.
Definition: CmdMediator.h:23
Model for DlgSettingsSegments and CmdSettingsSegments.
Base class for all digitizing states. This serves as an interface to DigitizeStateContext.
virtual void updateModelDigitizeCurve(CmdMediator *cmdMediator, const DocumentModelDigitizeCurve &modelDigitizeCurve)
Update the digitize curve settings.
virtual QString activeCurve() const
Name of the active Curve. This can include AXIS_CURVE_NAME.