Engauge Digitizer  2
CoordSystemInterface.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 COORD_SYSTEM_INTERFACE_H
8 #define COORD_SYSTEM_INTERFACE_H
9 
10 #include "CallbackSearchReturn.h"
11 #include "CurveStyles.h"
12 #include "DocumentModelAxesChecker.h"
13 #include "DocumentModelColorFilter.h"
14 #include "DocumentModelCoords.h"
15 #include "DocumentModelDigitizeCurve.h"
16 #include "DocumentModelExportFormat.h"
17 #include "DocumentModelGeneral.h"
18 #include "DocumentModelGridDisplay.h"
19 #include "DocumentModelGridRemoval.h"
20 #include "DocumentModelPointMatch.h"
21 #include "DocumentModelSegments.h"
22 #include "functor.h"
23 #include "Point.h"
24 
25 class Curve;
26 class CurvesGraphs;
27 class QPointF;
28 class QString;
29 class QStringList;
30 class Transformation;
31 
34 {
35 public:
38  virtual ~CoordSystemInterface ();
39 
41  virtual void addGraphCurveAtEnd (const QString &curveName) = 0;
42 
49  virtual void addPointAxisWithGeneratedIdentifier (const QPointF &posScreen,
50  const QPointF &posGraph,
51  QString &identifier,
52  double ordinal,
53  bool isXOnly) = 0;
54 
61  virtual void addPointAxisWithSpecifiedIdentifier (const QPointF &posScreen,
62  const QPointF &posGraph,
63  const QString &identifier,
64  double ordinal,
65  bool isXOnly) = 0;
66 
68  virtual void addPointGraphWithGeneratedIdentifier (const QString &curveName,
69  const QPointF &posScreen,
70  QString &generatedIentifier,
71  double ordinal) = 0;
72 
74  virtual void addPointGraphWithSpecifiedIdentifier (const QString &curveName,
75  const QPointF &posScreen,
76  const QString &identifier,
77  double ordinal) = 0;
78 
81 
83  virtual void checkAddPointAxis (const QPointF &posScreen,
84  const QPointF &posGraph,
85  bool &isError,
86  QString &errorMessage,
87  bool isXOnly) = 0;
88 
90  virtual void checkEditPointAxis (const QString &pointIdentifier,
91  const QPointF &posScreen,
92  const QPointF &posGraph,
93  bool &isError,
94  QString &errorMessage) = 0;
95 
97  virtual const Curve &curveAxes () const = 0;
98 
100  virtual Curve *curveForCurveName (const QString &curveName) = 0;
101 
103  virtual const Curve *curveForCurveName (const QString &curveName) const = 0;
104 
106  virtual const CurvesGraphs &curvesGraphs () const = 0;
107 
109  virtual QStringList curvesGraphsNames () const = 0;
110 
112  virtual int curvesGraphsNumPoints (const QString &curveName) const = 0;
113 
115  virtual void editPointAxis (const QPointF &posGraph,
116  const QString &identifier) = 0;
117 
119  virtual void editPointGraph (bool isX,
120  bool isY,
121  double x,
122  double y,
123  const QStringList &identifiers,
124  const Transformation &transformation) = 0;
125 
127  virtual void iterateThroughCurvePointsAxes (const Functor2wRet<const QString &, const Point &, CallbackSearchReturn> &ftorWithCallback) = 0;
128 
130  virtual void iterateThroughCurvePointsAxes (const Functor2wRet<const QString &, const Point &, CallbackSearchReturn> &ftorWithCallback) const = 0;
131 
133  virtual void iterateThroughCurveSegments (const QString &curveName,
134  const Functor2wRet<const Point &, const Point &, CallbackSearchReturn> &ftorWithCallback) const = 0;
135 
137  virtual void iterateThroughCurvesPointsGraphs (const Functor2wRet<const QString &, const Point &, CallbackSearchReturn> &ftorWithCallback) = 0;
138 
140  virtual void iterateThroughCurvesPointsGraphs (const Functor2wRet<const QString &, const Point &, CallbackSearchReturn> &ftorWithCallback) const = 0;
141 
143  virtual bool loadCurvesFile (const QString &curvesFile) = 0;
144 
146  virtual DocumentModelAxesChecker modelAxesChecker() const = 0;
147 
149  virtual DocumentModelColorFilter modelColorFilter() const = 0;
150 
152  virtual DocumentModelCoords modelCoords () const = 0;
153 
155  virtual CurveStyles modelCurveStyles() const = 0;
156 
159 
161  virtual DocumentModelExportFormat modelExport() const = 0;
162 
164  virtual DocumentModelGeneral modelGeneral() const = 0;
165 
167  virtual DocumentModelGridDisplay modelGridDisplay() const = 0;
168 
170  virtual DocumentModelGridRemoval modelGridRemoval() const = 0;
171 
173  virtual DocumentModelPointMatch modelPointMatch() const = 0;
174 
176  virtual DocumentModelSegments modelSegments() const = 0;
177 
179  virtual void movePoint (const QString &pointIdentifier,
180  const QPointF &deltaScreen) = 0;
181 
183  virtual int nextOrdinalForCurve (const QString &curveName) const = 0;
184 
186  virtual QPointF positionGraph (const QString &pointIdentifier) const = 0;
187 
189  virtual QPointF positionScreen (const QString &pointIdentifier) const = 0;
190 
192  virtual void print () const = 0;
193 
195  virtual void printStream (QString indentation,
196  QTextStream &str) const = 0;
197 
199  virtual QString reasonForUnsuccessfulRead () const = 0;
200 
202  virtual void removePointAxis (const QString &identifier) = 0;
203 
205  virtual void removePointGraph (const QString &identifier) = 0;
206 
208  virtual void removePointsInCurvesGraphs (CurvesGraphs &curvesGraphs) = 0;
209 
211  virtual void saveXml (QXmlStreamWriter &writer) const = 0;
212 
214  virtual QString selectedCurveName () const = 0;
215 
217  virtual void setCurveAxes (const Curve &curveAxes) = 0;
218 
220  virtual void setCurvesGraphs (const CurvesGraphs &curvesGraphs) = 0;
221 
224 
227 
229  virtual void setModelCoords (const DocumentModelCoords &modelCoords) = 0;
230 
232  virtual void setModelCurveStyles(const CurveStyles &modelCurveStyles) = 0;
233 
236 
238  virtual void setModelExport(const DocumentModelExportFormat &modelExport) = 0;
239 
241  virtual void setModelGeneral (const DocumentModelGeneral &modelGeneral) = 0;
242 
245 
248 
251 
253  virtual void setModelSegments(const DocumentModelSegments &modelSegments) = 0;
254 
256  virtual void setSelectedCurveName(const QString &selectedCurveName) = 0;
257 
259  virtual bool successfulRead () const = 0;
260 
263  virtual void updatePointOrdinals (const Transformation &transformation) = 0;
264 };
265 
266 #endif // COORD_SYSTEM_INTERFACE_H
Model for DlgSettingsGeneral and CmdSettingsGeneral.
virtual void addGraphCurveAtEnd(const QString &curveName)=0
Add new graph curve to the list of existing graph curves.
virtual void removePointGraph(const QString &identifier)=0
Perform the opposite of addPointGraph.
CoordSystemInterface()
Single constructor.
Model for DlgSettingsPointMatch and CmdSettingsPointMatch.
virtual void setCurvesGraphs(const CurvesGraphs &curvesGraphs)=0
Let CmdAbstract classes overwrite CurvesGraphs. Applies to current coordinate system.
Model for DlgSettingsGridDisplay and CmdSettingsGridDisplay.
virtual void setModelExport(const DocumentModelExportFormat &modelExport)=0
Set method for DocumentModelExportFormat.
virtual const Curve & curveAxes() const =0
Get method for axis curve.
Model for DlgSettingsExportFormat and CmdSettingsExportFormat.
virtual DocumentModelCoords modelCoords() const =0
Get method for DocumentModelCoords.
Model for DlgSettingsCurveProperties and CmdSettingsCurveProperties.
Definition: CurveStyles.h:22
virtual void addPointAxisWithGeneratedIdentifier(const QPointF &posScreen, const QPointF &posGraph, QString &identifier, double ordinal, bool isXOnly)=0
Add a single axis point with a generated point identifier.
virtual void addPointsInCurvesGraphs(CurvesGraphs &curvesGraphs)=0
Add all points identified in the specified CurvesGraphs. See also removePointsInCurvesGraphs.
virtual void setModelColorFilter(const DocumentModelColorFilter &modelColorFilter)=0
Set method for DocumentModelColorFilter.
virtual DocumentModelAxesChecker modelAxesChecker() const =0
Get method for DocumentModelAxesChecker.
virtual void setModelCurveStyles(const CurveStyles &modelCurveStyles)=0
Set method for CurveStyles.
Interface common to CoordSystemContext and CoordSystem classes.
virtual void setModelPointMatch(const DocumentModelPointMatch &modelPointMatch)=0
Set method for DocumentModelPointMatch.
virtual DocumentModelExportFormat modelExport() const =0
Get method for DocumentModelExportFormat.
virtual QStringList curvesGraphsNames() const =0
See CurvesGraphs::curvesGraphsNames.
virtual void movePoint(const QString &pointIdentifier, const QPointF &deltaScreen)=0
See Curve::movePoint.
virtual QString reasonForUnsuccessfulRead() const =0
Return an informative text message explaining why startup loading failed. Applies if successfulRead r...
virtual DocumentModelSegments modelSegments() const =0
Get method for DocumentModelSegments.
virtual void editPointAxis(const QPointF &posGraph, const QString &identifier)=0
Edit the graph coordinates of a single axis point. Call this after checkAddPointAxis to guarantee suc...
virtual const CurvesGraphs & curvesGraphs() const =0
Make all Curves available, read only, for CmdAbstract classes only.
virtual DocumentModelGeneral modelGeneral() const =0
Get method for DocumentModelGeneral.
virtual QPointF positionScreen(const QString &pointIdentifier) const =0
See Curve::positionScreen.
virtual bool successfulRead() const =0
Return true if startup loading succeeded. If the loading failed then reasonForUnsuccessfulRed will ex...
virtual void setModelSegments(const DocumentModelSegments &modelSegments)=0
Set method for DocumentModelSegments.
virtual void setModelGridRemoval(const DocumentModelGridRemoval &modelGridRemoval)=0
Set method for DocumentModelGridRemoval.
virtual DocumentModelGridRemoval modelGridRemoval() const =0
Get method for DocumentModelGridRemoval.
virtual void setSelectedCurveName(const QString &selectedCurveName)=0
Save curve name that is selected for the current coordinate system, for the next time the coordinate ...
virtual void iterateThroughCurvesPointsGraphs(const Functor2wRet< const QString &, const Point &, CallbackSearchReturn > &ftorWithCallback)=0
See Curve::iterateThroughCurvePoints, for all the graphs curves.
virtual void updatePointOrdinals(const Transformation &transformation)=0
Update point ordinals after point addition/removal or dragging.
virtual void setModelDigitizeCurve(const DocumentModelDigitizeCurve &modelDigitizeCurve)=0
Set method for DocumentModelDigitizeCurve.
virtual CurveStyles modelCurveStyles() const =0
Get method for CurveStyles.
virtual void setModelGridDisplay(const DocumentModelGridDisplay &modelGridDisplay)=0
Set method for DocumentModelGridDisplay.
Model for DlgSettingsDigitizeCurve and CmdSettingsDigitizeCurve.
virtual void checkEditPointAxis(const QString &pointIdentifier, const QPointF &posScreen, const QPointF &posGraph, bool &isError, QString &errorMessage)=0
Check before calling editPointAxis.
virtual bool loadCurvesFile(const QString &curvesFile)=0
Load the curve names in the specified Engauge file into the current graph. This is called near the en...
virtual DocumentModelGridDisplay modelGridDisplay() const =0
Get method for DocumentModelGridDisplay.
Affine transformation between screen and graph coordinates, based on digitized axis points...
virtual DocumentModelDigitizeCurve modelDigitizeCurve() const =0
Get method for DocumentModelDigitizeCurve.
virtual void editPointGraph(bool isX, bool isY, double x, double y, const QStringList &identifiers, const Transformation &transformation)=0
Edit the graph coordinates of one or more graph points.
Container for all graph curves. The axes point curve is external to this class.
Definition: CurvesGraphs.h:24
Model for DlgSettingsColorFilter and CmdSettingsColorFilter.
virtual void removePointAxis(const QString &identifier)=0
Perform the opposite of addPointAxis.
virtual void iterateThroughCurvePointsAxes(const Functor2wRet< const QString &, const Point &, CallbackSearchReturn > &ftorWithCallback)=0
See Curve::iterateThroughCurvePoints, for the axes curve.
Model for DlgSettingsCoords and CmdSettingsCoords.
Container for one set of digitized Points.
Definition: Curve.h:32
virtual DocumentModelPointMatch modelPointMatch() const =0
Get method for DocumentModelPointMatch.
virtual void setCurveAxes(const Curve &curveAxes)=0
Let CmdAbstract classes overwrite axes Curve. Applies to current coordinate system.
Model for DlgSettingsAxesChecker and CmdSettingsAxesChecker.
virtual Curve * curveForCurveName(const QString &curveName)=0
See CurvesGraphs::curveForCurveName, although this also works for AXIS_CURVE_NAME.
virtual void setModelCoords(const DocumentModelCoords &modelCoords)=0
Set method for DocumentModelCoords.
virtual DocumentModelColorFilter modelColorFilter() const =0
Get method for DocumentModelColorFilter.
Model for DlgSettingsSegments and CmdSettingsSegments.
virtual void addPointGraphWithSpecifiedIdentifier(const QString &curveName, const QPointF &posScreen, const QString &identifier, double ordinal)=0
Add a single graph point with the specified point identifer. Note that PointStyle is not applied to t...
virtual QString selectedCurveName() const =0
Currently selected curve name. This is used to set the selected curve combobox in MainWindow...
virtual QPointF positionGraph(const QString &pointIdentifier) const =0
See Curve::positionGraph.
virtual void addPointAxisWithSpecifiedIdentifier(const QPointF &posScreen, const QPointF &posGraph, const QString &identifier, double ordinal, bool isXOnly)=0
Add a single axis point with the specified point identifier.
virtual void addPointGraphWithGeneratedIdentifier(const QString &curveName, const QPointF &posScreen, QString &generatedIentifier, double ordinal)=0
Add a single graph point with a generated point identifier.
virtual void printStream(QString indentation, QTextStream &str) const =0
Debugging method that supports print method of this class and printStream method of some other class(...
virtual void saveXml(QXmlStreamWriter &writer) const =0
Save graph to xml.
virtual void print() const =0
Debugging method for printing directly from symbolic debugger.
virtual void removePointsInCurvesGraphs(CurvesGraphs &curvesGraphs)=0
Remove all points identified in the specified CurvesGraphs. See also addPointsInCurvesGraphs.
virtual void setModelGeneral(const DocumentModelGeneral &modelGeneral)=0
Set method for DocumentModelGeneral.
Model for DlgSettingsGridRemoval and CmdSettingsGridRemoval. The settings are unstable until the user...
virtual void setModelAxesChecker(const DocumentModelAxesChecker &modelAxesChecker)=0
Set method for DocumentModelAxesChecker.
virtual int nextOrdinalForCurve(const QString &curveName) const =0
Default next ordinal value for specified curve.
virtual int curvesGraphsNumPoints(const QString &curveName) const =0
See CurvesGraphs::curvesGraphsNumPoints.
virtual void checkAddPointAxis(const QPointF &posScreen, const QPointF &posGraph, bool &isError, QString &errorMessage, bool isXOnly)=0
Check before calling addPointAxis. Also returns the next available ordinal number (to prevent clashes...
virtual void iterateThroughCurveSegments(const QString &curveName, const Functor2wRet< const Point &, const Point &, CallbackSearchReturn > &ftorWithCallback) const =0
See Curve::iterateThroughCurveSegments, for any axes or graph curve.