createLayout

Creates a layout object set up to match the current transformation and target surface of the Cairo context.

This layout can then be used for text measurement with functions like pango.layout.Layout.getSize or drawing with functions like funcshow_layout. If you change the transformation or target surface for cr, you need to call funcupdate_layout.

This function is the most convenient way to use Cairo with Pango, however it is slightly inefficient since it creates a separate pango.context.Context object for each layout. This might matter in an application that was laying out large amounts of text.

Parameters

cr cairo.context.Context

a Cairo context

Return Value

Type: pango.layout.Layout

the newly created pango.layout.Layout