polygons(3U)

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)