cairo-pop-group (cr)

cr -- a cairo-t context

A newly created cairo-pattern-t instance containing the results of all drawing operations performed to the group. The caller owns the returned instance and should call the cairo-pattern-destroy function when finished with it.

Terminates the redirection begun by a call to the cairo-push-group or cairo-push-group-with-content functions and returns a new pattern containing the results of all drawing operations performed to the group.

The cairo-pop-group 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.