Package: cairo

Function cairo:group-target

Lambda List

cairo:group-target (cr)

Arguments

cr -- a cairo:context-t instance

Return Value

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

Details

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.
 

See also

#2025-1-2