Function
Pangoshape_with_flags
since: 1.44
Declaration [src]
void
pango_shape_with_flags (
const char* item_text,
int item_length,
const char* paragraph_text,
int paragraph_length,
const PangoAnalysis* analysis,
PangoGlyphString* glyphs,
PangoShapeFlags flags
)
Description [src]
Convert the characters in text into glyphs.
Given a segment of text and the corresponding PangoAnalysis structure
returned from pango_itemize(), convert the characters into glyphs.
You may also pass in only a substring of the item from pango_itemize().
This is similar to pango_shape_full(), except it also takes flags
that can influence the shaping process.
Some aspects of hyphen insertion and text transformation (in particular,
capitalization) require log attrs, and thus can only be handled by
pango_shape_item().
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.44
Parameters
item_text-
Type:
const char*Valid UTF-8 text to shape.
The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. item_length-
Type:
intThe length (in bytes) of
item_text. -1 means nul-terminated text. 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:
intThe length (in bytes) of
paragraph_text. -1 means nul-terminated text. analysis-
Type:
PangoAnalysisPangoAnalysisstructure frompango_itemize().The data is owned by the caller of the function. glyphs-
Type:
PangoGlyphStringGlyph string in which to store results.
The argument will be set by the function. The returned data is owned by the function. flags-
Type:
PangoShapeFlagsFlags influencing the shaping process.