Name
ccontext:GetFontFace -- get current font face
Synopsis
face = ccontext:GetFontFace()
Function
Gets the current font face for a Cairo context.

This function returns the current font face. This object is owned by Cairo. To keep a reference to it, you must call cfontface:Reference().

This function never returns Nil. If memory cannot be allocated, a special Nil font face object will be returned on which cfontface:Status() returns #CAIRO_STATUS_NO_MEMORY. Using this Nil object will cause its error state to propagate to other objects it is passed to, for example, calling ccontext:SetFontFace() with a Nil font will trigger an error that will shutdown the Cairo context object.

Inputs
none

Results
face
the current font face

Show TOC