Function Context.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 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 closePath() is distinct from simply
calling 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 closePath(),
this function will have no effect.
Prototype
void closePath();
Note
As of cairo version 1.2.4 any call to closePath()
will place an explicit MOVE_TO element into the path immediately
after the CLOSE_PATH element, (which can be seen in
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.
Authors
| Johannes Pfau | cairoD |
| Andrej Mitrovic | cairoD |
| cairo team | cairo |
Copyright
License
| cairoD wrapper/bindings | Boost License 1.0 |
| cairo | LGPL 2.1 / MPL 1.1 |