cairo:save (cr)

cr -- a cairo:context-t instance

Makes a copy of the current state of cr and saves it on an internal stack of saved states for cr. When the cairo:restore function is called, the Cairo context will be restored to the saved state. Multiple calls to the cairo:save and cairo:restore functions can be nested. Each call to the cairo:restore function restores the state from the matching paired cairo:save call.

It is not necessary to clear all saved states before a Cairo context is freed. If the reference count of a Cairo context drops to zero in response to a call to the cairo:destroy function, any saved states will be freed along with the Cairo context.