Section 3: library functions
FcConfigSubstitute – Execute substitutions Synopsis #include <fontconfig/fontconfig.h> FcBool FcConfigSubstitute (FcConfig *config, FcPattern *p, FcMatchKind kind); Description Calls FcConfigSubstituteWithPat setting p_pat to NULL. Returns FcFalse if the substitution cannot be performed (due to allocation failure). Otherwise returns FcTrue. If config is NULL, the current configuration is used.
FcConfigSetSysRoot – Set the system root directory Synopsis #include <fontconfig/fontconfig.h> void FcConfigSetSysRoot (FcConfig *config, const FcChar8 *sysroot); Description Set ‘sysroot’ as the system root directory. fontconfig prepend ‘sysroot’ to the cache directories in order to allow people to generate caches at the build time. Note that this causes changing current config. i.e. this function calls…
FcConfigSetRescanInterval – Set config rescan interval Synopsis #include <fontconfig/fontconfig.h> FcBool FcConfigSetRescanInterval (FcConfig *config, int rescanInterval); Description Sets the rescan interval. Returns FcFalse if the interval cannot be set (due to allocation failure). Otherwise returns FcTrue. An interval setting of zero disables automatic checks. If config is NULL, the current configuration is used.
FcConfigSetCurrent – Set configuration as default Synopsis #include <fontconfig/fontconfig.h> FcBool FcConfigSetCurrent (FcConfig *config); Description Sets the current default configuration to config. Implicitly calls FcConfigBuildFonts if necessary, and FcConfigReference() to inrease the reference count in config since 2.12.0, returning FcFalse if that call fails.
FcConfigReference – Increment config reference count Synopsis #include <fontconfig/fontconfig.h> FcConfig * FcConfigReference (FcConfig *config); Description Add another reference to config. Configs are freed only when the reference count reaches zero. If config is NULL, the current configuration is used. In that case this function will be similar to FcConfigGetCurrent() except that it increments the reference…
FcConfigParseAndLoadFromMemory – load a configuration from memory Synopsis #include <fontconfig/fontconfig.h> FcBool FcConfigParseAndLoadFromMemory (FcConfig *config, const FcChar8 *buffer, FcBool complain); Description Walks the configuration in ‘memory’ and constructs the internal representation in ‘config’. Any includes files referenced from within ‘memory’ will be loaded and dparsed. If ‘complain’ is FcFalse, no warning will be displayed if ‘file’…
FcConfigParseAndLoad – load a configuration file Synopsis #include <fontconfig/fontconfig.h> FcBool FcConfigParseAndLoad (FcConfig *config, const FcChar8 *file, FcBool complain); Description Walks the configuration in ‘file’ and constructs the internal representation in ‘config’. Any include files referenced from within ‘file’ will be loaded and parsed. If ‘complain’ is FcFalse, no warning will be displayed if ‘file’ does…
FcConfigHome – return the current home directory. Synopsis #include <fontconfig/fontconfig.h> FcChar8 * FcConfigHome (void); Description Return the current user’s home directory, if it is available, and if using it is enabled, and NULL otherwise. See also FcConfigEnableHome).
FcConfigGetSysRoot – Obtain the system root directory Synopsis #include <fontconfig/fontconfig.h> const FcChar8 * FcConfigGetSysRoot (const FcConfig *config); Description Obtrains the system root directory in ‘config’ if available. Since version 2.10.92
FcConfigGetRescanInterval – Get config rescan interval Synopsis #include <fontconfig/fontconfig.h> int FcConfigGetRescanInterval (FcConfig *config); Description Returns the interval between automatic checks of the configuration (in seconds) specified in config. The configuration is checked during a call to FcFontList when this interval has passed since the last check. An interval setting of zero disables automatic checks. If…
FcConfigGetFonts – Get config font set Synopsis #include <fontconfig/fontconfig.h> FcFontSet * FcConfigGetFonts (FcConfig *config, FcSetName set); Description Returns one of the two sets of fonts from the configuration as specified by set. This font set is owned by the library and must not be modified or freed. If config is NULL, the current configuration is…
FcConfigGetFontDirs – Get font directories Synopsis #include <fontconfig/fontconfig.h> FcStrList * FcConfigGetFontDirs (FcConfig *config); Description Returns the list of font directories in config. This includes the configured font directories along with any directories below those in the filesystem. If config is NULL, the current configuration is used.
FcConfigGetCurrent – Return current configuration Synopsis #include <fontconfig/fontconfig.h> FcConfig * FcConfigGetCurrent (void); Description Returns the current default configuration.
FcConfigGetConfigFiles – Get config files Synopsis #include <fontconfig/fontconfig.h> FcStrList * FcConfigGetConfigFiles (FcConfig *config); Description Returns the list of known configuration files used to generate config. If config is NULL, the current configuration is used.
FcConfigGetConfigDirs – Get config directories Synopsis #include <fontconfig/fontconfig.h> FcStrList * FcConfigGetConfigDirs (FcConfig *config); Description Returns 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); Description FcConfigGetCacheDirs 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); Description With 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); Description FcBlanks is deprecated. This function always returns NULL.
FcConfigFilename – Find a config file Synopsis #include <fontconfig/fontconfig.h> FcChar8 * FcConfigFilename (const FcChar8 *name); Description Given 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…
FcConfigFileInfoIterNext – Set the iterator to point to the next list Synopsis #include <fontconfig/fontconfig.h> FcBool FcConfigFileInfoIterNext (FcConfig *config, FcConfigFileInfoIter *iter); Description Set ‘iter’ to point to the next node in the config file information list. If there is no next node, FcFalse is returned. Since version 2.12.91