Name
playout:GetLineReadonly -- get layout line in read-only mode
Synopsis
handle = playout:GetLineReadonly(line)
Function
Retrieves a particular line from a Pango layout.

This is a faster alternative to playout:GetLine(), but the user is not expected 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