Context.getGroupTarget

cairo.surface.Surface getGroupTarget()

Gets the current destination surface for the context. This is either the original target surface as passed to [cairo.global.create] or the target surface for the current group as started by the most recent call to [cairo.context.Context.pushGroup] or [cairo.context.Context.pushGroupWithContent].

This function will always return a valid pointer, but the result can be a "nil" surface if cr is already in an error state, (ie. [cairo.context.Context.status] <literal>!=</literal> [cairo.types.Status.Success]). A nil surface is indicated by [cairo.surface.Surface.status]

<literal>!=</literal> [cairo.types.Status.Success].

Returns

the target surface. This object is owned by cairo. To

keep a reference to it, you must call [cairo.surface.Surface.reference].