summaryrefslogtreecommitdiffstats
path: root/kig/misc/coordinate_system.h
blob: f6c8cc7d6fc7ec97ba4751e23ae5881e675a4c6e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
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 <tqnamespace.h>

class KigPainter;
class KigDocument;
class KigWidget;
class CoordinateSystem;
class TQValidator;
class Coordinate;
class TQString;
class TQStringList;
class TQWidget;

/**
 * a factory to build a CoordinateSystem and a small handle to the
 * existant CoordinateSystem's...
 */
class CoordinateSystemFactory
{
public:
  enum { Euclidean = 0, Polar = 1 };

  static TQStringList names();
  static TQString 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 TQt
{
public:
  CoordinateSystem();
  virtual ~CoordinateSystem();

  virtual TQString 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 TQString coordinateFormatNotice() const = 0;
  /**
   * Like \ref coordinateFormatNotice(), but with HTML tags useful to
   * have a rich text...
   */
  virtual TQString coordinateFormatNoticeMarkup() const = 0;
  virtual Coordinate toScreen (const TQString& pt, bool& ok) const = 0;
  virtual void drawGrid ( KigPainter& p, bool showgrid = true,
                          bool showaxes = true ) const = 0;
  virtual TQValidator* 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();
  TQString fromScreen( const Coordinate& pt, const KigDocument& w ) const;
  TQString coordinateFormatNotice() const;
  TQString coordinateFormatNoticeMarkup() const;
  Coordinate toScreen (const TQString& pt, bool& ok) const;
  void drawGrid ( KigPainter& p, bool showgrid = true,
                  bool showaxes = true ) const;
  TQValidator* 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();
  TQString fromScreen( const Coordinate& pt, const KigDocument& w ) const;
  TQString coordinateFormatNotice() const;
  TQString coordinateFormatNoticeMarkup() const;
  Coordinate toScreen (const TQString& pt, bool& ok) const;
  void drawGrid ( KigPainter& p, bool showgrid = true,
                  bool showaxes = true ) const;
  TQValidator* coordinateValidator() const;
  Coordinate snapToGrid( const Coordinate& c,
                         const KigWidget& w ) const;

  const char* type() const;
  int id() const;
};

#endif