pango-context-metrics (context desc language)

context -- a pango-context object
desc -- a pango-font-description instance, nil means that the font description from the context will be used
language -- language tag of type pango-language used to determine which script to get the metrics for, nil means that the language tag from the context will be used, if no language tag is set on the context, metrics for the default language, as determined by the function pango-language-default, will be returned

A pango-font-metrics instance. The caller must call the function pango-font-metrics-unref when finished using the object.

Get overall metric information for a particular font description. Since the metrics may be substantially different for different scripts, a language tag can be provided to indicate that the metrics should be retrieved that correspond to the script(s) used by that language.

The pango-font-description instance is interpreted in the same way as by the function pango-itemize, and the family name may be a comma separated list of figures. If characters from multiple of these families would be used to render the string, then the returned fonts would be a composite of the metrics for the fonts loaded for the individual families.