1FcFontSort(3)                                                    FcFontSort(3)
2
3
4

NAME

6       FcFontSort - Return list of matching fonts
7

SYNOPSIS

9       #include <fontconfig.h>
10
11       FcFontSet * FcFontSort (FcConfig *config, FcPattern *p, FcBool trim, FcCharSet **csp, FcResult *result);
12

DESCRIPTION

14       Returns the list of fonts sorted by closeness to p.  If trim is FcTrue,
15       elements in the list which don't include Unicode coverage not  provided
16       by  earlier elements in the list are elided.  The union of Unicode cov‐
17       erage of all of the fonts is returned in csp, if csp is not NULL.  This
18       function  should be called only after FcConfigSubstitute and FcDefault‐
19       Substitute have been called for p; otherwise the results  will  not  be
20       correct.
21
22       The  returned  FcFontSet  references  FcPattern structures which may be
23       shared by the return value from multiple FcFontSort calls, applications
24       must  not modify these patterns.  Instead, they should be passed, along
25       with p to FcFontRenderPrepare which combines them into a complete  pat‐
26       tern.
27
28       The  FcFontSet returned by FcFontSort is destroyed by caling FcFontSet‐
29       Destroy.
30

VERSION

32       Fontconfig version 2.4.2
33
34
35
36                                  11 May 2007                    FcFontSort(3)