shape

Convert the characters in text into glyphs.

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

It is recommended that you use funcPango.shape_full instead, since that API allows for shaping interaction happening across text item boundaries.

Some aspects of hyphen insertion and text transformation (in particular, capitalization) require log attrs, and thus can only be handled by funcPango.shape_item.

Note that the extra attributes in the analyis that is returned from funcPango.itemize have indices that are relative to the entire paragraph, so you need to subtract the item offset from their indices before calling funcPango.shape.

Parameters

text string

the text to process

analysis pango.analysis.Analysis

pango.analysis.Analysis structure from funcPango.itemize

glyphs pango.glyph_string.GlyphString

glyph string in which to store results