Section 3: library functions
FcPatternIterEqual – Compare iterators Synopsis #include <fontconfig/fontconfig.h> FcBool FcPatternIterEqual (const FcPattern *p1, FcPatternIter *i1, const FcPattern *p2, FcPatternIter *i2); Description Return FcTrue if both i1 and i2 point to same object and contains same values. return FcFalse otherwise. Since version 2.13.1
FcPatternHash – Compute a pattern hash value Synopsis #include <fontconfig/fontconfig.h> FcChar32 FcPatternHash (const FcPattern *p); Description Returns a 32-bit number which is the same for any two patterns which are equal.
FcPatternGetWithBinding – Return a value with binding from a pattern Synopsis #include <fontconfig/fontconfig.h> FcResult FcPatternGetWithBinding (FcPattern *p, const char *object, int id, FcValue *v, FcValueBinding *b); Description Returns in v the id‘th value and b binding for that associated with the property object. The Value returned is not a copy, but rather refers to the…
FcPatternGet – Return a value from a pattern Synopsis #include <fontconfig/fontconfig.h> FcResult FcPatternGet (FcPattern *p, const char *object, int id, FcValue *v); Description Returns in v the id‘th value associated with the property object. The value returned is not a copy, but rather refers to the data stored within the pattern directly. Applications must not…
FcPatternGetInteger, FcPatternGetDouble, FcPatternGetString, FcPatternGetMatrix, FcPatternGetCharSet, FcPatternGetBool, FcPatternGetFTFace, FcPatternGetLangSet, FcPatternGetRange – Return a typed value from a pattern Synopsis #include <fontconfig/fontconfig.h> FcResult FcPatternGetInteger (FcPattern *p, const char *object, int n, int *i); FcResult FcPatternGetDouble (FcPattern *p, const char *object, int n, double *d); FcResult FcPatternGetString (FcPattern *p, const char *object, int n, FcChar8 **s); FcResult FcPatternGetMatrix…
FcPatternFormat – Format a pattern into a string according to a format specifier Synopsis #include <fontconfig/fontconfig.h> FcChar8 * FcPatternFormat (FcPattern *pat, const FcChar8 *format); Description Converts given pattern pat into text described by the format specifier format. The return value refers to newly allocated memory which should be freed by the caller using free(), or…
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); Description Set iter to point to object in p if any and returns FcTrue. returns FcFalse otherwise. Since version 2.13.1
FcPatternFilter – Filter the objects of pattern Synopsis #include <fontconfig/fontconfig.h> FcPattern * FcPatternFilter (FcPattern *p, const FcObjectSet *); Description Returns 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); Description Returns 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); Description Returns whether pa and pb are exactly alike.
FcPatternDuplicate – Copy a pattern Synopsis #include <fontconfig/fontconfig.h> FcPattern * FcPatternDuplicate (const FcPattern *p); Description Copy 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); Description Decrement 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); Description Deletes 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); Description Creates 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); Description Builds a pattern using a list of objects, types and values. Each value to be entered in the pattern is specified with…
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); Description FcPatternAddWeak 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); Description Adds 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…
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,…
FcObjectSetDestroy – Destroy an object set Synopsis #include <fontconfig/fontconfig.h> void FcObjectSetDestroy (FcObjectSet *os); Description Destroys an object set.
FcObjectSetCreate – Create an object set Synopsis #include <fontconfig/fontconfig.h> FcObjectSet * FcObjectSetCreate (void); Description Creates an empty set.