A BPolygon
object represents a polygon—a closed, many-sided figure
that describes an area within a two-dimensional coordinate system. It
differs from a BRect
object in that it can have any number of sides and
the sides don't have to be aligned with the coordinate axes.
A BPolygon
is defined as a series of connected points. Each point is a
potential vertex in the polygon. An outline of the polygon could be
constructed by tracing a straight line from the first point to the
second, from the second point to the third, and so on through the whole
series, then by connecting the first and last points if they're not
identical.
The BView
functions that draw a polygon—StrokePolygon()
and
FillPolygon()
—take
BPolygon
objects as arguments.
StrokePolygon()
offers the option of leaving the polygon open—of not stroking the
line that connects the first and last points in the list. The polygon
therefore won't look like a polygon, but like an chain of lines fastened
at their endpoints.