cairo_create

Creates a Cairo context for drawing to window.

Note that calling reset_clip on the resulting Context will produce undefined results, so avoid it at all costs.

Typically, this function is used to draw on a Window out of the paint cycle of the toolkit; this should be avoided, as it breaks various assumptions and optimizations.

If you are drawing on a native Window in response to a gdk_expose event you should use gdk_window_begin_draw_frame and gdk_drawing_context_get_cairo_context instead. GTK will automatically do this for you when drawing a widget.

Parameters:

window

a Window

Returns:

A newly created Cairo context. Free with cairo_destroy when you are done drawing.