Context.closePath

void closePath()

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 cairo.context.Context.moveTo), and closes this sub-path. After this call the current point will be at the joined endpoint of the sub-path.

The behavior of cairo.context.Context.closePath is distinct from simply calling cairo.context.Context.lineTo 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 cairo.context.Context.closePath, this function will have no effect.

Note

As of cairo version 1.2.4 any call to cairo.context.Context.closePath will

place an explicit MOVE_TO element into the path immediately after the CLOSE_PATH element, (which can be seen in cairo.context.Context.copyPath 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.