Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdeedu@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

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 <[email protected]>
+
+ 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