Name
ccontext:GetGroupTarget -- get group target
Synopsis
handle = ccontext:GetGroupTarget()
Function
Gets the current destination surface for the context. This is either the original target surface as passed to cairo.Context() or the target surface for the current group as started by the most recent call to ccontext:PushGroup() or ccontext:PushGroupWithContent().

This function will always return a valid handle, but the result can be a "nil" surface if the Cairo context is already in an error state. A Nil surface is indicated by csurface:Status() being different from #CAIRO_STATUS_SUCCESS.

This function returns the target surface. This object is owned by Cairo. To keep a reference to it, you must call csurface:Reference().

Inputs
none

Results
handle
the target surface (owned by Cairo)

Show TOC