cairo:new-sub-path (cr)

cr -- a cairo:context-t instance

Begin a new sub-path. Note that the existing path is not affected. After this call there will be no current point. In many cases, this call is not needed since new sub-paths are frequently started with the cairo:move-to function.

A call to the cairo:new-sub-path function is particularly useful when beginning a new sub-path with one of the cairo:arc calls. This makes things easier as it is no longer necessary to manually compute the initial coordinates of the arc for a call to the cairo:move-to function.