cairo-save (cr)

cr -- a cairo-t context

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, cr 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.