gdk:cairo-create (window)

window -- a gdk:window object

A newly created cairo:context-t context. Free with the cairo-destroy function when you are done drawing.

Creates a Cairo context for drawing to window. Note that calling the cairo:reset-clip function on the resulting cairo:context-t context will produce undefined results, so avoid it at all costs.

Typically, this function is used to draw on a gdk:window object 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 gdk:window object in response to a :expose event you should use the gdk:window-begin-draw-frame and gdk:drawing-context-cairo-context functions instead. GTK will automatically do this for you when drawing a widget. The gdk:cairo-create function has been deprecated since version 3.22 and should not be used in newly written code. Use the gdk:window-begin-draw-frame and gdk:drawing-context-cairo-context functions instead.