FcFontSort - Return list of matching fonts
#include <fontconfig/fontconfig.h>
FcFontSet * FcFontSort (FcConfig *
config, FcPattern *p,
FcBool trim, FcCharSet **csp, FcResult
*result );
Returns the list of fonts sorted by closeness to
p. If
trim is
FcTrue, elements in the list which don't include Unicode coverage not provided
by earlier elements in the list are elided. The union of Unicode coverage of
all of the fonts is returned in
csp, if
csp is not NULL. This
function should be called only after FcConfigSubstitute and
FcDefaultSubstitute have been called for
p; otherwise the results will
not be correct.
The returned FcFontSet references FcPattern structures which may be shared by
the return value from multiple FcFontSort calls, applications must not modify
these patterns. Instead, they should be passed, along with
p to
FcFontRenderPrepare which combines them into a complete pattern.
The FcFontSet returned by FcFontSort is destroyed by calling FcFontSetDestroy.
If
config is NULL, the current configuration is used.