Function pango::shape_with_flags

source ·
pub fn shape_with_flags(
    item_text: &str,
    paragraph_text: Option<&str>,
    analysis: &Analysis,
    glyphs: &mut GlyphString,
    flags: ShapeFlags
Available on crate feature v1_44 only.
Expand description

Convert the characters in @text into glyphs.

Given a segment of text and the corresponding Analysis structure returned from itemize(), convert the characters into glyphs. You may also pass in only a substring of the item from itemize().

This is similar to 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 shape_item().

Note that the extra attributes in the @analyis that is returned from 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 shape_with_flags().


valid UTF-8 text to shape


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


text of the paragraph (see details).


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


Analysis structure from itemize()


glyph string in which to store results


flags influencing the shaping process