Description
Creates a new Cairo
with all graphics state parameters set to
default values and with target
as a target surface. The target
surface should be constructed with a backend-specific function such
as cairoImageSurfaceCreate
(or any other
cairo_backendsurfaceCreate()
variant).Value
Cairo
] a newly allocated Cairo
with a reference
count of 1.
This function never returns NULL
. If memory cannot be
allocated, a special Cairo
object will be returned on
which cairoStatus
returns CAIRO_STATUS_NO_MEMORY
.
You can use this object normally, but no drawing will
be done.
Details
This function references target
, so you can immediately
call cairoSurfaceDestroy
on it if you don't need to
maintain a separate reference to it.