Name
playoutiter:GetRunReadonly -- get current run for read-only access
Synopsis
handle = playoutiter:GetRunReadonly()
Function
Gets the current run for read-only access. The run is returned as a Pango glyph item object and it mustn't be freed.

When iterating by run, at the end of each line, there's a position with a NULL run, so this function can return a NULL object. The NULL run at the end of each line ensures that all lines have at least one run, even lines consisting of only a newline. You can use pglyphitem:IsNull() to check if a glyph item is NULL.

This is a faster alternative to playoutiter:GetRun(), but the user is not expected to modify the contents of the run (glyphs, glyph widths, etc.).

Inputs
none

Results
handle
the current run as a Pango glyph item
Show TOC