RGtk2 (version 2.12.17)

cairoGetGroupTarget: cairoGetGroupTarget

Description

Gets the current destination surface for the context. This is either the original target surface as passed to cairoCreate or the target surface for the current group as started by the most recent call to cairoPushGroup or cairoPushGroupWithContent.

Usage

cairoGetGroupTarget(cr)

Arguments

cr

[Cairo] a cairo context

Value

• [CairoSurface] the target surface. To keep a reference to it, you must call cairoSurfaceReference.

Details

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. cairoStatus != CAIRO_STATUS_SUCCESS). A nil surface is indicated by cairoSurfaceStatus != CAIRO_STATUS_SUCCESS.

Since 1.2