Name
playout:GetLine -- get line
Synopsis
handle = playout:GetLine(line)
Function
Retrieves a particular line from a Pango layout.

Use the faster playout:GetLineReadonly() if you do not plan to modify the contents of the line (glyphs, glyph widths, etc.).

This function returns the requested Pango layout line, or a NULL object if the index is out of range. The returned Pango layout line is owned by the layout and mustn't be freed. It can be ref'ed and retained, but will become invalid if changes are made to the Pango layout.

Inputs
line
the index of a line, which must be between 0 and the number of lines in the layout minus one
Results
handle
a Pango layout line object

Show TOC