Each glyph is represented by a separate XPolyPolygon2D in the returned sequence.

Ink, or tight bounding boxes in this case means that for e.g. an 'a', the bounding box for the XPolyPolygon2D describing the glyph 'a' is returned, not the logical dimensions of the character in the font.

Logical bounding boxes means the space that the font allocates for the given character, which, e.g. for a '.', might be significantly broader than the bounds returned via XTextLayout::queryInkMeasures().

This method returns a sequence of advancements, one for each character in the input string (not for every glyph. There might be multiple glyphs per input character, or multiple input characters per glyph). Adding up all advancements yields the total advancement of this layout. To manipulate the layout of a string on the level of characters, this method can be used to query for the layout's default advancements, which can subsequently be changed and applied to the layout via XTextLayout::applyLogicalAdvancements().

This method applies the specified advancements to every logical character in the input string (not for every glyph. There might be multiple glyphs per input character, or multiple input characters per glyph). This is useful to explicitely manipulate the exact output positions of characters, e.g. relative to a reference output device.

This method is similar to XTextLayout::queryTextMeasures, only that the overall bounds are returned by this method.

This method is the core of the XTextLayout interface, because it layouts the text in a typographically correct way into the available space.

This method can be used to combine the layout of a text line into a single justification run. This is e.g. useful if the line consists of several text portions (e.g. because of different fonts or colors), but it is desirable to spread the available space more globally across the different layout objects. If, for example, one layout object contains significantly more whitespace or Kashidas than the rest, this method can assign proportionally more space to this layout object.

This method determines the index of the character hit at the specified position (in font coordinate space).

This method generates caret information for a given insertion point in the layout text.

This method calculates a new insertion index, given a start index and the number of characters to skip. This is most useful for caret traveling.

This method generates a highlighting polygon from two insertion indices. This polygon will be visually continuous, i.e. will not have non-highlighted text in between.

This method generates a highlighting polygon from two insertion indices. This polygon will not always be visually continuous, if e.g. the text direction changes in the middle of the selection, the might be parts visually between start and end position that are not selected.

This method returns the baseline offset for this layout object, either measured from the top or the left edge, depending on the writing direction (horizontally or vertically). Since rendering this layout via XCanvas::drawTextLayout() outputs relative to the layout object's baseline, this method can be used to e.g. output relative to the left, top edge.

This method returns the main writing direction of this layout, i.e. either LEFT_TO_RIGHT or RIGHT_TO_LEFT.