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.

---

Free and Open Source Software