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

cr -- a cairo:context-t instance

Terminates the redirection begun by a call to the cairo:push-group or cairo:push-group-with-content function 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))
(setf (cairo:source cr) group)
(cairo:pattern-destroy group)  

But this function 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.