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

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

This function never returns Nil. If memory cannot be allocated, a special "nil" scaled font object will be returned on which cscaledfont: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:SetScaledFont() with a Nil font will trigger an error that will shutdown the Cairo context object.

Inputs
none

Results
font
the current scaled font (owned by Cairo)

Show TOC