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,
)
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()
.
§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
Analysis
structure from itemize()
§glyphs
glyph string in which to store results
§flags
flags influencing the shaping process