cairo:copy-path (cr)

cr -- a cairo:context-t instance

The cairo:path-t instance for the copy of the 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 instance. See the cairo:path-data-t documentation for more information.

This function will always return a valid path, 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 the :no-memory value.
• If cr is already in an error state. In this case the cairo:path-status function will return the same status that would be returned by the cairo:status function.