home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / yacl-012.zip / ui / ellipse.h < prev    next >
C/C++ Source or Header  |  1995-04-09  |  3KB  |  103 lines
  1.  
  2.  
  3.  
  4.  
  5. #ifndef _ellipse_h_ /* Sat Oct 29 09:47:06 1994 */
  6. #define _ellipse_h_
  7.  
  8.  
  9.  
  10. /*
  11.  *
  12.  *          Copyright (C) 1994, M. A. Sridhar
  13.  *  
  14.  *
  15.  *     This software is Copyright M. A. Sridhar, 1994. You are free
  16.  *     to copy, modify or distribute this software  as you see fit,
  17.  *     and to use  it  for  any  purpose, provided   this copyright
  18.  *     notice and the following   disclaimer are included  with all
  19.  *     copies.
  20.  *
  21.  *                        DISCLAIMER
  22.  *
  23.  *     The author makes no warranties, either expressed or implied,
  24.  *     with respect  to  this  software, its  quality, performance,
  25.  *     merchantability, or fitness for any particular purpose. This
  26.  *     software is distributed  AS IS.  The  user of this  software
  27.  *     assumes all risks  as to its quality  and performance. In no
  28.  *     event shall the author be liable for any direct, indirect or
  29.  *     consequential damages, even if the  author has been  advised
  30.  *     as to the possibility of such damages.
  31.  *
  32.  */
  33.  
  34.  
  35.  
  36. #if defined(__GNUC__)
  37. #pragma interface
  38. #endif
  39.  
  40. #include "ui/graphic.h"
  41.  
  42. class CL_EXPORT UI_Ellipse: public UI_GraphicObject {
  43.  
  44. public:
  45.     UI_Ellipse (long major_axis, long minor_axis, UI_Point origin =
  46.                 UI_Point (0, 0));
  47.     // Create an ellipse with given origin and given major and minor axes.
  48.     // If the two axes are equal, the result is a circle with given
  49.     // diameter.
  50.  
  51.     UI_Ellipse (const UI_Rectangle&);
  52.     // Construct an ellipse whose bounding box is the given rectangle.
  53.     
  54.     UI_Ellipse ();
  55.     // Create an ellipse at position (0, 0) of size 0.
  56.  
  57.     bool DrawOn (UI_DrawingSurface& sfc,
  58.                  const UI_Point& p = UI_Point (0,0)) const;
  59.     // Draw the ellipse on the surface {\tt sfc} (overrides inherited
  60.     // method).
  61.  
  62.     bool Fill   (UI_DrawingSurface& s) const;
  63.         
  64.     
  65.     bool ReshapeTo (const UI_Point& p1, const UI_Point& p2);
  66.     // Override method inherited from GraphicObject. The implementation
  67.     // reshapes the ellipse so that its bounding rectangle is the rectangle
  68.     // whose diagonally opposite points are p1 and p2.
  69.  
  70.     UI_HitTest HitTest (const UI_Point& p) const;
  71.     // Hit testing: overrides method inherited from Graphic.
  72.     
  73.     UI_Rectangle BoundingRectangle() const;
  74.     // Return the bounding rectangle of the ellipse.
  75.  
  76.     bool Includes (const UI_Point& p) const;
  77.     
  78.     bool IntersectsBoundary (const UI_Rectangle& r) const;
  79.     // Return TRUE if the rectangle {\tt r} intersects the ellipse's
  80.     // periphery. Return FALSE if the rectangle is either entirely inside or
  81.     // entirely outside the ellipse.
  82.  
  83.     UI_Point PointAtAngle (double angleInDegrees) const;
  84.     // Return the point on the ellipse's periphery at the given angle. This
  85.     // point is obtained by drawing a vector from the ellipse's origin that
  86.     // subtends the given angle with respect to the horizontal, and
  87.     // determining where this vector intersects the ellipse's periphery.
  88.     //
  89.     // The angle is reckoned counterclockwise from the horizontal. So 90
  90.     // degrees is vertical upwards.
  91.     
  92.     const char* ClassName() const {return "UI_Ellipse";};
  93.  
  94.  
  95. protected:
  96.     UI_Point _origin;
  97.     long     _majorAxis;
  98.     long     _minorAxis;
  99.  
  100. };
  101.  
  102. #endif /* _ellipse_h_ */
  103.