Section 3: library functions
FcPatternFindIter – Set the iterator to point to the object in the pattern Synopsis#include <fontconfig/fontconfig.h> FcBool FcPatternFindIter (const FcPattern *p, FcPatternIter *iter, const char *object); DescriptionSet iter to point to object in p if any and returns FcTrue. returns FcFalse otherwise. Sinceversion 2.13.1
FcPatternFilter – Filter the objects of pattern Synopsis#include <fontconfig/fontconfig.h> FcPattern * FcPatternFilter (FcPattern *p, const FcObjectSet *); DescriptionReturns a new pattern that only has those objects from p that are in os. If os is NULL, a duplicate of p is returned.
FcPatternEqualSubset – Compare portions of patterns Synopsis#include <fontconfig/fontconfig.h> FcBool FcPatternEqualSubset (const FcPattern *pa, const FcPattern *pb, const FcObjectSet *os); DescriptionReturns whether pa and pb have exactly the same values for all of the objects in os.
FcPatternEqual – Compare patterns Synopsis#include <fontconfig/fontconfig.h> FcBool FcPatternEqual (const FcPattern *pa, const FcPattern *pb); DescriptionReturns whether pa and pb are exactly alike.
FcPatternDuplicate – Copy a pattern Synopsis#include <fontconfig/fontconfig.h> FcPattern * FcPatternDuplicate (const FcPattern *p); DescriptionCopy a pattern, returning a new pattern that matches p. Each pattern may be modified without affecting the other.
FcPatternDestroy – Destroy a pattern Synopsis#include <fontconfig/fontconfig.h> void FcPatternDestroy (FcPattern *p); DescriptionDecrement the pattern reference count. If all references are gone, destroys the pattern, in the process destroying all related values.
FcPatternDel – Delete a property from a pattern Synopsis#include <fontconfig/fontconfig.h> FcBool FcPatternDel (FcPattern *p, const char *object); DescriptionDeletes all values associated with the property `object’, returning whether the property existed or not.
FcPatternCreate – Create a pattern Synopsis#include <fontconfig/fontconfig.h> FcPattern * FcPatternCreate (void); DescriptionCreates a pattern with no properties; used to build patterns from scratch.
FcPatternBuild, FcPatternVaBuild, FcPatternVapBuild – Create patterns from arguments Synopsis#include <fontconfig/fontconfig.h> FcPattern * FcPatternBuild (FcPattern *pattern, …); FcPattern * FcPatternVaBuild (FcPattern *pattern, va_list va); void FcPatternVapBuild (FcPattern *result, FcPattern *pattern, va_list va); DescriptionBuilds a pattern using a list of objects, types and values. Each value to be entered in the pattern is specified with three arguments:…
FcPatternAddWeak – Add a value to a pattern with weak binding Synopsis#include <fontconfig/fontconfig.h> FcBool FcPatternAddWeak (FcPattern *p, const char *object, FcValue value, FcBool append); DescriptionFcPatternAddWeak is essentially the same as FcPatternAdd except that any values added to the list have binding weak instead of strong.
FcPatternAdd – Add a value to a pattern Synopsis#include <fontconfig/fontconfig.h> FcBool FcPatternAdd (FcPattern *p, const char *object, FcValue value, FcBool append); DescriptionAdds a single value to the list of values associated with the property named `object. If `append is FcTrue, the value is added at the end of any existing list, otherwise it is inserted…
FcPatternAddInteger, FcPatternAddDouble, FcPatternAddString, FcPatternAddMatrix, FcPatternAddCharSet, FcPatternAddBool, FcPatternAddFTFace, FcPatternAddLangSet, FcPatternAddRange – Add a typed value to a pattern Synopsis#include <fontconfig/fontconfig.h> FcBool FcPatternAddInteger (FcPattern *p, const char *object, int i); FcBool FcPatternAddDouble (FcPattern *p, const char *object, double d); FcBool FcPatternAddString (FcPattern *p, const char *object, const FcChar8 *s); FcBool FcPatternAddMatrix (FcPattern *p, const char *object, const…
FcObjectSetDestroy – Destroy an object set Synopsis#include <fontconfig/fontconfig.h> void FcObjectSetDestroy (FcObjectSet *os); DescriptionDestroys an object set.
FcObjectSetCreate – Create an object set Synopsis#include <fontconfig/fontconfig.h> FcObjectSet * FcObjectSetCreate (void); DescriptionCreates an empty set.
FcObjectSetBuild, FcObjectSetVaBuild, FcObjectSetVapBuild – Build object set from args Synopsis#include <fontconfig/fontconfig.h> FcObjectSet * FcObjectSetBuild (const char *first, …); FcObjectSet * FcObjectSetVaBuild (const char *first, va_list va); void FcObjectSetVapBuild (FcObjectSet *result, const char *first, va_list va); DescriptionThese build an object set from a null-terminated list of property names. FcObjectSetVapBuild is a macro version of FcObjectSetVaBuild which…
FcObjectSetAdd – Add to an object set Synopsis#include <fontconfig/fontconfig.h> FcBool FcObjectSetAdd (FcObjectSet *os, const char *object); DescriptionAdds a property name to the set. Returns FcFalse if the property name cannot be inserted into the set (due to allocation failure). Otherwise returns FcTrue.
FcNameUnregisterObjectTypes – Unregister object types Synopsis#include <fontconfig/fontconfig.h> FcBool FcNameUnregisterObjectTypes (const FcObjectType *types, int ntype); DescriptionDeprecated. Does nothing. Returns FcFalse.
FcNameUnregisterConstants – Unregister symbolic constants Synopsis#include <fontconfig/fontconfig.h> FcBool FcNameUnregisterConstants (const FcConstant *consts, int nconsts); DescriptionDeprecated. Does nothing. Returns FcFalse.
FcNameUnparse – Convert a pattern back into a string that can be parsed Synopsis#include <fontconfig/fontconfig.h> FcChar8 * FcNameUnparse (FcPattern *pat); DescriptionConverts the given pattern into the standard text format described above. The return value is not static, but instead refers to newly allocated memory which should be freed by the caller using free().
FcNameRegisterObjectTypes – Register object types Synopsis#include <fontconfig/fontconfig.h> FcBool FcNameRegisterObjectTypes (const FcObjectType *types, int ntype); DescriptionDeprecated. Does nothing. Returns FcFalse.