shape_with_flags


Description:


[ Version ( since = "1.44" ) ]
public void shape_with_flags (string item_text, int item_length, string? paragraph_text, int paragraph_length, Analysis analysis, GlyphString glyphs, ShapeFlags flags)

Convert the characters in text into glyphs.

Given a segment of text and the corresponding `PangoAnalysis` structure returned from [func@Pango.itemize], convert the characters into glyphs. You may also pass in only a substring of the item from [func@Pango.itemize].

This is similar to [func@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 [ func@Pango.shape_item].

Note that the extra attributes in the analyis that is returned from [func@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 [func@Pango.shape_with_flags].

Parameters:

item_text

valid UTF-8 text to shape

item_length

the length (in bytes) of item_text. -1 means nul-terminated text.

paragraph_text

text of the paragraph (see details).

paragraph_length

the length (in bytes) of paragraph_text. -1 means nul-terminated text.

analysis

`PangoAnalysis` structure from [func@Pango.itemize]

glyphs

glyph string in which to store results

flags

flags influencing the shaping process


Namespace: Pango
Package: pango