FcPatternCreate 3 FcPatternCreate Create a pattern #include <fontconfig/fontconfig.h> FcPattern * FcPatternCreate void Creates a pattern with no properties; used to build patterns from scratch. Fontconfig version &version; FcPatternDuplicate 3 FcPatternDuplicate Copy a pattern #include <fontconfig/fontconfig.h> FcPattern * FcPatternDuplicate const FcPattern *p Copy a pattern, returning a new pattern that matches p. Each pattern may be modified without affecting the other. Fontconfig version &version; FcPatternReference 3 FcPatternReference Increment pattern reference count #include <fontconfig/fontconfig.h> void FcPatternReference FcPattern *p Add another reference to p. Patterns are freed only when the reference count reaches zero. Fontconfig version &version; FcPatternDestroy 3 FcPatternDestroy Destroy a pattern #include <fontconfig/fontconfig.h> void FcPatternDestroy FcPattern *p Decrement the pattern reference count. If all references are gone, destroys the pattern, in the process destroying all related values. Fontconfig version &version; FcPatternEqual 3 FcPatternEqual Compare patterns #include <fontconfig/fontconfig.h> FcBool FcPatternEqual const FcPattern *pa const FcPattern *pb Returns whether pa and pb are exactly alike. Fontconfig version &version; FcPatternEqualSubset 3 FcPatternEqualSubset Compare portions of patterns #include <fontconfig/fontconfig.h> FcBool FcPatternEqualSubset const FcPattern *pa const FcPattern *pb const FcObjectSet *os Returns whether pa and pb have exactly the same values for all of the objects in os. Fontconfig version &version; FcPatternFilter 3 FcPatternFilter Filter the objects of pattern #include <fontconfig/fontconfig.h> FcPattern * FcPatternFilter FcPattern *p const FcObjectSet * 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. Fontconfig version &version; FcPatternHash 3 FcPatternHash Compute a pattern hash value #include <fontconfig/fontconfig.h> FcChar32 FcPatternHash const FcPattern *p Returns a 32-bit number which is the same for any two patterns which are equal. Fontconfig version &version; FcPatternAdd 3 FcPatternAdd Add a value to a pattern #include <fontconfig/fontconfig.h> FcBool FcPatternAdd FcPattern *p const char *object FcValue value FcBool append 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 is inserted at the beginning. `value' is saved (with FcValueSave) when inserted into the pattern so that the library retains no reference to any application-supplied data structure. Fontconfig version &version; FcPatternAddWeak 3 FcPatternAddWeak Add a value to a pattern with weak binding #include <fontconfig/fontconfig.h> FcBool FcPatternAddWeak FcPattern *p const char *object FcValue value FcBool append FcPatternAddWeak is essentially the same as FcPatternAdd except that any values added to the list have binding weak instead of strong. Fontconfig version &version; FcPatternAdd-Type 3 FcPatternAddInteger FcPatternAddDouble FcPatternAddString FcPatternAddMatrix FcPatternAddCharSet FcPatternAddBool FcPatternAddFTFace FcPatternAddLangSet Add a typed value to a pattern #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 FcMatrix *m FcBool FcPatternAddCharSet FcPattern *p const char *object const FcCharSet *c FcBool FcPatternAddBool FcPattern *p const char *object FcBool b FcBool FcPatternAddFTFace FcPattern *p const char *object const FT_Facef FcBool FcPatternAddLangSet FcPattern *p const char *object const FcLangSet *l These are all convenience functions that insert objects of the specified type into the pattern. Use these in preference to FcPatternAdd as they will provide compile-time typechecking. These all append values to any existing list of values. Fontconfig version &version; FcPatternGet 3 FcPatternGet Return a value from a pattern #include <fontconfig/fontconfig.h> FcResult FcPatternGet FcPattern *p const char *object int id FcValue *v 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 free this value. Fontconfig version &version; FcPatternGet-Type 3 FcPatternGetInteger FcPatternGetDouble FcPatternGetString FcPatternGetMatrix FcPatternGetCharSet FcPatternGetBool FcPatternGetFTFace FcPatternGetLangSet Return a typed value from a pattern #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 FcPattern *p const char *object int n FcMatrix **s FcResult FcPatternGetCharSet FcPattern *p const char *object int n FcCharSet **c FcResult FcPatternGetBool FcPattern *p const char *object int n FcBool *b FcResult FcPatternGetFTFace FcPattern *p const char *object int n FcResult FcPatternGetLangSet FcPattern *p const char *object FT_Face *f These are convenience functions that call FcPatternGet and verify that the returned data is of the expected type. They return FcResultTypeMismatch if this is not the case. Note that these (like FcPatternGet) do not make a copy of any data structure referenced by the return value. Use these in preference to FcPatternGet to provide compile-time typechecking. Fontconfig version &version; FcPatternBuild 3 FcPatternBuild FcPatternVaBuild FcPatternVapBuild Create patterns from arguments #include <fontconfig/fontconfig.h> FcPattern * FcPatternBuild FcPattern *pattern ... FcPattern * FcPatternVaBuild FcPattern *pattern va_list va void FcPatternVapBuild FcPattern *result FcPattern *pattern va_list va Builds a pattern using a list of objects, types and values. Each value to be entered in the pattern is specified with three arguments: Object name, a string describing the property to be added. Object type, one of the FcType enumerated values Value, not an FcValue, but the raw type as passed to any of the FcPatternAdd<type> functions. Must match the type of the second argument. The argument list is terminated by a null object name, no object type nor value need be passed for this. The values are added to `pattern', if `pattern' is null, a new pattern is created. In either case, the pattern is returned. Example pattern = FcPatternBuild (0, FC_FAMILY, FcTypeString, "Times", (char *) 0); FcPatternVaBuild is used when the arguments are already in the form of a varargs value. FcPatternVapBuild is a macro version of FcPatternVaBuild which returns its result directly in the result variable. Fontconfig version &version; FcPatternDel 3 FcPatternDel Delete a property from a pattern #include <fontconfig/fontconfig.h> FcBool FcPatternDel FcPattern *p const char *object Deletes all values associated with the property `object', returning whether the property existed or not. Fontconfig version &version; FcPatternRemove 3 FcPatternRemove Remove one object of the specified type from the pattern #include <fontconfig/fontconfig.h> FcBool FcPatternRemove FcPattern *p const char *object int id Removes the value associated with the property `object' at position `id', returning whether the property existed and had a value at that position or not. Fontconfig version &version; FcPatternPrint 3 FcPatternPrint Print a pattern for debugging #include <fontconfig/fontconfig.h> void FcPatternPrint const FcPattern *p Prints an easily readable version of the pattern to stdout. There is no provision for reparsing data in this format, it's just for diagnostics and debugging. Fontconfig version &version; FcDefaultSubstitute 3 FcDefaultSubstitute Perform default substitutions in a pattern #include <fontconfig/fontconfig.h> void FcDefaultSubstitute FcPattern *pattern Supplies default values for underspecified font patterns: Patterns without a specified style or weight are set to Medium Patterns without a specified style or slant are set to Roman Patterns without a specified pixel size are given one computed from any specified point size (default 12), dpi (default 75) and scale (default 1). Fontconfig version &version; FcNameParse 3 FcNameParse Parse a pattern string #include <fontconfig/fontconfig.h> FcPattern * FcNameParse const FcChar8 *name Converts name from the standard text format described above into a pattern. Fontconfig version &version; FcNameUnparse 3 FcNameUnparse Convert a pattern back into a string that can be parsed #include <fontconfig/fontconfig.h> FcChar8 * FcNameUnparse FcPattern *pat Converts 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(). Fontconfig version &version;