Package: pango

Function pango-cairo-font-map-default

Lambda List

pango-cairo-font-map-default ()

Syntax

(pango-cairo-font-map-default) => fontmap
(setf (pango-cairo-font-map-default) fontmap)

Arguments

fontmap -- a pango-font-map object, or nil

Details

The function pango-cairo-font-map-default gets a default PangoCairo font map to use with Cairo. Note that the type of the returned object will depend on the particular font backend Cairo was compiled to use. You generally should only use the PangoFontMap and PangoCairoFontMap interfaces on the returned object.

The function (setf pango-cairo-font-map-default) sets a default PangoCairo font map to use with Cairo.

This can be used to change the Cairo font backend that the default font map uses for example. The old default font map is unreffed and the new font map referenced.

Note that since Pango 1.32, the default font map is per-thread. This function only changes the default fontmap for the current thread. Default fontmaps of exisiting threads are not changed. Default fontmaps of any new threads will still be created using the function pango-cairo-font-map-new.

A value of nil for fontmap will cause the current default font map to be released and a new default font map to be created on demand, using the function pango-cairo-font-map-new.
 

See also

2021-1-5