Function
PangoCairocreate_layout
Declaration [src]
PangoLayout*
pango_cairo_create_layout (
cairo_t* cr
)
Description [src]
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_get_size()
or drawing with functions like
pango_cairo_show_layout()
. If you change the transformation or target
surface for cr
, you need to call pango_cairo_update_layout()
.
This function is the most convenient way to use Cairo with Pango,
however it is slightly inefficient since it creates a separate
PangoContext
object for each layout. This might matter in an
application that was laying out large amounts of text.
Available since: | 1.10 |
Parameters
cr |
cairo_t |
A Cairo context. |
|
The data is owned by the caller of the function. |
Return value
Returns: | PangoLayout |
The newly created |
|
The caller of the function takes ownership of the data, and is responsible for freeing it. |