Function
PangoAttrShapenew_with_data
since: 1.8
Declaration [src]
PangoAttribute*
pango_attr_shape_new_with_data (
const PangoRectangle* ink_rect,
const PangoRectangle* logical_rect,
gpointer data,
PangoAttrDataCopyFunc copy_func,
GDestroyNotify destroy_func
)
Description [src]
Creates a new shape attribute.
Like pango_attr_shape_new(), but a user data pointer
is also provided; this pointer can be accessed when later
rendering the glyph.
Available since: 1.8
Parameters
ink_rect-
Type:
PangoRectangleInk rectangle to assign to each character.
The data is owned by the caller of the function. logical_rect-
Type:
PangoRectangleLogical rectangle to assign to each character.
The data is owned by the caller of the function. data-
Type:
gpointerUser data pointer.
The argument can be NULL.The data is owned by the caller of the function. copy_func-
Type:
PangoAttrDataCopyFuncFunction to copy
datawhen the attribute is copied. IfNULL,datais simply copied as a pointer. destroy_func-
Type:
GDestroyNotifyFunction to free
datawhen the attribute is freed.
Return value
Type: PangoAttribute
The newly allocated
PangoAttribute, which should be freed with
pango_attribute_destroy().
| The caller of the function takes ownership of the data, and is responsible for freeing it. |