Function

Pango-1.0 ▶ Pango ▶ shape_with_flagsSince 1.44

  • Convert the characters in text into 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_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 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_with_flags.

    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.

    • analysis: Analysis

      Pango.Analysis structure from Pango.itemize

    • flags: Pango.ShapeFlags

      flags influencing the shaping process

    Returns GlyphString

    1.44