NAME

       Rect,  S_Rect,  F_Rect,  SF_Rect, Polygon, S_Polygon, F_Polygon, SF_Polygon - structured graphics classes
       for rectangles and polygons

SYNOPSIS

       #include <Unidraw/Graphic/polygons.h>

DESCRIPTION

       Rect and Polygon serve as abstract base classes for rectangle and polygon structured graphics.  They  are
       derived  from  Graphic  and  Vertices,  respectively.   Predefined subclasses include S_Rect, F_Rect, and
       SF_Rect, which  draw  stroked,  filled,  and  stroked-filled  rectangles,  respectively;  and  S_Polygon,
       F_Polygon,  and  SF_Polygon,  which draw stroked, filled, and stroked-filled polygons, respectively.  The
       stroked subclasses store a PSBrush, the filled subclasses  store  a  PSPattern,  and  the  stroked-filled
       subclasses store one of each.

RECT PUBLIC OPERATIONS

       void GetOriginal(Coord& x0, Coord& y0, Coord& x1, Coord& y1)
              Return  the rectangle's geometry, as specified in the constructor.  (x0, y0) defines one corner of
              the rectangle, while (x1, y1) defines the opposing corner.

RECT PROTECTED OPERATIONS

       Rectangle(Coord x0, Coord y0, Coord x1, Coord y1, Graphic* = nil)
              The constructor is protected to disallow instantiation of the abstract base class.  A  rectangle's
              geometry  is  defined  by  two  points,  corresponding  to opposing corners of the rectangle.  The
              constructor also takes an optional graphic from which to obtain an initial set of graphics state.

       void s_getExtent(
           float&, float&, float&, float&, float&, Graphic*
       )

       void f_getExtent(
           float&, float&, float&, float&, float&, Graphic*
       )

       boolean s_contains(PointObj&, Graphic*)
       boolean f_contains(PointObj&, Graphic*)
       boolean s_intersects(BoxObj&, Graphic*)
       boolean f_intersects(BoxObj&, Graphic*)
              Helper functions that return extent and hit detection information based on the bounding  box  that
              the rectangle defines.  s_getExtent, s_contains, and s_intersects return information that accounts
              for the width of a brush, as would be necessary if the rectangle is  stroked,  while  f_getExtent,
              f_contains,  and  f_intersects  assumes  that  the  rectangle  is  filled.  Subclasses can use the
              operations to help implement their getExtent, contains, and intersects operations.

RECT SUBCLASS PUBLIC OPERATIONS

       S_Rect(Coord x0, Coord y0, Coord x1, Coord y1, Graphic* = nil)
       F_Rect(Coord x0, Coord y0, Coord x1, Coord y1, Graphic* = nil)
       SF_Rect(Coord x0, Coord y0, Coord x1, Coord y1, Graphic* = nil)
              Constructors for the various predefined Rect subclasses.

POLYGON PROTECTED OPERATIONS

       Polygon(Coord* x, Coord* y, int count, Graphic* = nil)
              Polygon's constructor is protected to prevent instantiation  of  the  abstract  base  class.   The
              parameters are passed directly to the Vertices constructor.

POLYGON SUBCLASS PUBLIC OPERATIONS

       S_Polygon(Coord* x, Coord* y, int count, Graphic* = nil)
       F_Polygon(Coord* x, Coord* y, int count, Graphic* = nil)
       SF_Polygon(Coord* x, Coord* y, int count, Graphic* = nil)
              Constructors for the various predefined Rect subclasses.

SEE ALSO

       Graphic(3U), Vertices(3U), geomobjs(3U), pspaint(3U)