Section 3: library functions
FcConfigFileInfoIterInit – Initialize the iterator Synopsis #include <fontconfig/fontconfig.h> void FcConfigFileInfoIterInit (FcConfig *config, FcConfigFileInfoIter *iter); Description Initialize ‘iter’ with the first iterator in the config file information list. Since version 2.12.91
FcConfigFileInfoIterGet – Obtain the configuration file information Synopsis #include <fontconfig/fontconfig.h> FcBool FcConfigFileInfoIterGet (FcConfig *config, FcConfigFileInfoIter *iter, FcChar8 **name, FcChar8 **description, FcBool *enabled); Description Obtain the filename, the description and the flag whether it is enabled or not for ‘iter’ where points to current configuration file information. If the iterator is invalid, FcFalse is returned. Since…
FcConfigEnableHome – controls use of the home directory. Synopsis #include <fontconfig/fontconfig.h> FcBool FcConfigEnableHome (FcBool enable); Description If enable is FcTrue, then Fontconfig will use various files which are specified relative to the user’s home directory (using the ~ notation in the configuration). When enable is FcFalse, then all use of the home directory in these…
FcConfigDestroy – Destroy a configuration Synopsis #include <fontconfig/fontconfig.h> void FcConfigDestroy (FcConfig *config); Description Decrements the config reference count. If all references are gone, destroys the configuration and any data associated with it. Note that calling this function with the return from FcConfigGetCurrent will cause a new configuration to be created for use as current configuration.
FcConfigCreate – Create a configuration Synopsis #include <fontconfig/fontconfig.h> FcConfig * FcConfigCreate (void); Description Creates an empty configuration.
FcConfigBuildFonts – Build font database Synopsis #include <fontconfig/fontconfig.h> FcBool FcConfigBuildFonts (FcConfig *config); Description Builds the set of available fonts for the given configuration. Note that any changes to the configuration after this call have indeterminate effects. Returns FcFalse if this operation runs out of memory. If config is NULL, the current configuration is used.
FcConfigAppFontClear – Remove all app fonts from font database Synopsis #include <fontconfig/fontconfig.h> void FcConfigAppFontClear (FcConfig *config); Description Clears the set of application-specific fonts. If config is NULL, the current configuration is used.
FcConfigAppFontAddFile – Add font file to font database Synopsis #include <fontconfig/fontconfig.h> FcBool FcConfigAppFontAddFile (FcConfig *config, const FcChar8 *file); Description Adds an application-specific font to the configuration. Returns FcFalse if the fonts cannot be added (due to allocation failure or no fonts found). Otherwise returns FcTrue. If config is NULL, the current configuration is used.
FcConfigAppFontAddDir – Add fonts from directory to font database Synopsis #include <fontconfig/fontconfig.h> FcBool FcConfigAppFontAddDir (FcConfig *config, const FcChar8 *dir); Description Scans the specified directory for fonts, adding each one found to the application-specific set of fonts. Returns FcFalse if the fonts cannot be added (due to allocation failure). Otherwise returns FcTrue. If config is NULL,…
FcCharSetUnion – Add charsets Synopsis #include <fontconfig/fontconfig.h> FcCharSet * FcCharSetUnion (const FcCharSet *a, const FcCharSet *b); Description Returns a set including only those chars found in either a or b.
FcCharSetSubtractCount – Subtract and count charsets Synopsis #include <fontconfig/fontconfig.h> FcChar32 FcCharSetSubtractCount (const FcCharSet *a, const FcCharSet *b); Description Returns the number of chars that are in a but not in b.
FcCharSetSubtract – Subtract charsets Synopsis #include <fontconfig/fontconfig.h> FcCharSet * FcCharSetSubtract (const FcCharSet *a, const FcCharSet *b); Description Returns a set including only those chars found in a but not b.
FcCharSetNextPage – Continue enumerating charset contents Synopsis #include <fontconfig/fontconfig.h> FcChar32 FcCharSetNextPage (const FcCharSet *a, FcChar32[FC_CHARSET_MAP_SIZE] map, FcChar32 *next); Description Builds an array of bits in map marking the Unicode coverage of a for page containing *next (see the FcCharSetFirstPage description for details). *next is set to contains the base code point for the next page…
FcCharSetNew – DEPRECATED alias for FcCharSetCreate Synopsis #include <fontconfig/fontconfig.h> FcCharSet * FcCharSetNew (void); Description FcCharSetNew is a DEPRECATED alias for FcCharSetCreate.
FcCharSetMerge – Merge charsets Synopsis #include <fontconfig/fontconfig.h> FcBool FcCharSetMerge (FcCharSet *a, const FcCharSet *b, FcBool *changed); Description Adds all chars in b to a. In other words, this is an in-place version of FcCharSetUnion. If changed is not NULL, then it returns whether any new chars from b were added to a. Returns FcFalse on…
FcCharSetIsSubset – Test for charset inclusion Synopsis #include <fontconfig/fontconfig.h> FcBool FcCharSetIsSubset (const FcCharSet *a, const FcCharSet *b); Description Returns whether a is a subset of b.
FcCharSetIntersectCount – Intersect and count charsets Synopsis #include <fontconfig/fontconfig.h> FcChar32 FcCharSetIntersectCount (const FcCharSet *a, const FcCharSet *b); Description Returns the number of chars that are in both a and b.
FcCharSetIntersect – Intersect charsets Synopsis #include <fontconfig/fontconfig.h> FcCharSet * FcCharSetIntersect (const FcCharSet *a, const FcCharSet *b); Description Returns a set including only those chars found in both a and b.
FcCharSetHasChar – Check a charset for a char Synopsis #include <fontconfig/fontconfig.h> FcBool FcCharSetHasChar (const FcCharSet *fcs, FcChar32 ucs4); Description Returns whether fcs contains the char ucs4.
FcCharSetFirstPage – Start enumerating charset contents Synopsis #include <fontconfig/fontconfig.h> FcChar32 FcCharSetFirstPage (const FcCharSet *a, FcChar32[FC_CHARSET_MAP_SIZE] map, FcChar32 *next); Description Builds an array of bits in map marking the first page of Unicode coverage of a. *next is set to contains the base code point for the next page in a. Returns the base code point…