Given a segment of text and the corresponding Pango.Analysis 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, except it also can optionally take
the full paragraph text as input, which will then be used to perform
certain cross-item shaping interactions. If you have access to the broader
text of which item_text is part of, provide the broader text as
paragraph_text. If paragraph_text is null, item text is used instead.
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_full.
Parameters
item_text: string
valid UTF-8 text to shape.
item_length: number
the length (in bytes) of item_text. -1 means nul-terminated text.
paragraph_text: string
text of the paragraph (see details).
paragraph_length: number
the length (in bytes) of paragraph_text. -1 means nul-terminated text.
Convert the characters in
textinto glyphs.Given a segment of text and the corresponding Pango.Analysis 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, except it also can optionally take the full paragraph text as input, which will then be used to perform certain cross-item shaping interactions. If you have access to the broader text of which
item_textis part of, provide the broader text asparagraph_text. Ifparagraph_textisnull, item text is used instead.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
analyisthat is returned from Pango.itemize have indices that are relative to the entire paragraph, so you do not pass the full paragraph text asparagraph_text, you need to subtract the item offset from their indices before calling Pango.shape_full.