bionic (3) Vertices.3U.gz

NAME

       Vertices - abstract base class for graphics defined by a set of coordinate pairs

SYNOPSIS

       #include <Unidraw/Graphic/verts.h>

DESCRIPTION

       Vertices  is an abstract base class for graphics such as polygons and splines whose geometry is specified
       by a set of coordinate pairs.  The Vertices class supports vertex-related operations common to  all  such
       graphical objects and also supports extent caching.

PUBLIC OPERATIONS

       virtual ~Vertices()
              The destructor deallocates the list of coordinate pairs stored in the graphic.

       virtual int GetOriginal(const Coord*& x, const Coord*& y)
              Return  pointers  to  the  arrays  of Coords stored internally that define the graphic's vertices.
              GetOriginal's return value reflects the size of the arrays.

       virtual boolean operator == (Vertices&)
       virtual boolean operator != (Vertices&)
              Compare this to the given Vertices instance and return whether they (do not) store identical  sets
              of vertices.

PROTECTED OPERATIONS

       Vertices(Graphic* = nil)
       Vertices(Coord* x, Coord* y, int count, Graphic* = nil)
              The  constructors  are  protected to disallow instantiation of the abstract class.  Subclasses can
              pass a set of vertices to copy into internal storage and an optional graphic from which to  obtain
              an  initial  set of graphics state.  Vertices itself stores no additional graphics state over that
              in the Graphic base class.

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

       void f_getExtent(
           float&, float&, float&, float&, float&, Graphic*
       )
              Helper functions that return extent information based  on  the  bounding  box  that  the  vertices
              define.   s_getExtent  returns  an  extent  that  accounts  for  the width of a brush, as would be
              necessary if the vertices defined a stroked path, while  f_getExtent  assumes  that  the  vertices
              define  the  graphic's  extremities,  as  would be the case if the vertices defined a filled path.
              These operations cache the extent they compute initially.

SEE ALSO

       Graphic(3U)