DragonFly On-Line Manual Pages

FcFontSort(3)                                                    FcFontSort(3)

NAME
       FcFontSort - Return list of matching fonts

SYNOPSIS
       #include <fontconfig/fontconfig.h>

       FcFontSet * FcFontSort (FcConfig *config, FcPattern *p, FcBool trim, 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 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.

Fontconfig 2.14.2                27 1<?> 2023                    FcFontSort(3)