cairo:target (cr)

cr -- a cairo:context-t instance

The cairo:surface-t instance with the target surface. This object is owned by Cairo.

Gets the target surface for the Cairo context as passed to the cairo:create function. To keep a reference to it, you must call the cairo:surface-reference function.

This function will always return a valid Cairo surface, but the result can be a "nil" surface if cr is already in an error state.