cairo-pop-group-to-source (cr)

cr -- a cairo-t context

Terminates the redirection begun by a call to the cairo-push-group or cairo-push-group-with-content functions and installs the resulting pattern as the source pattern in the given Cairo context. The behavior of this function is equivalent to the sequence of operations:

(setf group (cairo-pop-group cr))
(cairo-set-source cr group)
(cairo-pattern-destroy group)  

but is more convenient as their is no need for a variable to store the pattern.

The cairo-pop-group-to-source function calls the cairo-restore function, balancing a call to the cairo-save function by the push group function, so that any changes to the graphics state will not be visible outside the group.