shape_full


Description:


[ Version ( since = "1.32" ) ]
public void shape_full (string item_text, int item_length, string? paragraph_text, int paragraph_length, Analysis analysis, GlyphString glyphs)

Convert the characters in text into glyphs.

Given a segment of text and the corresponding `PangoAnalysis` structure returned from [[email protected]], convert the characters into glyphs. You may also pass in only a substring of the item from [[email protected]].

This is similar to [[email protected]], 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.

Note that the extra attributes in the analyis that is returned from [[email protected]] 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 [[email protected]_full].

Parameters:

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

`PangoAnalysis` structure from [[email protected]].

glyphs

glyph string in which to store results.


Namespace: Pango
Package: pango



2022 vala-language.org