FcFontSetCreate
3
FcFontSetCreate
Create a font set
#include <fontconfig/fontconfig.h>
FcFontSet * FcFontSetCreate
void
Description
Creates an empty font set.
Version
Fontconfig version &version;
FcFontSetDestroy
3
FcFontSetDestroy
Destroy a font set
#include <fontconfig/fontconfig.h>
void FcFontSetDestroy
FcFontSet *s
Description
Destroys a font set. Note that this destroys any referenced patterns as
well.
Version
Fontconfig version &version;
FcFontSetAdd
3
FcFontSetAdd
Add to a font set
#include <fontconfig/fontconfig.h>
FcBool FcFontSetAdd
FcFontSet *s
FcPattern *font
Description
Adds a pattern to a font set. Note that the pattern is not copied before
being inserted into the set. Returns FcFalse if the pattern cannot be
inserted into the set (due to allocation failure). Otherwise returns FcTrue.
Version
Fontconfig version &version;
FcFontSetList
3
FcFontSetList
List fonts from a set of font sets
#include <fontconfig/fontconfig.h>
FcFontSet * FcFontSetList
FcConfig *config
FcFontSet **sets
intnsets
FcPattern *pattern
FcObjectSet *object_set
Description
Selects fonts matching pattern from
sets, creates patterns from those
fonts containing only the objects in object_set and returns
the set of unique such patterns.
If config is NULL, the default configuration is checked
to be up to date, and used.
Version
Fontconfig version &version;
FcFontSetMatch
3
FcFontSetMatch
Return the best font from a set of font sets
#include <fontconfig/fontconfig.h>
FcPattern * FcFontSetMatch
FcConfig *config
FcFontSet **sets
intnsets
FcPattern *pattern
FcResult *result
Description
Finds the font in sets most closely matching
pattern and returns the result of
FcFontRenderPrepare for that font and the provided
pattern. This function should be called only after
FcConfigSubstitute and
FcDefaultSubstitute have been called for
pattern; otherwise the results will not be correct.
If config is NULL, the current configuration is used.
Returns NULL if an error occurs during this process.
Version
Fontconfig version &version;
FcFontSetPrint
3
FcFontSetPrint
Print a set of patterns to stdout
#include <fontconfig/fontconfig.h>
void FcFontSetPrint
FcFontSet *set
Description
This function is useful for diagnosing font related issues, printing the
complete contents of every pattern in set. The format
of the output is designed to be of help to users and developers, and may
change at any time.
Version
Fontconfig version &version;
FcFontSetSort
3
FcFontSetSort
Add to a font set
#include <fontconfig/fontconfig.h>
FcFontSetSort
FcConfig *config
FcFontSet **sets
intnsets
FcPattern *pattern
FcBool trim
FcCharSet **csp
FcResult *result
Description
Returns the list of fonts from sets
sorted by closeness to pattern.
If trim is FcTrue,
elements in the list which don't include Unicode coverage not provided by
earlier elements in the list are elided. The union of Unicode coverage of
all of the fonts is returned in csp,
if csp is not NULL. This function
should be called only after FcConfigSubstitute and FcDefaultSubstitute have
been called for p;
otherwise the results will not be correct.
The returned FcFontSet references FcPattern structures which may be shared
by the return value from multiple FcFontSort calls, applications cannot
modify these patterns. Instead, they should be passed, along with
pattern to
FcFontRenderPrepare which combines them into a complete pattern.
The FcFontSet returned by FcFontSetSort is destroyed by calling FcFontSetDestroy.
Version
Fontconfig version &version;
FcFontSetSortDestroy
3
FcFontSetSortDestroy
DEPRECATED destroy a font set
#include <fontconfig/fontconfig.h>
FcFontSetSortDestroy
FcFontSet *set
Description
This function is DEPRECATED. FcFontSetSortDestroy
destroys set by calling
FcFontSetDestroy. Applications should use
FcFontSetDestroy directly instead.
Version
Fontconfig version &version;