tdeedu/kig/misc/coordinate_system.h

/*
 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