Function
Pangoshape_item
since: 1.50
Declaration [src]
void
pango_shape_item (
PangoItem* item,
const char* paragraph_text,
int paragraph_length,
PangoLogAttr* log_attrs,
PangoGlyphString* glyphs,
PangoShapeFlags flags
)
Description [src]
Convert the characters in item
into glyphs.
This is similar to pango_shape_with_flags()
, except it takes a
PangoItem
instead of separate item_text
and analysis
arguments.
It also takes log_attrs
, which are needed for implementing some aspects
of hyphen insertion and text transforms (in particular, capitalization).
Note that the extra attributes in the analyis
that is returned from
pango_itemize()
have indices that are relative to the entire paragraph,
so you do not pass the full paragraph text as paragraph_text
, you need
to subtract the item offset from their indices before calling
pango_shape_with_flags()
.
Available since: 1.50
Parameters
item
-
Type:
PangoItem
PangoItem
to shape.The data is owned by the caller of the function. paragraph_text
-
Type:
const char*
Text of the paragraph (see details).
The argument can be NULL
.The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. paragraph_length
-
Type:
int
The length (in bytes) of
paragraph_text
. -1 means nul-terminated text. log_attrs
-
Type:
PangoLogAttr
Array of
PangoLogAttr
foritem
.The argument can be NULL
.The data is owned by the caller of the function. glyphs
-
Type:
PangoGlyphString
Glyph string in which to store results.
The data is owned by the caller of the function. flags
-
Type:
PangoShapeFlags
Flags influencing the shaping process.