cairo-copy-path (cr)

cr -- a cairo-t context

The copy of the cairo-path-t current path. The caller owns the returned object and should call the cairo-path-destroy function when finished with it.

Creates a copy of the current path and returns it to the user as a cairo-path-t structure. See the cairo-path-data-t structure for hints on how to iterate over the returned data structure.

This function will always return a valid pointer, but the result will have no data, if either of the following conditions hold:

• If there is insufficient memory to copy the path. In this case the status of the path will be set to :no-memory.
• If cr is already in an error state. In this case path->status will contain the same status that would be returned by the cairo-status function.