summaryrefslogtreecommitdiffstats
path: root/kig/misc/coordinate_system.h
diff options
context:
space:
mode:
Diffstat (limited to 'kig/misc/coordinate_system.h')
-rw-r--r--kig/misc/coordinate_system.h134
1 files changed, 134 insertions, 0 deletions
diff --git a/kig/misc/coordinate_system.h b/kig/misc/coordinate_system.h
new file mode 100644
index 00000000..af426909
--- /dev/null
+++ b/kig/misc/coordinate_system.h
@@ -0,0 +1,134 @@
+/*
+ This file is part of Kig, a KDE program for Interactive Geometry...
+ Copyright (C) 2002 Dominique Devriese <devriese@kde.org>
+
+ This program is free software; you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation; either version 2 of the License, or
+ (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program; if not, write to the Free Software
+ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301
+ USA
+*/
+
+#ifndef KIG_MISC_COORDINATE_SYSTEM_H
+#define KIG_MISC_COORDINATE_SYSTEM_H
+
+#include <qnamespace.h>
+
+class KigPainter;
+class KigDocument;
+class KigWidget;
+class CoordinateSystem;
+class QValidator;
+class Coordinate;
+class QString;
+class QStringList;
+class QWidget;
+
+/**
+ * a factory to build a CoordinateSystem and a small handle to the
+ * existant CoordinateSystem's...
+ */
+class CoordinateSystemFactory
+{
+public:
+ enum { Euclidean = 0, Polar = 1 };
+
+ static QStringList names();
+ static QString setCoordinateSystemStatement( int id );
+ static CoordinateSystem* build( int which );
+ static CoordinateSystem* build( const char* type );
+};
+
+/**
+ * a CoordinateSystem is what the user sees: it is kept by KigPart to
+ * show the user a grid, and to show the coordinates of points... it
+ * allows for weird CoordinateSystem's like homogeneous or
+ * projective...
+ * internally, it does nothing, it could almost have been an ordinary
+ * Object..., mapping coordinates from and to the screen to and from
+ * the internal coordinates is done elsewhere ( KigPainter and
+ * KigWidget... )
+ */
+class CoordinateSystem
+ : public Qt
+{
+public:
+ CoordinateSystem();
+ virtual ~CoordinateSystem();
+
+ virtual QString fromScreen ( const Coordinate& pt, const KigDocument& w ) const = 0;
+ /**
+ * This returns a notice to say in which format coordinates should
+ * be entered. This should be something like:
+ * i18n( "Enter coordinates in the following form: \"(x,y)\", where
+ * x is the x coordinate, and y is the y coordinate." );
+ */
+ virtual QString coordinateFormatNotice() const = 0;
+ /**
+ * Like \ref coordinateFormatNotice(), but with HTML tags useful to
+ * have a rich text...
+ */
+ virtual QString coordinateFormatNoticeMarkup() const = 0;
+ virtual Coordinate toScreen (const QString& pt, bool& ok) const = 0;
+ virtual void drawGrid ( KigPainter& p, bool showgrid = true,
+ bool showaxes = true ) const = 0;
+ virtual QValidator* coordinateValidator() const = 0;
+ virtual Coordinate snapToGrid( const Coordinate& c,
+ const KigWidget& w ) const = 0;
+
+ virtual const char* type() const = 0;
+ virtual int id() const = 0;
+};
+
+class EuclideanCoords
+ : public CoordinateSystem
+{
+public:
+ EuclideanCoords();
+ ~EuclideanCoords();
+ QString fromScreen( const Coordinate& pt, const KigDocument& w ) const;
+ QString coordinateFormatNotice() const;
+ QString coordinateFormatNoticeMarkup() const;
+ Coordinate toScreen (const QString& pt, bool& ok) const;
+ void drawGrid ( KigPainter& p, bool showgrid = true,
+ bool showaxes = true ) const;
+ QValidator* coordinateValidator() const;
+ Coordinate snapToGrid( const Coordinate& c,
+ const KigWidget& w ) const;
+
+ const char* type() const;
+ int id() const;
+};
+
+class PolarCoords
+ : public CoordinateSystem
+{
+ void drawGridLine( KigPainter& p, const Coordinate& center,
+ double radius ) const;
+public:
+ PolarCoords();
+ ~PolarCoords();
+ QString fromScreen( const Coordinate& pt, const KigDocument& w ) const;
+ QString coordinateFormatNotice() const;
+ QString coordinateFormatNoticeMarkup() const;
+ Coordinate toScreen (const QString& pt, bool& ok) const;
+ void drawGrid ( KigPainter& p, bool showgrid = true,
+ bool showaxes = true ) const;
+ QValidator* coordinateValidator() const;
+ Coordinate snapToGrid( const Coordinate& c,
+ const KigWidget& w ) const;
+
+ const char* type() const;
+ int id() const;
+};
+
+#endif