pango.ShapeFull(item_text$, paragraph_text$, analysis, glyphs[, flags])

Given a segment of text and the corresponding Pango analysis structure returned from pcontext:Itemize(), convert the characters into glyphs. You may also pass in only a substring of the item from pcontext: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 Nil, item text is used instead.

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

The optional argument flags can be used to influence the shaping process. The following flags are currently recognized:

#PANGO_SHAPE_NONE

Default value.

#PANGO_SHAPE_ROUND_POSITIONS

Round glyph positions and widths to whole device units. This option should be set if the target renderer can't do subpixel positioning of glyphs.

item_text$

text to shape

paragraph_text$

text of the paragraph or Nil (see details)

analysis

Pango analysis object from pcontext:Itemize()

glyphs

glyph string in which to store results

flags

optional: additional flags (see above)