cairo:group-target (cr)

cr -- a cairo:context-t instance

The cairo:surface-t instance for the target surface. This object is owned by Cairo. To keep a reference to it, you must call the cairo:surface-reference function.

Gets the current destination surface for the Cairo context. This is either the original target surface as passed to the cairo:create function or the target surface for the current group as started by the most recent call to the cairo:push-group or cairo:push-group-with-content functions.

This function will always return a valid surface, but the result can be a "nil" surface if cr is already in an error state. A "nil" surface is indicated by a value not equal to the :success value of the cairo:status-t enumeration.