Name
pcontext:GetSerial -- get serial of context
Synopsis
s = pcontext:GetSerial()
Function
Returns the current serial number of the context.

The serial number is initialized to an small number larger than zero when a new context is created and is increased whenever the context is changed using any of the setter functions, or the Pango font map it uses to find fonts has changed. The serial may wrap, but will never have the value 0. Since it can wrap, never compare it with "less than", always use "not equals".

This can be used to automatically detect changes to a Pango context, and is only useful when implementing objects that need update when their Pango context changes, like Pango layout.

Inputs
none

Results
s
the current serial number of the context

Show TOC