Section 3: library functions
FcConfigFileInfoIterNext – Set the iterator to point to the next list Synopsis#include <fontconfig/fontconfig.h> FcBool FcConfigFileInfoIterNext (FcConfig *config, FcConfigFileInfoIter *iter); DescriptionSet ‘iter’ to point to the next node in the config file information list. If there is no next node, FcFalse is returned. Sinceversion 2.12.91
FcConfigFileInfoIterInit – Initialize the iterator Synopsis#include <fontconfig/fontconfig.h> void FcConfigFileInfoIterInit (FcConfig *config, FcConfigFileInfoIter *iter); DescriptionInitialize ‘iter’ with the first iterator in the config file information list. Sinceversion 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); DescriptionObtain 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. Sinceversion 2.12.91
FcConfigEnableHome – controls use of the home directory. Synopsis#include <fontconfig/fontconfig.h> FcBool FcConfigEnableHome (FcBool enable); DescriptionIf 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 contexts will…
FcConfigDestroy – Destroy a configuration Synopsis#include <fontconfig/fontconfig.h> void FcConfigDestroy (FcConfig *config); DescriptionDecrements 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); DescriptionCreates an empty configuration.
FcConfigBuildFonts – Build font database Synopsis#include <fontconfig/fontconfig.h> FcBool FcConfigBuildFonts (FcConfig *config); DescriptionBuilds 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); DescriptionClears 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); DescriptionAdds 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); DescriptionScans 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, the current…
FcCharSetUnion – Add charsets Synopsis#include <fontconfig/fontconfig.h> FcCharSet * FcCharSetUnion (const FcCharSet *a, const FcCharSet *b); DescriptionReturns 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); DescriptionReturns 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); DescriptionReturns 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); DescriptionBuilds 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 in a….
FcCharSetNew – DEPRECATED alias for FcCharSetCreate Synopsis#include <fontconfig/fontconfig.h> FcCharSet * FcCharSetNew (void); DescriptionFcCharSetNew is a DEPRECATED alias for FcCharSetCreate.
FcCharSetMerge – Merge charsets Synopsis#include <fontconfig/fontconfig.h> FcBool FcCharSetMerge (FcCharSet *a, const FcCharSet *b, FcBool *changed); DescriptionAdds 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 failure, either…
FcCharSetIsSubset – Test for charset inclusion Synopsis#include <fontconfig/fontconfig.h> FcBool FcCharSetIsSubset (const FcCharSet *a, const FcCharSet *b); DescriptionReturns 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); DescriptionReturns 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); DescriptionReturns 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); DescriptionReturns whether fcs contains the char ucs4.