cairo-get-group-target (cr)

cr -- a cairo-t context

The cairo-surface-t 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 pointer, 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 :success of the cairo-status-t enumeration.