Section 3: library functions
FcConfigGetConfigDirs – Get config directories Synopsis#include <fontconfig/fontconfig.h> FcStrList * FcConfigGetConfigDirs (FcConfig *config); DescriptionReturns the list of font directories specified in the configuration files for config. Does not include any subdirectories. If config is NULL, the current configuration is used.
FcConfigGetCacheDirs – return the list of directories searched for cache files Synopsis#include <fontconfig/fontconfig.h> FcStrList * FcConfigGetCacheDirs (const FcConfig *config); DescriptionFcConfigGetCacheDirs returns a string list containing all of the directories that fontconfig will search when attempting to load a cache file for a font directory. If config is NULL, the current configuration is used.
FcConfigGetCache – DEPRECATED used to return per-user cache filename Synopsis#include <fontconfig/fontconfig.h> FcChar8 * FcConfigGetCache (FcConfig *config); DescriptionWith fontconfig no longer using per-user cache files, this function now simply returns NULL to indicate that no per-user file exists.
FcConfigGetBlanks – Get config blanks Synopsis#include <fontconfig/fontconfig.h> FcBlanks * FcConfigGetBlanks (FcConfig *config); DescriptionFcBlanks is deprecated. This function always returns NULL.
FcConfigFilename – Find a config file Synopsis#include <fontconfig/fontconfig.h> FcChar8 * FcConfigFilename (const FcChar8 *name); DescriptionGiven the specified external entity name, return the associated filename. This provides applications a way to convert various configuration file references into filename form. A null or empty name indicates that the default configuration file should be used; which file this…
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.