cairoClosePath: cairoClosePath
Description
Adds a line segment to the path from the current point to the
beginning of the current sub-path, (the most recent point passed to
cairoMoveTo
), and closes this sub-path. After this call the
current point will be at the joined endpoint of the sub-path.Details
The behavior of cairoClosePath
is distinct from simply calling
cairoLineTo
with the equivalent coordinate in the case of
stroking. When a closed sub-path is stroked, there are no caps on
the ends of the sub-path. Instead, there is a line join connecting
the final and initial segments of the sub-path.
If there is no current point before the call to cairoClosePath
,
this function will have no effect.
Note: As of cairo version 1.2.4 any call to cairoClosePath
will
place an explicit MOVE_TO element into the path immediately after
the CLOSE_PATH element, (which can be seen in cairoCopyPath
for
example). This can simplify path processing in some cases as it may
not be necessary to save the "last move_to point" during processing
as the MOVE_TO immediately after the CLOSE_PATH will provide that
point.