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 iterateThroughCurvePointsAxes (const Functor2wRet<const QString &, const Point &, CallbackSearchReturn> &ftorWithCallback) = 0;
120 
122  virtual void iterateThroughCurvePointsAxes (const Functor2wRet<const QString &, const Point &, CallbackSearchReturn> &ftorWithCallback) const = 0;
123 
125  virtual void iterateThroughCurveSegments (const QString &curveName,
126  const Functor2wRet<const Point &, const Point &, CallbackSearchReturn> &ftorWithCallback) const = 0;
127 
129  virtual void iterateThroughCurvesPointsGraphs (const Functor2wRet<const QString &, const Point &, CallbackSearchReturn> &ftorWithCallback) = 0;
130 
132  virtual void iterateThroughCurvesPointsGraphs (const Functor2wRet<const QString &, const Point &, CallbackSearchReturn> &ftorWithCallback) const = 0;
133 
135  virtual bool loadCurvesFile (const QString &curvesFile) = 0;
136 
138  virtual DocumentModelAxesChecker modelAxesChecker() const = 0;
139 
141  virtual DocumentModelColorFilter modelColorFilter() const = 0;
142 
144  virtual DocumentModelCoords modelCoords () const = 0;
145 
147  virtual CurveStyles modelCurveStyles() const = 0;
148 
151 
153  virtual DocumentModelExportFormat modelExport() const = 0;
154 
156  virtual DocumentModelGeneral modelGeneral() const = 0;
157 
159  virtual DocumentModelGridDisplay modelGridDisplay() const = 0;
160 
162  virtual DocumentModelGridRemoval modelGridRemoval() const = 0;
163 
165  virtual DocumentModelPointMatch modelPointMatch() const = 0;
166 
168  virtual DocumentModelSegments modelSegments() const = 0;
169 
171  virtual void movePoint (const QString &pointIdentifier,
172  const QPointF &deltaScreen) = 0;
173 
175  virtual int nextOrdinalForCurve (const QString &curveName) const = 0;
176 
178  virtual QPointF positionGraph (const QString &pointIdentifier) const = 0;
179 
181  virtual QPointF positionScreen (const QString &pointIdentifier) const = 0;
182 
184  virtual void print () const = 0;
185 
187  virtual void printStream (QString indentation,
188  QTextStream &str) const = 0;
189 
191  virtual QString reasonForUnsuccessfulRead () const = 0;
192 
194  virtual void removePointAxis (const QString &identifier) = 0;
195 
197  virtual void removePointGraph (const QString &identifier) = 0;
198 
200  virtual void removePointsInCurvesGraphs (CurvesGraphs &curvesGraphs) = 0;
201 
203  virtual void saveXml (QXmlStreamWriter &writer) const = 0;
204 
206  virtual QString selectedCurveName () const = 0;
207 
209  virtual void setCurveAxes (const Curve &curveAxes) = 0;
210 
212  virtual void setCurvesGraphs (const CurvesGraphs &curvesGraphs) = 0;
213 
216 
219 
221  virtual void setModelCoords (const DocumentModelCoords &modelCoords) = 0;
222 
224  virtual void setModelCurveStyles(const CurveStyles &modelCurveStyles) = 0;
225 
228 
230  virtual void setModelExport(const DocumentModelExportFormat &modelExport) = 0;
231 
233  virtual void setModelGeneral (const DocumentModelGeneral &modelGeneral) = 0;
234 
237 
240 
243 
245  virtual void setModelSegments(const DocumentModelSegments &modelSegments) = 0;
246 
248  virtual void setSelectedCurveName(const QString &selectedCurveName) = 0;
249 
251  virtual bool successfulRead () const = 0;
252 
255  virtual void updatePointOrdinals (const Transformation &transformation) = 0;
256 };
257 
258 #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.
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.