FcFontSort(3)FcFontSort(3)NAMEFcFontSort - Return list of matching fonts
SYNOPSIS
#include <fontconfig.h>
FcFontSet * FcFontSort (FcConfig *config, FcPattern *p,
FcBooltrim, FcCharSet **csp, FcResult *result);
DESCRIPTION
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 pat-
terns. 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 cal-
ing FcFontSetDestroy.
VERSION
Fontconfig version 2.2.0
21 April 2003 FcFontSort(3)