Fontconfig Developers Reference, Version 2.10.91 Copyright © 2002 Keith Packard Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation, and that the name of the author(s) not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission. The authors make no representations about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty. THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. ------------------------------------------------------- Table of Contents [1]DESCRIPTION [2]FUNCTIONAL OVERVIEW [3]Datatypes [4]FUNCTIONS DESCRIPTION Fontconfig is a library designed to provide system-wide font configuration, customization and application access. -------------------------------------------------------------------------- FUNCTIONAL OVERVIEW Fontconfig contains two essential modules, the configuration module which builds an internal configuration from XML files and the matching module which accepts font patterns and returns the nearest matching font. -------------------------------------------------------------------------- FONT CONFIGURATION The configuration module consists of the FcConfig datatype, libexpat and FcConfigParse which walks over an XML tree and amends a configuration with data found within. From an external perspective, configuration of the library consists of generating a valid XML tree and feeding that to FcConfigParse. The only other mechanism provided to applications for changing the running configuration is to add fonts and directories to the list of application-provided font files. The intent is to make font configurations relatively static, and shared by as many applications as possible. It is hoped that this will lead to more stable font selection when passing names from one application to another. XML was chosen as a configuration file format because it provides a format which is easy for external agents to edit while retaining the correct structure and syntax. Font configuration is separate from font matching; applications needing to do their own matching can access the available fonts from the library and perform private matching. The intent is to permit applications to pick and choose appropriate functionality from the library instead of forcing them to choose between this library and a private configuration mechanism. The hope is that this will ensure that configuration of fonts for all applications can be centralized in one place. Centralizing font configuration will simplify and regularize font installation and customization. -------------------------------------------------------------------------- FONT PROPERTIES While font patterns may contain essentially any properties, there are some well known properties with associated types. Fontconfig uses some of these properties for font matching and font completion. Others are provided as a convenience for the application's rendering mechanism. Property Definitions Property C Preprocessor Symbol Type Description ---------------------------------------------------- family FC_FAMILY String Font family names familylang FC_FAMILYLANG String Language corresponding to each family name style FC_STYLE String Font style. Overrides weight and slant stylelang FC_STYLELANG String Language corresponding to each style name fullname FC_FULLNAME String Font face full name where different from family and family + style fullnamelang FC_FULLNAMELANG String Language corresponding to each fullname slant FC_SLANT Int Italic, oblique or roman weight FC_WEIGHT Int Light, medium, demibold, bold or black size FC_SIZE Double Point size width FC_WIDTH Int Condensed, normal or expanded aspect FC_ASPECT Double Stretches glyphs horizontally before hinting pixelsize FC_PIXEL_SIZE Double Pixel size spacing FC_SPACING Int Proportional, dual-width, monospace or charcell foundry FC_FOUNDRY String Font foundry name antialias FC_ANTIALIAS Bool Whether glyphs can be antialiased hinting FC_HINTING Bool Whether the rasterizer should use hinting hintstyle FC_HINT_STYLE Int Automatic hinting style verticallayout FC_VERTICAL_LAYOUT Bool Use vertical layout autohint FC_AUTOHINT Bool Use autohinter instead of normal hinter globaladvance FC_GLOBAL_ADVANCE Bool Use font global advance data (deprecated) file FC_FILE String The filename holding the font index FC_INDEX Int The index of the font within the file ftface FC_FT_FACE FT_Face Use the specified FreeType face object rasterizer FC_RASTERIZER String Which rasterizer is in use outline FC_OUTLINE Bool Whether the glyphs are outlines scalable FC_SCALABLE Bool Whether glyphs can be scaled scale FC_SCALE Double Scale factor for point->pixel conversions dpi FC_DPI Double Target dots per inch rgba FC_RGBA Int unknown, rgb, bgr, vrgb, vbgr, none - subpixel geometry lcdfilter FC_LCD_FILTER Int Type of LCD filter minspace FC_MINSPACE Bool Eliminate leading from line spacing charset FC_CHARSET CharSet Unicode chars encoded by the font lang FC_LANG LangSet Set of RFC-3066-style languages this font supports fontversion FC_FONTVERSION Int Version number of the font capability FC_CAPABILITY String List of layout capabilities in the font embolden FC_EMBOLDEN Bool Rasterizer should synthetically embolden the font namelang FC_NAMELANG String Language name to be used for the default value of familylang, stylelang and fullnamelang -------------------------------------------------------------------------- Datatypes Fontconfig uses abstract data types to hide internal implementation details for most data structures. A few structures are exposed where appropriate. -------------------------------------------------------------------------- FcChar8, FcChar16, FcChar32, FcBool These are primitive data types; the FcChar* types hold precisely the number of bits stated (if supported by the C implementation). FcBool holds one of two C preprocessor symbols: FcFalse or FcTrue. -------------------------------------------------------------------------- FcMatrix An FcMatrix holds an affine transformation, usually used to reshape glyphs. A small set of matrix operations are provided to manipulate these. typedef struct _FcMatrix { double xx, xy, yx, yy; } FcMatrix; -------------------------------------------------------------------------- FcCharSet An FcCharSet is an abstract type that holds the set of encoded Unicode chars in a font. Operations to build and compare these sets are provided. -------------------------------------------------------------------------- FcLangSet An FcLangSet is an abstract type that holds the set of languages supported by a font. Operations to build and compare these sets are provided. These are computed for a font based on orthographic information built into the fontconfig library. Fontconfig has orthographies for all of the ISO 639-1 languages except for MS, NA, PA, PS, QU, RN, RW, SD, SG, SN, SU and ZA. If you have orthographic information for any of these languages, please submit them. -------------------------------------------------------------------------- FcLangResult An FcLangResult is an enumeration used to return the results of comparing two language strings or FcLangSet objects. FcLangEqual means the objects match language and territory. FcLangDifferentTerritory means the objects match in language but differ in territory. FcLangDifferentLang means the objects differ in language. -------------------------------------------------------------------------- FcType Tags the kind of data stored in an FcValue. -------------------------------------------------------------------------- FcValue An FcValue object holds a single value with one of a number of different types. The 'type' tag indicates which member is valid. typedef struct _FcValue { FcType type; union { const FcChar8 *s; int i; FcBool b; double d; const FcMatrix *m; const FcCharSet *c; void *f; const FcLangSet *l; } u; } FcValue; FcValue Members Type Union member Datatype -------------------------------- FcTypeVoid (none) (none) FcTypeInteger i int FcTypeDouble d double FcTypeString s FcChar8 * FcTypeBool b b FcTypeMatrix m FcMatrix * FcTypeCharSet c FcCharSet * FcTypeFTFace f void * (FT_Face) FcTypeLangSet l FcLangSet * -------------------------------------------------------------------------- FcPattern holds a set of names with associated value lists; each name refers to a property of a font. FcPatterns are used as inputs to the matching code as well as holding information about specific fonts. Each property can hold one or more values; conventionally all of the same type, although the interface doesn't demand that. -------------------------------------------------------------------------- FcFontSet typedef struct _FcFontSet { int nfont; int sfont; FcPattern **fonts; } FcFontSet; An FcFontSet contains a list of FcPatterns. Internally fontconfig uses this data structure to hold sets of fonts. Externally, fontconfig returns the results of listing fonts in this format. 'nfont' holds the number of patterns in the 'fonts' array; 'sfont' is used to indicate the size of that array. -------------------------------------------------------------------------- FcStrSet, FcStrList FcStrSet holds a list of strings that can be appended to and enumerated. Its unique characteristic is that the enumeration works even while strings are appended during enumeration. FcStrList is used during enumeration to safely and correctly walk the list of strings even while that list is edited in the middle of enumeration. -------------------------------------------------------------------------- FcObjectSet typedef struct _FcObjectSet { int nobject; int sobject; const char **objects; } FcObjectSet; holds a set of names and is used to specify which fields from fonts are placed in the the list of returned patterns when listing fonts. -------------------------------------------------------------------------- FcObjectType typedef struct _FcObjectType { const char *object; FcType type; } FcObjectType; marks the type of a pattern element generated when parsing font names. Applications can add new object types so that font names may contain the new elements. -------------------------------------------------------------------------- FcConstant typedef struct _FcConstant { const FcChar8 *name; const char *object; int value; } FcConstant; Provides for symbolic constants for new pattern elements. When 'name' is seen in a font name, an 'object' element is created with value 'value'. -------------------------------------------------------------------------- FcBlanks holds a list of Unicode chars which are expected to be blank; unexpectedly blank chars are assumed to be invalid and are elided from the charset associated with the font. -------------------------------------------------------------------------- FcFileCache holds the per-user cache information for use while loading the font database. This is built automatically for the current configuration when that is loaded. Applications must always pass '0' when one is requested. -------------------------------------------------------------------------- FcConfig holds a complete configuration of the library; there is one default configuration, other can be constructed from XML data structures. All public entry points that need global data can take an optional FcConfig* argument; passing 0 uses the default configuration. FcConfig objects hold two sets of fonts, the first contains those specified by the configuration, the second set holds those added by the application at run-time. Interfaces that need to reference a particular set use one of the FcSetName enumerated values. -------------------------------------------------------------------------- FcSetName Specifies one of the two sets of fonts available in a configuration; FcSetSystem for those fonts specified in the configuration and FcSetApplication which holds fonts provided by the application. -------------------------------------------------------------------------- FcResult Used as a return type for functions manipulating FcPattern objects. FcResult Values Result Code Meaning ----------------------------------------------------------- FcResultMatch Object exists with the specified ID FcResultNoMatch Object doesn't exist at all FcResultTypeMismatch Object exists, but the type doesn't match FcResultNoId Object exists, but has fewer values than specified FcResultOutOfMemory malloc failed -------------------------------------------------------------------------- FcAtomic Used for locking access to configuration files. Provides a safe way to update configuration files. -------------------------------------------------------------------------- FcCache Holds information about the fonts contained in a single directory. Normal applications need not worry about this as caches for font access are automatically managed by the library. Applications dealing with cache management may want to use some of these objects in their work, however the included 'fc-cache' program generally suffices for all of that. -------------------------------------------------------------------------- FUNCTIONS These are grouped by functionality, often using the main data type being manipulated. -------------------------------------------------------------------------- Initialization Table of Contents [5]FcInitLoadConfig -- load configuration [6]FcInitLoadConfigAndFonts -- load configuration and font data [7]FcInit -- initialize fontconfig library [8]FcFini -- finalize fontconfig library [9]FcGetVersion -- library version number [10]FcInitReinitialize -- re-initialize library [11]FcInitBringUptoDate -- reload configuration files if needed These functions provide some control over how the library is initialized. FcInitLoadConfig Name FcInitLoadConfig -- load configuration Synopsis #include FcConfig * FcInitLoadConfig(void); Description Loads the default configuration file and returns the resulting configuration. Does not load any font information. Version Fontconfig version 2.10.91 FcInitLoadConfigAndFonts Name FcInitLoadConfigAndFonts -- load configuration and font data Synopsis #include FcConfig * FcInitLoadConfigAndFonts(void); Description Loads the default configuration file and builds information about the available fonts. Returns the resulting configuration. Version Fontconfig version 2.10.91 FcInit Name FcInit -- initialize fontconfig library Synopsis #include FcBool FcInit(void); Description Loads the default configuration file and the fonts referenced therein and sets the default configuration to that result. Returns whether this process succeeded or not. If the default configuration has already been loaded, this routine does nothing and returns FcTrue. Version Fontconfig version 2.10.91 FcFini Name FcFini -- finalize fontconfig library Synopsis #include void FcFini(void); Description Frees all data structures allocated by previous calls to fontconfig functions. Fontconfig returns to an uninitialized state, requiring a new call to one of the FcInit functions before any other fontconfig function may be called. Version Fontconfig version 2.10.91 FcGetVersion Name FcGetVersion -- library version number Synopsis #include int FcGetVersion(void); Description Returns the version number of the library. Version Fontconfig version 2.10.91 FcInitReinitialize Name FcInitReinitialize -- re-initialize library Synopsis #include FcBool FcInitReinitialize(void); Description Forces the default configuration file to be reloaded and resets the default configuration. Returns FcFalse if the configuration cannot be reloaded (due to configuration file errors, allocation failures or other issues) and leaves the existing configuration unchanged. Otherwise returns FcTrue. Version Fontconfig version 2.10.91 FcInitBringUptoDate Name FcInitBringUptoDate -- reload configuration files if needed Synopsis #include FcBool FcInitBringUptoDate(void); Description Checks the rescan interval in the default configuration, checking the configuration if the interval has passed and reloading the configuration if when any changes are detected. Returns FcFalse if the configuration cannot be reloaded (see FcInitReinitialize). Otherwise returns FcTrue. Version Fontconfig version 2.10.91 -------------------------------------------------------------------------- FcPattern Table of Contents [12]FcPatternCreate -- Create a pattern [13]FcPatternDuplicate -- Copy a pattern [14]FcPatternReference -- Increment pattern reference count [15]FcPatternDestroy -- Destroy a pattern [16]FcPatternEqual -- Compare patterns [17]FcPatternEqualSubset -- Compare portions of patterns [18]FcPatternFilter -- Filter the objects of pattern [19]FcPatternHash -- Compute a pattern hash value [20]FcPatternAdd -- Add a value to a pattern [21]FcPatternAddWeak -- Add a value to a pattern with weak binding [22]FcPatternAdd-Type -- Add a typed value to a pattern [23]FcPatternGet -- Return a value from a pattern [24]FcPatternGet-Type -- Return a typed value from a pattern [25]FcPatternBuild -- Create patterns from arguments [26]FcPatternDel -- Delete a property from a pattern [27]FcPatternRemove -- Remove one object of the specified type from the pattern [28]FcPatternPrint -- Print a pattern for debugging [29]FcDefaultSubstitute -- Perform default substitutions in a pattern [30]FcNameParse -- Parse a pattern string [31]FcNameUnparse -- Convert a pattern back into a string that can be parsed [32]FcPatternFormat -- Format a pattern into a string according to a format specifier An FcPattern is an opaque type that holds both patterns to match against the available fonts, as well as the information about each font. FcPatternCreate Name FcPatternCreate -- Create a pattern Synopsis #include FcPattern * FcPatternCreate(void); Description Creates a pattern with no properties; used to build patterns from scratch. Version Fontconfig version 2.10.91 FcPatternDuplicate Name FcPatternDuplicate -- Copy a pattern Synopsis #include 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. Version Fontconfig version 2.10.91 FcPatternReference Name FcPatternReference -- Increment pattern reference count Synopsis #include void FcPatternReference(FcPattern *p); Description Add another reference to p. Patterns are freed only when the reference count reaches zero. Version Fontconfig version 2.10.91 FcPatternDestroy Name FcPatternDestroy -- Destroy a pattern Synopsis #include 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. Version Fontconfig version 2.10.91 FcPatternEqual Name FcPatternEqual -- Compare patterns Synopsis #include FcBool FcPatternEqual(const FcPattern *pa, const FcPattern *pb); Description Returns whether pa and pb are exactly alike. Version Fontconfig version 2.10.91 FcPatternEqualSubset Name FcPatternEqualSubset -- Compare portions of patterns Synopsis #include 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. Version Fontconfig version 2.10.91 FcPatternFilter Name FcPatternFilter -- Filter the objects of pattern Synopsis #include 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. Version Fontconfig version 2.10.91 FcPatternHash Name FcPatternHash -- Compute a pattern hash value Synopsis #include FcChar32 FcPatternHash(const FcPattern *p); Description Returns a 32-bit number which is the same for any two patterns which are equal. Version Fontconfig version 2.10.91 FcPatternAdd Name FcPatternAdd -- Add a value to a pattern Synopsis #include 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 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. Version Fontconfig version 2.10.91 FcPatternAddWeak Name FcPatternAddWeak -- Add a value to a pattern with weak binding Synopsis #include 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. Version Fontconfig version 2.10.91 FcPatternAdd-Type Name FcPatternAddInteger, FcPatternAddDouble, FcPatternAddString, FcPatternAddMatrix, FcPatternAddCharSet, FcPatternAddBool, FcPatternAddFTFace, FcPatternAddLangSet -- Add a typed value to a pattern Synopsis #include 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); Description 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. Version Fontconfig version 2.10.91 FcPatternGet Name FcPatternGet -- Return a value from a pattern Synopsis #include 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 free this value. Version Fontconfig version 2.10.91 FcPatternGet-Type Name FcPatternGetInteger, FcPatternGetDouble, FcPatternGetString, FcPatternGetMatrix, FcPatternGetCharSet, FcPatternGetBool, FcPatternGetFTFace, FcPatternGetLangSet -- Return a typed value from a pattern Synopsis #include 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); Description 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. Version Fontconfig version 2.10.91 FcPatternBuild Name FcPatternBuild, FcPatternVaBuild, FcPatternVapBuild -- Create patterns from arguments Synopsis #include 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 three arguments:  1. Object name, a string describing the property to be added.  2. Object type, one of the FcType enumerated values  3. Value, not an FcValue, but the raw type as passed to any of the FcPatternAdd 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. Version Fontconfig version 2.10.91 FcPatternDel Name FcPatternDel -- Delete a property from a pattern Synopsis #include FcBool FcPatternDel(FcPattern *p, const char *object); Description Deletes all values associated with the property `object', returning whether the property existed or not. Version Fontconfig version 2.10.91 FcPatternRemove Name FcPatternRemove -- Remove one object of the specified type from the pattern Synopsis #include FcBool FcPatternRemove(FcPattern *p, const char *object, int id); Description 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. Version Fontconfig version 2.10.91 FcPatternPrint Name FcPatternPrint -- Print a pattern for debugging Synopsis #include void FcPatternPrint(const FcPattern *p); Description 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. Version Fontconfig version 2.10.91 FcDefaultSubstitute Name FcDefaultSubstitute -- Perform default substitutions in a pattern Synopsis #include void FcDefaultSubstitute(FcPattern *pattern); Description 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). Version Fontconfig version 2.10.91 FcNameParse Name FcNameParse -- Parse a pattern string Synopsis #include FcPattern * FcNameParse(const FcChar8 *name); Description Converts name from the standard text format described above into a pattern. Version Fontconfig version 2.10.91 FcNameUnparse Name FcNameUnparse -- Convert a pattern back into a string that can be parsed Synopsis #include FcChar8 * FcNameUnparse(FcPattern *pat); Description 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(). Version Fontconfig version 2.10.91 FcPatternFormat Name FcPatternFormat -- Format a pattern into a string according to a format specifier Synopsis #include 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 NULL if format is invalid. The format is loosely modeled after printf-style format string. The format string is composed of zero or more directives: ordinary characters (not "%"), which are copied unchanged to the output stream; and tags which are interpreted to construct text from the pattern in a variety of ways (explained below). Special characters can be escaped using backslash. C-string style special characters like \n and \r are also supported (this is useful when the format string is not a C string literal). It is advisable to always escape curly braces that are meant to be copied to the output as ordinary characters. Each tag is introduced by the character "%", followed by an optional minimum field width, followed by tag contents in curly braces ({}). If the minimum field width value is provided the tag will be expanded and the result padded to achieve the minimum width. If the minimum field width is positive, the padding will right-align the text. Negative field width will left-align. The rest of this section describes various supported tag contents and their expansion. A simple tag is one where the content is an identifier. When simple tags are expanded, the named identifier will be looked up in pattern and the resulting list of values returned, joined together using comma. For example, to print the family name and style of the pattern, use the format "%{family} %{style}\n". To extend the family column to forty characters use "%-40{family}%{style}\n". Simple tags expand to list of all values for an element. To only choose one of the values, one can index using the syntax "%{elt[idx]}". For example, to get the first family name only, use "%{family[0]}". If a simple tag ends with "=" and the element is found in the pattern, the name of the element followed by "=" will be output before the list of values. For example, "%{weight=}" may expand to the string "weight=80". Or to the empty string if pattern does not have weight set. If a simple tag starts with ":" and the element is found in the pattern, ":" will be printed first. For example, combining this with the =, the format "%{:weight=}" may expand to ":weight=80" or to the empty string if pattern does not have weight set. If a simple tag contains the string ":-", the rest of the the tag contents will be used as a default string. The default string is output if the element is not found in the pattern. For example, the format "%{:weight=:-123}" may expand to ":weight=80" or to the string ":weight=123" if pattern does not have weight set. A count tag is one that starts with the character "#" followed by an element name, and expands to the number of values for the element in the pattern. For example, "%{#family}" expands to the number of family names pattern has set, which may be zero. A sub-expression tag is one that expands a sub-expression. The tag contents are the sub-expression to expand placed inside another set of curly braces. Sub-expression tags are useful for aligning an entire sub-expression, or to apply converters (explained later) to the entire sub-expression output. For example, the format "%40{{%{family} %{style}}}" expands the sub-expression to construct the family name followed by the style, then takes the entire string and pads it on the left to be at least forty characters. A filter-out tag is one starting with the character "-" followed by a comma-separated list of element names, followed by a sub-expression enclosed in curly braces. The sub-expression will be expanded but with a pattern that has the listed elements removed from it. For example, the format "%{-size,pixelsize{sub-expr}}" will expand "sub-expr" with pattern sans the size and pixelsize elements. A filter-in tag is one starting with the character "+" followed by a comma-separated list of element names, followed by a sub-expression enclosed in curly braces. The sub-expression will be expanded but with a pattern that only has the listed elements from the surrounding pattern. For example, the format "%{+family,familylang{sub-expr}}" will expand "sub-expr" with a sub-pattern consisting only the family and family lang elements of pattern. A conditional tag is one starting with the character "?" followed by a comma-separated list of element conditions, followed by two sub-expression enclosed in curly braces. An element condition can be an element name, in which case it tests whether the element is defined in pattern, or the character "!" followed by an element name, in which case the test is negated. The conditional passes if all the element conditions pass. The tag expands the first sub-expression if the conditional passes, and expands the second sub-expression otherwise. For example, the format "%{?size,dpi,!pixelsize{pass}{fail}}" will expand to "pass" if pattern has size and dpi elements but no pixelsize element, and to "fail" otherwise. An enumerate tag is one starting with the string "[]" followed by a comma-separated list of element names, followed by a sub-expression enclosed in curly braces. The list of values for the named elements are walked in parallel and the sub-expression expanded each time with a pattern just having a single value for those elements, starting from the first value and continuing as long as any of those elements has a value. For example, the format "%{[]family,familylang{%{family} (%{familylang})\n}}" will expand the pattern "%{family} (%{familylang})\n" with a pattern having only the first value of the family and familylang elements, then expands it with the second values, then the third, etc. As a special case, if an enumerate tag has only one element, and that element has only one value in the pattern, and that value is of type FcLangSet, the individual languages in the language set are enumerated. A builtin tag is one starting with the character "=" followed by a builtin name. The following builtins are defined: unparse Expands to the result of calling FcNameUnparse() on the pattern. fcmatch Expands to the output of the default output format of the fc-match command on the pattern, without the final newline. fclist Expands to the output of the default output format of the fc-list command on the pattern, without the final newline. fccat Expands to the output of the default output format of the fc-cat command on the pattern, without the final newline. pkgkit Expands to the list of PackageKit font() tags for the pattern. Currently this includes tags for each family name, and each language from the pattern, enumerated and sanitized into a set of tags terminated by newline. Package management systems can use these tags to tag their packages accordingly. For example, the format "%{+family,style{%{=unparse}}}\n" will expand to an unparsed name containing only the family and style element values from pattern. The contents of any tag can be followed by a set of zero or more converters. A converter is specified by the character "|" followed by the converter name and arguments. The following converters are defined: basename Replaces text with the results of calling FcStrBasename() on it. dirname Replaces text with the results of calling FcStrDirname() on it. downcase Replaces text with the results of calling FcStrDowncase() on it. shescape Escapes text for one level of shell expansion. (Escapes single-quotes, also encloses text in single-quotes.) cescape Escapes text such that it can be used as part of a C string literal. (Escapes backslash and double-quotes.) xmlescape Escapes text such that it can be used in XML and HTML. (Escapes less-than, greater-than, and ampersand.) delete(chars) Deletes all occurrences of each of the characters in chars from the text. FIXME: This converter is not UTF-8 aware yet. escape(chars) Escapes all occurrences of each of the characters in chars by prepending it by the first character in chars. FIXME: This converter is not UTF-8 aware yet. translate(from,to) Translates all occurrences of each of the characters in from by replacing them with their corresponding character in to. If to has fewer characters than from, it will be extended by repeating its last character. FIXME: This converter is not UTF-8 aware yet. For example, the format "%{family|downcase|delete( )}\n" will expand to the values of the family element in pattern, lower-cased and with spaces removed. Version Fontconfig version 2.10.91 -------------------------------------------------------------------------- FcFontSet Table of Contents [33]FcFontSetCreate -- Create a font set [34]FcFontSetDestroy -- Destroy a font set [35]FcFontSetAdd -- Add to a font set [36]FcFontSetList -- List fonts from a set of font sets [37]FcFontSetMatch -- Return the best font from a set of font sets [38]FcFontSetPrint -- Print a set of patterns to stdout [39]FcFontSetSort -- Add to a font set [40]FcFontSetSortDestroy -- DEPRECATED destroy a font set An FcFontSet simply holds a list of patterns; these are used to return the results of listing available fonts. FcFontSetCreate Name FcFontSetCreate -- Create a font set Synopsis #include FcFontSet * FcFontSetCreate(void); Description Creates an empty font set. Version Fontconfig version 2.10.91 FcFontSetDestroy Name FcFontSetDestroy -- Destroy a font set Synopsis #include void FcFontSetDestroy(FcFontSet *s); Description Destroys a font set. Note that this destroys any referenced patterns as well. Version Fontconfig version 2.10.91 FcFontSetAdd Name FcFontSetAdd -- Add to a font set Synopsis #include 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 2.10.91 FcFontSetList Name FcFontSetList -- List fonts from a set of font sets Synopsis #include 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 2.10.91 FcFontSetMatch Name FcFontSetMatch -- Return the best font from a set of font sets Synopsis #include 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 2.10.91 FcFontSetPrint Name FcFontSetPrint -- Print a set of patterns to stdout Synopsis #include 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 2.10.91 FcFontSetSort Name FcFontSetSort -- Add to a font set Synopsis #include 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 2.10.91 FcFontSetSortDestroy Name FcFontSetSortDestroy -- DEPRECATED destroy a font set Synopsis #include FcFontSetSortDestroy(FcFontSet *set); Description This function is DEPRECATED. FcFontSetSortDestroy destroys set by calling FcFontSetDestroy. Applications should use FcFontSetDestroy directly instead. Version Fontconfig version 2.10.91 -------------------------------------------------------------------------- FcObjectSet Table of Contents [41]FcObjectSetCreate -- Create an object set [42]FcObjectSetAdd -- Add to an object set [43]FcObjectSetDestroy -- Destroy an object set [44]FcObjectSetBuild -- Build object set from args An FcObjectSet holds a list of pattern property names; it is used to indicate which properties are to be returned in the patterns from FcFontList. FcObjectSetCreate Name FcObjectSetCreate -- Create an object set Synopsis #include FcObjectSet * FcObjectSetCreate(void); Description Creates an empty set. Version Fontconfig version 2.10.91 FcObjectSetAdd Name FcObjectSetAdd -- Add to an object set Synopsis #include FcBool FcObjectSetAdd(FcObjectSet *os, const char *object); Description Adds 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. Version Fontconfig version 2.10.91 FcObjectSetDestroy Name FcObjectSetDestroy -- Destroy an object set Synopsis #include void FcObjectSetDestroy(FcObjectSet *os); Description Destroys an object set. Version Fontconfig version 2.10.91 FcObjectSetBuild Name FcObjectSetBuild, FcObjectSetVaBuild, FcObjectSetVapBuild -- Build object set from args Synopsis #include FcObjectSet * FcObjectSetBuild(const char *first, ...); FcObjectSet * FcObjectSetVaBuild(const char *first, va_list va); void FcObjectSetVapBuild(FcObjectSet *result, const char *first, va_list va); Description These build an object set from a null-terminated list of property names. FcObjectSetVapBuild is a macro version of FcObjectSetVaBuild which returns the result in the result variable directly. Version Fontconfig version 2.10.91 -------------------------------------------------------------------------- FreeType specific functions Table of Contents [45]FcFreeTypeCharIndex -- map Unicode to glyph id [46]FcFreeTypeCharSet -- compute Unicode coverage [47]FcFreeTypeCharSetAndSpacing -- compute Unicode coverage and spacing type [48]FcFreeTypeQuery -- compute pattern from font file (and index) [49]FcFreeTypeQueryFace -- compute pattern from FT_Face While the fontconfig library doesn't insist that FreeType be used as the rasterization mechanism for fonts, it does provide some convenience functions. FcFreeTypeCharIndex Name FcFreeTypeCharIndex -- map Unicode to glyph id Synopsis #include #include FT_UInt FcFreeTypeCharIndex(FT_Face face, FcChar32 ucs4); Description Maps a Unicode char to a glyph index. This function uses information from several possible underlying encoding tables to work around broken fonts. As a result, this function isn't designed to be used in performance sensitive areas; results from this function are intended to be cached by higher level functions. Version Fontconfig version 2.10.91 FcFreeTypeCharSet Name FcFreeTypeCharSet -- compute Unicode coverage Synopsis #include #include FcCharSet * FcFreeTypeCharSet(FT_Face face, FcBlanks *blanks); Description Scans a FreeType face and returns the set of encoded Unicode chars. This scans several encoding tables to build as complete a list as possible. If 'blanks' is not 0, the glyphs in the font are examined and any blank glyphs not in 'blanks' are not placed in the returned FcCharSet. Version Fontconfig version 2.10.91 FcFreeTypeCharSetAndSpacing Name FcFreeTypeCharSetAndSpacing -- compute Unicode coverage and spacing type Synopsis #include #include FcCharSet * FcFreeTypeCharSetAndSpacing(FT_Face face, FcBlanks *blanks, int *spacing); Description Scans a FreeType face and returns the set of encoded Unicode chars. This scans several encoding tables to build as complete a list as possible. If 'blanks' is not 0, the glyphs in the font are examined and any blank glyphs not in 'blanks' are not placed in the returned FcCharSet. spacing receives the computed spacing type of the font, one of FC_MONO for a font where all glyphs have the same width, FC_DUAL, where the font has glyphs in precisely two widths, one twice as wide as the other, or FC_PROPORTIONAL where the font has glyphs of many widths. Version Fontconfig version 2.10.91 FcFreeTypeQuery Name FcFreeTypeQuery -- compute pattern from font file (and index) Synopsis #include #include FcPattern * FcFreeTypeQuery(const FcChar8 *file, int id, FcBlanks *blanks, int *count); Description Constructs a pattern representing the 'id'th font in 'file'. The number of fonts in 'file' is returned in 'count'. Version Fontconfig version 2.10.91 FcFreeTypeQueryFace Name FcFreeTypeQueryFace -- compute pattern from FT_Face Synopsis #include #include FcPattern * FcFreeTypeQueryFace(const FT_Face face, const FcChar8 *file, int id, FcBlanks *blanks); Description Constructs a pattern representing 'face'. 'file' and 'id' are used solely as data for pattern elements (FC_FILE, FC_INDEX and sometimes FC_FAMILY). Version Fontconfig version 2.10.91 -------------------------------------------------------------------------- FcValue Table of Contents [50]FcValueDestroy -- Free a value [51]FcValueSave -- Copy a value [52]FcValuePrint -- Print a value to stdout [53]FcValueEqual -- Test two values for equality FcValue is a structure containing a type tag and a union of all possible datatypes. The tag is an enum of type FcType and is intended to provide a measure of run-time typechecking, although that depends on careful programming. FcValueDestroy Name FcValueDestroy -- Free a value Synopsis #include void FcValueDestroy(FcValue v); Description Frees any memory referenced by v. Values of type FcTypeString, FcTypeMatrix and FcTypeCharSet reference memory, the other types do not. Version Fontconfig version 2.10.91 FcValueSave Name FcValueSave -- Copy a value Synopsis #include FcValue FcValueSave(FcValue v); Description Returns a copy of v duplicating any object referenced by it so that v may be safely destroyed without harming the new value. Version Fontconfig version 2.10.91 FcValuePrint Name FcValuePrint -- Print a value to stdout Synopsis #include void FcValuePrint(FcValue v); Description Prints a human-readable representation of v to stdout. The format should not be considered part of the library specification as it may change in the future. Version Fontconfig version 2.10.91 FcValueEqual Name FcValueEqual -- Test two values for equality Synopsis #include FcBool FcValueEqual(FcValue v_a, FcValue v_b); Description Compares two values. Integers and Doubles are compared as numbers; otherwise the two values have to be the same type to be considered equal. Strings are compared ignoring case. Version Fontconfig version 2.10.91 -------------------------------------------------------------------------- FcCharSet Table of Contents [54]FcCharSetCreate -- Create an empty character set [55]FcCharSetDestroy -- Destroy a character set [56]FcCharSetAddChar -- Add a character to a charset [57]FcCharSetDelChar -- Add a character to a charset [58]FcCharSetCopy -- Copy a charset [59]FcCharSetEqual -- Compare two charsets [60]FcCharSetIntersect -- Intersect charsets [61]FcCharSetUnion -- Add charsets [62]FcCharSetSubtract -- Subtract charsets [63]FcCharSetMerge -- Merge charsets [64]FcCharSetHasChar -- Check a charset for a char [65]FcCharSetCount -- Count entries in a charset [66]FcCharSetIntersectCount -- Intersect and count charsets [67]FcCharSetSubtractCount -- Subtract and count charsets [68]FcCharSetIsSubset -- Test for charset inclusion [69]FcCharSetFirstPage -- Start enumerating charset contents [70]FcCharSetNextPage -- Continue enumerating charset contents [71]FcCharSetCoverage -- DEPRECATED return coverage for a Unicode page [72]FcCharSetNew -- DEPRECATED alias for FcCharSetCreate An FcCharSet is a boolean array indicating a set of Unicode chars. Those associated with a font are marked constant and cannot be edited. FcCharSets may be reference counted internally to reduce memory consumption; this may be visible to applications as the result of FcCharSetCopy may return it's argument, and that CharSet may remain unmodifiable. FcCharSetCreate Name FcCharSetCreate -- Create an empty character set Synopsis #include FcCharSet * FcCharSetCreate(void); Description FcCharSetCreate allocates and initializes a new empty character set object. Version Fontconfig version 2.10.91 FcCharSetDestroy Name FcCharSetDestroy -- Destroy a character set Synopsis #include void FcCharSetDestroy(FcCharSet *fcs); Description FcCharSetDestroy decrements the reference count fcs. If the reference count becomes zero, all memory referenced is freed. Version Fontconfig version 2.10.91 FcCharSetAddChar Name FcCharSetAddChar -- Add a character to a charset Synopsis #include FcBool FcCharSetAddChar(FcCharSet *fcs, FcChar32 ucs4); Description FcCharSetAddChar adds a single Unicode char to the set, returning FcFalse on failure, either as a result of a constant set or from running out of memory. Version Fontconfig version 2.10.91 FcCharSetDelChar Name FcCharSetDelChar -- Add a character to a charset Synopsis #include FcBool FcCharSetDelChar(FcCharSet *fcs, FcChar32 ucs4); Description FcCharSetDelChar deletes a single Unicode char from the set, returning FcFalse on failure, either as a result of a constant set or from running out of memory. Version Fontconfig version 2.10.91 FcCharSetCopy Name FcCharSetCopy -- Copy a charset Synopsis #include FcCharSet * FcCharSetCopy(FcCharSet *src); Description Makes a copy of src; note that this may not actually do anything more than increment the reference count on src. Version Fontconfig version 2.10.91 FcCharSetEqual Name FcCharSetEqual -- Compare two charsets Synopsis #include FcBool FcCharSetEqual(const FcCharSet *a, const FcCharSet *b); Description Returns whether a and b contain the same set of Unicode chars. Version Fontconfig version 2.10.91 FcCharSetIntersect Name FcCharSetIntersect -- Intersect charsets Synopsis #include FcCharSet * FcCharSetIntersect(const FcCharSet *a, const FcCharSet *b); Description Returns a set including only those chars found in both a and b. Version Fontconfig version 2.10.91 FcCharSetUnion Name FcCharSetUnion -- Add charsets Synopsis #include FcCharSet * FcCharSetUnion(const FcCharSet *a, const FcCharSet *b); Description Returns a set including only those chars found in either a or b. Version Fontconfig version 2.10.91 FcCharSetSubtract Name FcCharSetSubtract -- Subtract charsets Synopsis #include FcCharSet * FcCharSetSubtract(const FcCharSet *a, const FcCharSet *b); Description Returns a set including only those chars found in a but not b. Version Fontconfig version 2.10.91 FcCharSetMerge Name FcCharSetMerge -- Merge charsets Synopsis #include FcBool FcCharSetMerge(FcCharSet *a, const FcCharSet *b, FcBool *changed); Description Adds all chars in b to a. In other words, this is an in-place version of FcCharSetUnion. If changed is not NULL, then it returns whether any new chars from b were added to a. Returns FcFalse on failure, either when a is a constant set or from running out of memory. Version Fontconfig version 2.10.91 FcCharSetHasChar Name FcCharSetHasChar -- Check a charset for a char Synopsis #include FcBool FcCharSetHasChar(const FcCharSet *fcs, FcChar32 ucs4); Description Returns whether fcs contains the char ucs4. Version Fontconfig version 2.10.91 FcCharSetCount Name FcCharSetCount -- Count entries in a charset Synopsis #include FcChar32 FcCharSetCount(const FcCharSet *a); Description Returns the total number of Unicode chars in a. Version Fontconfig version 2.10.91 FcCharSetIntersectCount Name FcCharSetIntersectCount -- Intersect and count charsets Synopsis #include FcChar32 FcCharSetIntersectCount(const FcCharSet *a, const FcCharSet *b); Description Returns the number of chars that are in both a and b. Version Fontconfig version 2.10.91 FcCharSetSubtractCount Name FcCharSetSubtractCount -- Subtract and count charsets Synopsis #include FcChar32 FcCharSetSubtractCount(const FcCharSet *a, const FcCharSet *b); Description Returns the number of chars that are in a but not in b. Version Fontconfig version 2.10.91 FcCharSetIsSubset Name FcCharSetIsSubset -- Test for charset inclusion Synopsis #include FcBool FcCharSetIsSubset(const FcCharSet *a, const FcCharSet *b); Description Returns whether a is a subset of b. Version Fontconfig version 2.10.91 FcCharSetFirstPage Name FcCharSetFirstPage -- Start enumerating charset contents Synopsis #include FcChar32 FcCharSetFirstPage(const FcCharSet *a, FcChar32[FC_CHARSET_MAP_SIZE] map, FcChar32 *next); Description Builds an array of bits marking the first page of Unicode coverage of a. Returns the base of the array. next contains the next page in the font. Version Fontconfig version 2.10.91 FcCharSetNextPage Name FcCharSetNextPage -- Continue enumerating charset contents Synopsis #include FcChar32 FcCharSetNextPage(const FcCharSet *a, FcChar32[FC_CHARSET_MAP_SIZE] map, FcChar32 *next); Description Builds an array of bits marking the Unicode coverage of a for page *next. Returns the base of the array. next contains the next page in the font. Version Fontconfig version 2.10.91 FcCharSetCoverage Name FcCharSetCoverage -- DEPRECATED return coverage for a Unicode page Synopsis #include FcChar32 FcCharSetCoverage(const FcCharSet *a, FcChar32page, FcChar32[8]result); Description DEPRECATED This function returns a bitmask in result which indicates which code points in page are included in a. FcCharSetCoverage returns the next page in the charset which has any coverage. Version Fontconfig version 2.10.91 FcCharSetNew Name FcCharSetNew -- DEPRECATED alias for FcCharSetCreate Synopsis #include FcCharSet * FcCharSetNew(void); Description FcCharSetNew is a DEPRECATED alias for FcCharSetCreate. Version Fontconfig version 2.10.91 -------------------------------------------------------------------------- FcLangSet Table of Contents [73]FcLangSetCreate -- create a langset object [74]FcLangSetDestroy -- destroy a langset object [75]FcLangSetCopy -- copy a langset object [76]FcLangSetAdd -- add a language to a langset [77]FcLangSetDel -- delete a language from a langset [78]FcLangSetUnion -- Add langsets [79]FcLangSetSubtract -- Subtract langsets [80]FcLangSetCompare -- compare language sets [81]FcLangSetContains -- check langset subset relation [82]FcLangSetEqual -- test for matching langsets [83]FcLangSetHash -- return a hash value for a langset [84]FcLangSetHasLang -- test langset for language support [85]FcGetDefaultLangs -- Get the default languages list [86]FcGetLangs -- Get list of languages [87]FcLangNormalize -- Normalize the language string [88]FcLangGetCharSet -- Get character map for a language An FcLangSet is a set of language names (each of which include language and an optional territory). They are used when selecting fonts to indicate which languages the fonts need to support. Each font is marked, using language orthography information built into fontconfig, with the set of supported languages. FcLangSetCreate Name FcLangSetCreate -- create a langset object Synopsis #include FcLangSet * FcLangSetCreate(void); Description FcLangSetCreate creates a new FcLangSet object. Version Fontconfig version 2.10.91 FcLangSetDestroy Name FcLangSetDestroy -- destroy a langset object Synopsis #include void FcLangSetDestroy(FcLangSet *ls); Description FcLangSetDestroy destroys a FcLangSet object, freeing all memory associated with it. Version Fontconfig version 2.10.91 FcLangSetCopy Name FcLangSetCopy -- copy a langset object Synopsis #include FcLangSet * FcLangSetCopy(const FcLangSet *ls); Description FcLangSetCopy creates a new FcLangSet object and populates it with the contents of ls. Version Fontconfig version 2.10.91 FcLangSetAdd Name FcLangSetAdd -- add a language to a langset Synopsis #include FcBool FcLangSetAdd(FcLangSet *ls, const FcChar8 *lang); Description lang is added to ls. lang should be of the form Ll-Tt where Ll is a two or three letter language from ISO 639 and Tt is a territory from ISO 3166. Version Fontconfig version 2.10.91 FcLangSetDel Name FcLangSetDel -- delete a language from a langset Synopsis #include FcBool FcLangSetDel(FcLangSet *ls, const FcChar8 *lang); Description lang is removed from ls. lang should be of the form Ll-Tt where Ll is a two or three letter language from ISO 639 and Tt is a territory from ISO 3166. Version Fontconfig version 2.10.91 FcLangSetUnion Name FcLangSetUnion -- Add langsets Synopsis #include FcLangSet * FcLangSetUnion(const FcLangSet *ls_a, const FcLangSet *ls_b); Description Returns a set including only those languages found in either ls_a or ls_b. Version Fontconfig version 2.10.91 FcLangSetSubtract Name FcLangSetSubtract -- Subtract langsets Synopsis #include FcLangSet * FcLangSetSubtract(const FcLangSet *ls_a, const FcLangSet *ls_b); Description Returns a set including only those languages found in ls_a but not in ls_b. Version Fontconfig version 2.10.91 FcLangSetCompare Name FcLangSetCompare -- compare language sets Synopsis #include FcLangResult FcLangSetCompare(const FcLangSet *ls_a, const FcLangSet *ls_b); Description FcLangSetCompare compares language coverage for ls_a and ls_b. If they share any language and territory pair, this function returns FcLangEqual. If they share a language but differ in which territory that language is for, this function returns FcLangDifferentTerritory. If they share no languages in common, this function returns FcLangDifferentLang. Version Fontconfig version 2.10.91 FcLangSetContains Name FcLangSetContains -- check langset subset relation Synopsis #include FcBool FcLangSetContains(const FcLangSet *ls_a, const FcLangSet *ls_b); Description FcLangSetContains returns FcTrue if ls_a contains every language in ls_b. ls_a will 'contain' a language from ls_b if ls_a has exactly the language, or either the language or ls_a has no territory. Version Fontconfig version 2.10.91 FcLangSetEqual Name FcLangSetEqual -- test for matching langsets Synopsis #include FcBool FcLangSetEqual(const FcLangSet *ls_a, const FcLangSet *ls_b); Description Returns FcTrue if and only if ls_a supports precisely the same language and territory combinations as ls_b. Version Fontconfig version 2.10.91 FcLangSetHash Name FcLangSetHash -- return a hash value for a langset Synopsis #include FcChar32 FcLangSetHash(const FcLangSet *ls); Description This function returns a value which depends solely on the languages supported by ls. Any language which equals ls will have the same result from FcLangSetHash. However, two langsets with the same hash value may not be equal. Version Fontconfig version 2.10.91 FcLangSetHasLang Name FcLangSetHasLang -- test langset for language support Synopsis #include FcLangResult FcLangSetHasLang(const FcLangSet *ls, const FcChar8 *lang); Description FcLangSetHasLang checks whether ls supports lang. If ls has a matching language and territory pair, this function returns FcLangEqual. If ls has a matching language but differs in which territory that language is for, this function returns FcLangDifferentTerritory. If ls has no matching language, this function returns FcLangDifferentLang. Version Fontconfig version 2.10.91 FcGetDefaultLangs Name FcGetDefaultLangs -- Get the default languages list Synopsis #include FcStrSet * FcGetDefaultLangs(voidls); Description Returns a string set of the default languages according to the environment variables on the system. This function looks for them in order of FC_LANG, LC_ALL, LC_CTYPE and LANG then. If there are no valid values in those environment variables, "en" will be set as fallback. Version Fontconfig version 2.10.91 FcGetLangs Name FcGetLangs -- Get list of languages Synopsis #include FcStrSet * FcGetLangs(void); Description Returns a string set of all known languages. Version Fontconfig version 2.10.91 FcLangNormalize Name FcLangNormalize -- Normalize the language string Synopsis #include FcChar8 * FcLangNormalize(const FcChar8 *lang); Description Returns a string to make lang suitable on fontconfig. Version Fontconfig version 2.10.91 FcLangGetCharSet Name FcLangGetCharSet -- Get character map for a language Synopsis #include const FcCharSet * FcLangGetCharSet(const FcChar8 *lang); Description Returns the FcCharMap for a language. Version Fontconfig version 2.10.91 -------------------------------------------------------------------------- FcMatrix Table of Contents [89]FcMatrixInit -- initialize an FcMatrix structure [90]FcMatrixCopy -- Copy a matrix [91]FcMatrixEqual -- Compare two matrices [92]FcMatrixMultiply -- Multiply matrices [93]FcMatrixRotate -- Rotate a matrix [94]FcMatrixScale -- Scale a matrix [95]FcMatrixShear -- Shear a matrix FcMatrix structures hold an affine transformation in matrix form. FcMatrixInit Name FcMatrixInit -- initialize an FcMatrix structure Synopsis #include void FcMatrixInit(FcMatrix *matrix); Description FcMatrixInit initializes matrix to the identity matrix. Version Fontconfig version 2.10.91 FcMatrixCopy Name FcMatrixCopy -- Copy a matrix Synopsis #include void FcMatrixCopy(const FcMatrix *matrix); Description FcMatrixCopy allocates a new FcMatrix and copies mat into it. Version Fontconfig version 2.10.91 FcMatrixEqual Name FcMatrixEqual -- Compare two matrices Synopsis #include void FcMatrixEqual(const FcMatrix *matrix1, const FcMatrix *matrix2); Description FcMatrixEqual compares matrix1 and matrix2 returning FcTrue when they are equal and FcFalse when they are not. Version Fontconfig version 2.10.91 FcMatrixMultiply Name FcMatrixMultiply -- Multiply matrices Synopsis #include void FcMatrixMultiply(FcMatrix *result, const FcMatrix *matrix1, const FcMatrix *matrix2); Description FcMatrixMultiply multiplies matrix1 and matrix2 storing the result in result. Version Fontconfig version 2.10.91 FcMatrixRotate Name FcMatrixRotate -- Rotate a matrix Synopsis #include void FcMatrixRotate(FcMatrix *matrix, double cos, double sin); Description FcMatrixRotate rotates matrix by the angle who's sine is sin and cosine is cos. This is done by multiplying by the matrix: cos -sin sin cos Version Fontconfig version 2.10.91 FcMatrixScale Name FcMatrixScale -- Scale a matrix Synopsis #include void FcMatrixScale(FcMatrix *matrix, double sx, double dy); Description FcMatrixScale multiplies matrix x values by sx and y values by dy. This is done by multiplying by the matrix: sx 0 0 dy Version Fontconfig version 2.10.91 FcMatrixShear Name FcMatrixShear -- Shear a matrix Synopsis #include void FcMatrixShear(FcMatrix *matrix, double sh, double sv); Description FcMatrixShare shears matrix horizontally by sh and vertically by sv. This is done by multiplying by the matrix: 1 sh sv 1 Version Fontconfig version 2.10.91 -------------------------------------------------------------------------- FcConfig Table of Contents [96]FcConfigCreate -- Create a configuration [97]FcConfigReference -- Increment config reference count [98]FcConfigDestroy -- Destroy a configuration [99]FcConfigSetCurrent -- Set configuration as default [100]FcConfigGetCurrent -- Return current configuration [101]FcConfigUptoDate -- Check timestamps on config files [102]FcConfigHome -- return the current home directory. [103]FcConfigEnableHome -- controls use of the home directory. [104]FcConfigBuildFonts -- Build font database [105]FcConfigGetConfigDirs -- Get config directories [106]FcConfigGetFontDirs -- Get font directories [107]FcConfigGetConfigFiles -- Get config files [108]FcConfigGetCache -- DEPRECATED used to return per-user cache filename [109]FcConfigGetCacheDirs -- return the list of directories searched for cache files [110]FcConfigGetFonts -- Get config font set [111]FcConfigGetBlanks -- Get config blanks [112]FcConfigGetRescanInterval -- Get config rescan interval [113]FcConfigSetRescanInterval -- Set config rescan interval [114]FcConfigAppFontAddFile -- Add font file to font database [115]FcConfigAppFontAddDir -- Add fonts from directory to font database [116]FcConfigAppFontClear -- Remove all app fonts from font database [117]FcConfigSubstituteWithPat -- Execute substitutions [118]FcConfigSubstitute -- Execute substitutions [119]FcFontMatch -- Return best font [120]FcFontSort -- Return list of matching fonts [121]FcFontRenderPrepare -- Prepare pattern for loading font file [122]FcFontList -- List fonts [123]FcConfigFilename -- Find a config file [124]FcConfigParseAndLoad -- load a configuration file An FcConfig object holds the internal representation of a configuration. There is a default configuration which applications may use by passing 0 to any function using the data within an FcConfig. FcConfigCreate Name FcConfigCreate -- Create a configuration Synopsis #include FcConfig * FcConfigCreate(void); Description Creates an empty configuration. Version Fontconfig version 2.10.91 FcConfigReference Name FcConfigReference -- Increment config reference count Synopsis #include 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 count before returning and the user is responsible for destroying the configuration when not needed anymore. Version Fontconfig version 2.10.91 FcConfigDestroy Name FcConfigDestroy -- Destroy a configuration Synopsis #include void FcConfigDestroy(FcConfig *config); Description Decrements the config reference count. If all references are gone, destroys the configuration and any data associated with it. Note that calling this function with the return from FcConfigGetCurrent will cause a new configuration to be created for use as current configuration. Version Fontconfig version 2.10.91 FcConfigSetCurrent Name FcConfigSetCurrent -- Set configuration as default Synopsis #include FcBool FcConfigSetCurrent(FcConfig *config); Description Sets the current default configuration to config. Implicitly calls FcConfigBuildFonts if necessary, returning FcFalse if that call fails. Version Fontconfig version 2.10.91 FcConfigGetCurrent Name FcConfigGetCurrent -- Return current configuration Synopsis #include FcConfig * FcConfigGetCurrent(void); Description Returns the current default configuration. Version Fontconfig version 2.10.91 FcConfigUptoDate Name FcConfigUptoDate -- Check timestamps on config files Synopsis #include FcBool FcConfigUptoDate(FcConfig *config); Description Checks all of the files related to config and returns whether any of them has been modified since the configuration was created. If config is NULL, the current configuration is used. Version Fontconfig version 2.10.91 FcConfigHome Name FcConfigHome -- return the current home directory. Synopsis #include 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). Version Fontconfig version 2.10.91 FcConfigEnableHome Name FcConfigEnableHome -- controls use of the home directory. Synopsis #include FcBool FcConfigEnableHome(FcBool enable); Description If enable is FcTrue, then Fontconfig will use various files which are specified relative to the user's home directory (using the ~ notation in the configuration). When enable is FcFalse, then all use of the home directory in these contexts will be disabled. The previous setting of the value is returned. Version Fontconfig version 2.10.91 FcConfigBuildFonts Name FcConfigBuildFonts -- Build font database Synopsis #include FcBool FcConfigBuildFonts(FcConfig *config); Description Builds the set of available fonts for the given configuration. Note that any changes to the configuration after this call have indeterminate effects. Returns FcFalse if this operation runs out of memory. If config is NULL, the current configuration is used. Version Fontconfig version 2.10.91 FcConfigGetConfigDirs Name FcConfigGetConfigDirs -- Get config directories Synopsis #include 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. Version Fontconfig version 2.10.91 FcConfigGetFontDirs Name FcConfigGetFontDirs -- Get font directories Synopsis #include 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. Version Fontconfig version 2.10.91 FcConfigGetConfigFiles Name FcConfigGetConfigFiles -- Get config files Synopsis #include 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. Version Fontconfig version 2.10.91 FcConfigGetCache Name FcConfigGetCache -- DEPRECATED used to return per-user cache filename Synopsis #include 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. Version Fontconfig version 2.10.91 FcConfigGetCacheDirs Name FcConfigGetCacheDirs -- return the list of directories searched for cache files Synopsis #include 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. Version Fontconfig version 2.10.91 FcConfigGetFonts Name FcConfigGetFonts -- Get config font set Synopsis #include 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 used. Version Fontconfig version 2.10.91 FcConfigGetBlanks Name FcConfigGetBlanks -- Get config blanks Synopsis #include FcBlanks * FcConfigGetBlanks(FcConfig *config); Description Returns the FcBlanks object associated with the given configuration, if no blanks were present in the configuration, this function will return 0. The returned FcBlanks object if not NULL, is valid as long as the owning FcConfig is alive. If config is NULL, the current configuration is used. Version Fontconfig version 2.10.91 FcConfigGetRescanInterval Name FcConfigGetRescanInterval -- Get config rescan interval Synopsis #include 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 config is NULL, the current configuration is used. Version Fontconfig version 2.10.91 FcConfigSetRescanInterval Name FcConfigSetRescanInterval -- Set config rescan interval Synopsis #include 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. Version Fontconfig version 2.10.91 FcConfigAppFontAddFile Name FcConfigAppFontAddFile -- Add font file to font database Synopsis #include FcBool FcConfigAppFontAddFile(FcConfig *config, const FcChar8 *file); Description Adds an application-specific font to the configuration. Returns FcFalse if the fonts cannot be added (due to allocation failure). Otherwise returns FcTrue. If config is NULL, the current configuration is used. Version Fontconfig version 2.10.91 FcConfigAppFontAddDir Name FcConfigAppFontAddDir -- Add fonts from directory to font database Synopsis #include FcBool FcConfigAppFontAddDir(FcConfig *config, const FcChar8 *dir); Description Scans the specified directory for fonts, adding each one found to the application-specific set of fonts. Returns FcFalse if the fonts cannot be added (due to allocation failure). Otherwise returns FcTrue. If config is NULL, the current configuration is used. Version Fontconfig version 2.10.91 FcConfigAppFontClear Name FcConfigAppFontClear -- Remove all app fonts from font database Synopsis #include void FcConfigAppFontClear(FcConfig *config); Description Clears the set of application-specific fonts. If config is NULL, the current configuration is used. Version Fontconfig version 2.10.91 FcConfigSubstituteWithPat Name FcConfigSubstituteWithPat -- Execute substitutions Synopsis #include FcBool FcConfigSubstituteWithPat(FcConfig *config, FcPattern *p, FcPattern *p_pat, FcMatchKind kind); Description Performs the sequence of pattern modification operations, if kind is FcMatchPattern, then those tagged as pattern operations are applied, else if kind is FcMatchFont, those tagged as font operations are applied and p_pat is used for elements with target=pattern. Returns FcFalse if the substitution cannot be performed (due to allocation failure). Otherwise returns FcTrue. If config is NULL, the current configuration is used. Version Fontconfig version 2.10.91 FcConfigSubstitute Name FcConfigSubstitute -- Execute substitutions Synopsis #include 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. Version Fontconfig version 2.10.91 FcFontMatch Name FcFontMatch -- Return best font Synopsis #include FcPattern * FcFontMatch(FcConfig *config, FcPattern *p, 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 p; otherwise the results will not be correct. If config is NULL, the current configuration is used. Version Fontconfig version 2.10.91 FcFontSort Name FcFontSort -- Return list of matching fonts Synopsis #include FcFontSet * FcFontSort(FcConfig *config, FcPattern *p, FcBool trim, FcCharSet **csp, FcResult *result); Description Returns the list of fonts sorted by closeness to p. 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 must not modify these patterns. Instead, they should be passed, along with p to FcFontRenderPrepare which combines them into a complete pattern. The FcFontSet returned by FcFontSort is destroyed by calling FcFontSetDestroy. If config is NULL, the current configuration is used. Version Fontconfig version 2.10.91 FcFontRenderPrepare Name FcFontRenderPrepare -- Prepare pattern for loading font file Synopsis #include FcPattern * FcFontRenderPrepare(FcConfig *config, FcPattern *pat, FcPattern *font); Description Creates a new pattern consisting of elements of font not appearing in pat, elements of pat not appearing in font and the best matching value from pat for elements appearing in both. The result is passed to FcConfigSubstituteWithPat with kind FcMatchFont and then returned. Version Fontconfig version 2.10.91 FcFontList Name FcFontList -- List fonts Synopsis #include FcFontSet * FcFontList(FcConfig *config, FcPattern *p, FcObjectSet *os); Description Selects fonts matching p, creates patterns from those fonts containing only the objects in os 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 2.10.91 FcConfigFilename Name FcConfigFilename -- Find a config file Synopsis #include 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 file this references can be overridden with the FONTCONFIG_FILE environment variable. Next, if the name starts with ~, it refers to a file in the current users home directory. Otherwise if the name doesn't start with '/', it refers to a file in the default configuration directory; the built-in default directory can be overridden with the FONTCONFIG_PATH environment variable. Version Fontconfig version 2.10.91 FcConfigParseAndLoad Name FcConfigParseAndLoad -- load a configuration file Synopsis #include 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 not exist. Error and warning messages will be output to stderr. Returns FcFalse if some error occurred while loading the file, either a parse error, semantic error or allocation failure. Otherwise returns FcTrue. Version Fontconfig version 2.10.91 -------------------------------------------------------------------------- FcObjectType Table of Contents [125]FcNameRegisterObjectTypes -- Register object types [126]FcNameUnregisterObjectTypes -- Unregister object types [127]FcNameGetObjectType -- Lookup an object type Provides for application-specified font name object types so that new pattern elements can be generated from font names. FcNameRegisterObjectTypes Name FcNameRegisterObjectTypes -- Register object types Synopsis #include FcBool FcNameRegisterObjectTypes(const FcObjectType *types, int ntype); Description Deprecated. Does nothing. Returns FcFalse. Version Fontconfig version 2.10.91 FcNameUnregisterObjectTypes Name FcNameUnregisterObjectTypes -- Unregister object types Synopsis #include FcBool FcNameUnregisterObjectTypes(const FcObjectType *types, int ntype); Description Deprecated. Does nothing. Returns FcFalse. Version Fontconfig version 2.10.91 FcNameGetObjectType Name FcNameGetObjectType -- Lookup an object type Synopsis #include const FcObjectType * FcNameGetObjectType(const char *object); Description Return the object type for the pattern element named object. Version Fontconfig version 2.10.91 -------------------------------------------------------------------------- FcConstant Table of Contents [128]FcNameRegisterConstants -- Register symbolic constants [129]FcNameUnregisterConstants -- Unregister symbolic constants [130]FcNameGetConstant -- Lookup symbolic constant [131]FcNameConstant -- Get the value for a symbolic constant Provides for application-specified symbolic constants for font names. FcNameRegisterConstants Name FcNameRegisterConstants -- Register symbolic constants Synopsis #include FcBool FcNameRegisterConstants(const FcConstant *consts, int nconsts); Description Deprecated. Does nothing. Returns FcFalse. Version Fontconfig version 2.10.91 FcNameUnregisterConstants Name FcNameUnregisterConstants -- Unregister symbolic constants Synopsis #include FcBool FcNameUnregisterConstants(const FcConstant *consts, int nconsts); Description Deprecated. Does nothing. Returns FcFalse. Version Fontconfig version 2.10.91 FcNameGetConstant Name FcNameGetConstant -- Lookup symbolic constant Synopsis #include const FcConstant * FcNameGetConstant(FcChar8 *string); Description Return the FcConstant structure related to symbolic constant string. Version Fontconfig version 2.10.91 FcNameConstant Name FcNameConstant -- Get the value for a symbolic constant Synopsis #include FcBool FcNameConstant(FcChar8 *string, int *result); Description Returns whether a symbolic constant with name string is registered, placing the value of the constant in result if present. Version Fontconfig version 2.10.91 -------------------------------------------------------------------------- FcBlanks Table of Contents [132]FcBlanksCreate -- Create an FcBlanks [133]FcBlanksDestroy -- Destroy and FcBlanks [134]FcBlanksAdd -- Add a character to an FcBlanks [135]FcBlanksIsMember -- Query membership in an FcBlanks An FcBlanks object holds a list of Unicode chars which are expected to be blank when drawn. When scanning new fonts, any glyphs which are empty and not in this list will be assumed to be broken and not placed in the FcCharSet associated with the font. This provides a significantly more accurate CharSet for applications. FcBlanksCreate Name FcBlanksCreate -- Create an FcBlanks Synopsis #include FcBlanks * FcBlanksCreate(void); Description Creates an empty FcBlanks object. Version Fontconfig version 2.10.91 FcBlanksDestroy Name FcBlanksDestroy -- Destroy and FcBlanks Synopsis #include void FcBlanksDestroy(FcBlanks *b); Description Destroys an FcBlanks object, freeing any associated memory. Version Fontconfig version 2.10.91 FcBlanksAdd Name FcBlanksAdd -- Add a character to an FcBlanks Synopsis #include FcBool FcBlanksAdd(FcBlanks *b, FcChar32 ucs4); Description Adds a single character to an FcBlanks object, returning FcFalse if this process ran out of memory. Version Fontconfig version 2.10.91 FcBlanksIsMember Name FcBlanksIsMember -- Query membership in an FcBlanks Synopsis #include FcBool FcBlanksIsMember(FcBlanks *b, FcChar32 ucs4); Description Returns whether the specified FcBlanks object contains the indicated Unicode value. Version Fontconfig version 2.10.91 -------------------------------------------------------------------------- FcAtomic Table of Contents [136]FcAtomicCreate -- create an FcAtomic object [137]FcAtomicLock -- lock a file [138]FcAtomicNewFile -- return new temporary file name [139]FcAtomicOrigFile -- return original file name [140]FcAtomicReplaceOrig -- replace original with new [141]FcAtomicDeleteNew -- delete new file [142]FcAtomicUnlock -- unlock a file [143]FcAtomicDestroy -- destroy an FcAtomic object These functions provide a safe way to update configuration files, allowing ongoing reading of the old configuration file while locked for writing and ensuring that a consistent and complete version of the configuration file is always available. FcAtomicCreate Name FcAtomicCreate -- create an FcAtomic object Synopsis #include FcAtomic * FcAtomicCreate(const FcChar8 *file); Description Creates a data structure containing data needed to control access to file. Writing is done to a separate file. Once that file is complete, the original configuration file is atomically replaced so that reading process always see a consistent and complete file without the need to lock for reading. Version Fontconfig version 2.10.91 FcAtomicLock Name FcAtomicLock -- lock a file Synopsis #include FcBool FcAtomicLock(FcAtomic *atomic); Description Attempts to lock the file referenced by atomic. Returns FcFalse if the file is already locked, else returns FcTrue and leaves the file locked. Version Fontconfig version 2.10.91 FcAtomicNewFile Name FcAtomicNewFile -- return new temporary file name Synopsis #include FcChar8 * FcAtomicNewFile(FcAtomic *atomic); Description Returns the filename for writing a new version of the file referenced by atomic. Version Fontconfig version 2.10.91 FcAtomicOrigFile Name FcAtomicOrigFile -- return original file name Synopsis #include FcChar8 * FcAtomicOrigFile(FcAtomic *atomic); Description Returns the file referenced by atomic. Version Fontconfig version 2.10.91 FcAtomicReplaceOrig Name FcAtomicReplaceOrig -- replace original with new Synopsis #include FcBool FcAtomicReplaceOrig(FcAtomic *atomic); Description Replaces the original file referenced by atomic with the new file. Returns FcFalse if the file cannot be replaced due to permission issues in the filesystem. Otherwise returns FcTrue. Version Fontconfig version 2.10.91 FcAtomicDeleteNew Name FcAtomicDeleteNew -- delete new file Synopsis #include void FcAtomicDeleteNew(FcAtomic *atomic); Description Deletes the new file. Used in error recovery to back out changes. Version Fontconfig version 2.10.91 FcAtomicUnlock Name FcAtomicUnlock -- unlock a file Synopsis #include void FcAtomicUnlock(FcAtomic *atomic); Description Unlocks the file. Version Fontconfig version 2.10.91 FcAtomicDestroy Name FcAtomicDestroy -- destroy an FcAtomic object Synopsis #include void FcAtomicDestroy(FcAtomic *atomic); Description Destroys atomic. Version Fontconfig version 2.10.91 -------------------------------------------------------------------------- File and Directory routines Table of Contents [144]FcFileScan -- scan a font file [145]FcFileIsDir -- check whether a file is a directory [146]FcDirScan -- scan a font directory without caching it [147]FcDirSave -- DEPRECATED: formerly used to save a directory cache [148]FcDirCacheUnlink -- Remove all caches related to dir [149]FcDirCacheValid -- check directory cache [150]FcDirCacheLoad -- load a directory cache [151]FcDirCacheRead -- read or construct a directory cache [152]FcDirCacheLoadFile -- load a cache file [153]FcDirCacheUnload -- unload a cache file These routines work with font files and directories, including font directory cache files. FcFileScan Name FcFileScan -- scan a font file Synopsis #include FcBool FcFileScan(FcFontSet *set, FcStrSet *dirs, FcFileCache *cache, FcBlanks *blanks, const FcChar8 *file, FcBool force); Description Scans a single file and adds all fonts found to set. If force is FcTrue, then the file is scanned even if associated information is found in cache. If file is a directory, it is added to dirs. Whether fonts are found depends on fontconfig policy as well as the current configuration. Internally, fontconfig will ignore BDF and PCF fonts which are not in Unicode (or the effectively equivalent ISO Latin-1) encoding as those are not usable by Unicode-based applications. The configuration can ignore fonts based on filename or contents of the font file itself. Returns FcFalse if any of the fonts cannot be added (due to allocation failure). Otherwise returns FcTrue. Version Fontconfig version 2.10.91 FcFileIsDir Name FcFileIsDir -- check whether a file is a directory Synopsis #include FcBool FcFileIsDir(const FcChar8 *file); Description Returns FcTrue if file is a directory, otherwise returns FcFalse. Version Fontconfig version 2.10.91 FcDirScan Name FcDirScan -- scan a font directory without caching it Synopsis #include FcBool FcDirScan(FcFontSet *set, FcStrSet *dirs, FcFileCache *cache, FcBlanks *blanks, const FcChar8 *dir, FcBool force); Description If cache is not zero or if force is FcFalse, this function currently returns FcFalse. Otherwise, it scans an entire directory and adds all fonts found to set. Any subdirectories found are added to dirs. Calling this function does not create any cache files. Use FcDirCacheRead() if caching is desired. Version Fontconfig version 2.10.91 FcDirSave Name FcDirSave -- DEPRECATED: formerly used to save a directory cache Synopsis #include FcBool FcDirSave(FcFontSet *set, FcStrSet *dirs, const FcChar8 *dir); Description This function now does nothing aside from returning FcFalse. It used to creates the per-directory cache file for dir and populates it with the fonts in set and subdirectories in dirs. All of this functionality is now automatically managed by FcDirCacheLoad and FcDirCacheRead. Version Fontconfig version 2.10.91 FcDirCacheUnlink Name FcDirCacheUnlink -- Remove all caches related to dir Synopsis #include FcBool FcDirCacheUnlink(const FcChar8 *dir, FcConfig *config); Description Scans the cache directories in config, removing any instances of the cache file for dir. Returns FcFalse when some internal error occurs (out of memory, etc). Errors actually unlinking any files are ignored. Version Fontconfig version 2.10.91 FcDirCacheValid Name FcDirCacheValid -- check directory cache Synopsis #include FcBool FcDirCacheValid(const FcChar8 *dir); Description Returns FcTrue if dir has an associated valid cache file, else returns FcFalse Version Fontconfig version 2.10.91 FcDirCacheLoad Name FcDirCacheLoad -- load a directory cache Synopsis #include FcCache * FcDirCacheLoad(const FcChar8 *dir, FcConfig *config, FcChar8 **cache_file); Description Loads the cache related to dir. If no cache file exists, returns NULL. The name of the cache file is returned in cache_file, unless that is NULL. See also FcDirCacheRead. Version Fontconfig version 2.10.91 FcDirCacheRead Name FcDirCacheRead -- read or construct a directory cache Synopsis #include FcCache * FcDirCacheRead(const FcChar8 *dir, FcBool force, FcConfig *config); Description This returns a cache for dir. If force is FcFalse, then an existing, valid cache file will be used. Otherwise, a new cache will be created by scanning the directory and that returned. Version Fontconfig version 2.10.91 FcDirCacheLoadFile Name FcDirCacheLoadFile -- load a cache file Synopsis #include FcCache * FcDirCacheLoadFile(const FcChar8 *cache_file, struct stat *file_stat); Description This function loads a directory cache from cache_file. If file_stat is non-NULL, it will be filled with the results of stat(2) on the cache file. Version Fontconfig version 2.10.91 FcDirCacheUnload Name FcDirCacheUnload -- unload a cache file Synopsis #include void FcDirCacheUnload(FcCache *cache); Description This function dereferences cache. When no other references to it remain, all memory associated with the cache will be freed. Version Fontconfig version 2.10.91 -------------------------------------------------------------------------- FcCache routines Table of Contents [154]FcCacheDir -- Return directory of cache [155]FcCacheCopySet -- Returns a copy of the fontset from cache [156]FcCacheSubdir -- Return the i'th subdirectory. [157]FcCacheNumSubdir -- Return the number of subdirectories in cache. [158]FcCacheNumFont -- Returns the number of fonts in cache. [159]FcDirCacheClean -- This tries to clean up the cache directory of cache_dir. This returns FcTrue if the operation is successfully complete. otherwise FcFalse. [160]FcCacheCreateTagFile -- Create CACHEDIR.TAG at cache directory. These routines work with font directory caches, accessing their contents in limited ways. It is not expected that normal applications will need to use these functions. FcCacheDir Name FcCacheDir -- Return directory of cache Synopsis #include const FcChar8 * FcCacheDir(const FcCache *cache); Description This function returns the directory from which the cache was constructed. Version Fontconfig version 2.10.91 FcCacheCopySet Name FcCacheCopySet -- Returns a copy of the fontset from cache Synopsis #include FcFontSet * FcCacheCopySet(const FcCache *cache); Description The returned fontset contains each of the font patterns from cache. This fontset may be modified, but the patterns from the cache are read-only. Version Fontconfig version 2.10.91 FcCacheSubdir Name FcCacheSubdir -- Return the i'th subdirectory. Synopsis #include const FcChar8 * FcCacheSubdir(const FcCache *cache, inti); Description The set of subdirectories stored in a cache file are indexed by this function, i should range from 0 to n-1, where n is the return value from FcCacheNumSubdir. Version Fontconfig version 2.10.91 FcCacheNumSubdir Name FcCacheNumSubdir -- Return the number of subdirectories in cache. Synopsis #include int FcCacheNumSubdir(const FcCache *cache); Description This returns the total number of subdirectories in the cache. Version Fontconfig version 2.10.91 FcCacheNumFont Name FcCacheNumFont -- Returns the number of fonts in cache. Synopsis #include int FcCacheNumFont(const FcCache *cache); Description This returns the number of fonts which would be included in the return from FcCacheCopySet. Version Fontconfig version 2.10.91 FcDirCacheClean Name FcDirCacheClean -- This tries to clean up the cache directory of cache_dir. This returns FcTrue if the operation is successfully complete. otherwise FcFalse. Synopsis #include FcBool FcDirCacheClean(const FcChar8 *cache_dir, FcBoolverbose); Description Version Fontconfig version 2.10.91 FcCacheCreateTagFile Name FcCacheCreateTagFile -- Create CACHEDIR.TAG at cache directory. Synopsis #include void FcCacheCreateTagFile(const FcConfig *config); Description This tries to create CACHEDIR.TAG file at the cache directory registered to config. Version Fontconfig version 2.10.91 -------------------------------------------------------------------------- FcStrSet and FcStrList Table of Contents [161]FcStrSetCreate -- create a string set [162]FcStrSetMember -- check set for membership [163]FcStrSetEqual -- check sets for equality [164]FcStrSetAdd -- add to a string set [165]FcStrSetAddFilename -- add a filename to a string set [166]FcStrSetDel -- delete from a string set [167]FcStrSetDestroy -- destroy a string set [168]FcStrListCreate -- create a string iterator [169]FcStrListNext -- get next string in iteration [170]FcStrListDone -- destroy a string iterator A data structure for enumerating strings, used to list directories while scanning the configuration as directories are added while scanning. FcStrSetCreate Name FcStrSetCreate -- create a string set Synopsis #include FcStrSet * FcStrSetCreate(void); Description Create an empty set. Version Fontconfig version 2.10.91 FcStrSetMember Name FcStrSetMember -- check set for membership Synopsis #include FcBool FcStrSetMember(FcStrSet *set, const FcChar8 *s); Description Returns whether s is a member of set. Version Fontconfig version 2.10.91 FcStrSetEqual Name FcStrSetEqual -- check sets for equality Synopsis #include FcBool FcStrSetEqual(FcStrSet *set_a, FcStrSet *set_b); Description Returns whether set_a contains precisely the same strings as set_b. Ordering of strings within the two sets is not considered. Version Fontconfig version 2.10.91 FcStrSetAdd Name FcStrSetAdd -- add to a string set Synopsis #include FcBool FcStrSetAdd(FcStrSet *set, const FcChar8 *s); Description Adds a copy of s to set. Version Fontconfig version 2.10.91 FcStrSetAddFilename Name FcStrSetAddFilename -- add a filename to a string set Synopsis #include FcBool FcStrSetAddFilename(FcStrSet *set, const FcChar8 *s); Description Adds a copy s to set, The copy is created with FcStrCopyFilename so that leading '~' values are replaced with the value of the HOME environment variable. Version Fontconfig version 2.10.91 FcStrSetDel Name FcStrSetDel -- delete from a string set Synopsis #include FcBool FcStrSetDel(FcStrSet *set, const FcChar8 *s); Description Removes s from set, returning FcTrue if s was a member else FcFalse. Version Fontconfig version 2.10.91 FcStrSetDestroy Name FcStrSetDestroy -- destroy a string set Synopsis #include void FcStrSetDestroy(FcStrSet *set); Description Destroys set. Version Fontconfig version 2.10.91 FcStrListCreate Name FcStrListCreate -- create a string iterator Synopsis #include FcStrList * FcStrListCreate(FcStrSet *set); Description Creates an iterator to list the strings in set. Version Fontconfig version 2.10.91 FcStrListNext Name FcStrListNext -- get next string in iteration Synopsis #include FcChar8 * FcStrListNext(FcStrList *list); Description Returns the next string in set. Version Fontconfig version 2.10.91 FcStrListDone Name FcStrListDone -- destroy a string iterator Synopsis #include void FcStrListDone(FcStrList *list); Description Destroys the enumerator list. Version Fontconfig version 2.10.91 -------------------------------------------------------------------------- String utilities Table of Contents [171]FcUtf8ToUcs4 -- convert UTF-8 to UCS4 [172]FcUcs4ToUtf8 -- convert UCS4 to UTF-8 [173]FcUtf8Len -- count UTF-8 encoded chars [174]FcUtf16ToUcs4 -- convert UTF-16 to UCS4 [175]FcUtf16Len -- count UTF-16 encoded chars [176]FcIsLower -- check for lower case ASCII character [177]FcIsUpper -- check for upper case ASCII character [178]FcToLower -- convert upper case ASCII to lower case [179]FcStrCopy -- duplicate a string [180]FcStrDowncase -- create a lower case translation of a string [181]FcStrCopyFilename -- create a complete path from a filename [182]FcStrCmp -- compare UTF-8 strings [183]FcStrCmpIgnoreCase -- compare UTF-8 strings ignoring case [184]FcStrStr -- locate UTF-8 substring [185]FcStrStrIgnoreCase -- locate UTF-8 substring ignoring ASCII case [186]FcStrPlus -- concatenate two strings [187]FcStrFree -- free a string [188]FcStrDirname -- directory part of filename [189]FcStrBasename -- last component of filename Fontconfig manipulates many UTF-8 strings represented with the FcChar8 type. These functions are exposed to help applications deal with these UTF-8 strings in a locale-insensitive manner. FcUtf8ToUcs4 Name FcUtf8ToUcs4 -- convert UTF-8 to UCS4 Synopsis #include int FcUtf8ToUcs4(FcChar8 *src, FcChar32 *dst, int len); Description Converts the next Unicode char from src into dst and returns the number of bytes containing the char. src must be at least len bytes long. Version Fontconfig version 2.10.91 FcUcs4ToUtf8 Name FcUcs4ToUtf8 -- convert UCS4 to UTF-8 Synopsis #include int FcUcs4ToUtf8(FcChar32 src, FcChar8 dst[FC_UTF8_MAX_LEN]); Description Converts the Unicode char from src into dst and returns the number of bytes needed to encode the char. Version Fontconfig version 2.10.91 FcUtf8Len Name FcUtf8Len -- count UTF-8 encoded chars Synopsis #include FcBool FcUtf8Len(FcChar8 *src, int len, int *nchar, int *wchar); Description Counts the number of Unicode chars in len bytes of src. Places that count in nchar. wchar contains 1, 2 or 4 depending on the number of bytes needed to hold the largest Unicode char counted. The return value indicates whether src is a well-formed UTF8 string. Version Fontconfig version 2.10.91 FcUtf16ToUcs4 Name FcUtf16ToUcs4 -- convert UTF-16 to UCS4 Synopsis #include int FcUtf16ToUcs4(FcChar8 *src, FcEndian endian, FcChar32 *dst, int len); Description Converts the next Unicode char from src into dst and returns the number of bytes containing the char. src must be at least len bytes long. Bytes of src are combined into 16-bit units according to endian. Version Fontconfig version 2.10.91 FcUtf16Len Name FcUtf16Len -- count UTF-16 encoded chars Synopsis #include FcBool FcUtf16Len(FcChar8 *src, FcEndian endian, int len, int *nchar, int *wchar); Description Counts the number of Unicode chars in len bytes of src. Bytes of src are combined into 16-bit units according to endian. Places that count in nchar. wchar contains 1, 2 or 4 depending on the number of bytes needed to hold the largest Unicode char counted. The return value indicates whether string is a well-formed UTF16 string. Version Fontconfig version 2.10.91 FcIsLower Name FcIsLower -- check for lower case ASCII character Synopsis #include FcBool FcIsLower(FcChar8c); Description This macro checks whether c is an lower case ASCII letter. Version Fontconfig version 2.10.91 FcIsUpper Name FcIsUpper -- check for upper case ASCII character Synopsis #include FcBool FcIsUpper(FcChar8c); Description This macro checks whether c is a upper case ASCII letter. Version Fontconfig version 2.10.91 FcToLower Name FcToLower -- convert upper case ASCII to lower case Synopsis #include FcChar8 FcToLower(FcChar8c); Description This macro converts upper case ASCII c to the equivalent lower case letter. Version Fontconfig version 2.10.91 FcStrCopy Name FcStrCopy -- duplicate a string Synopsis #include FcChar8 * FcStrCopy(const FcChar8 *s); Description Allocates memory, copies s and returns the resulting buffer. Yes, this is strdup, but that function isn't available on every platform. Version Fontconfig version 2.10.91 FcStrDowncase Name FcStrDowncase -- create a lower case translation of a string Synopsis #include FcChar8 * FcStrDowncase(const FcChar8 *s); Description Allocates memory, copies s, converting upper case letters to lower case and returns the allocated buffer. Version Fontconfig version 2.10.91 FcStrCopyFilename Name FcStrCopyFilename -- create a complete path from a filename Synopsis #include FcChar8 * FcStrCopyFilename(const FcChar8 *s); Description FcStrCopyFilename constructs an absolute pathname from s. It converts any leading '~' characters in to the value of the HOME environment variable, and any relative paths are converted to absolute paths using the current working directory. Sequences of '/' characters are converted to a single '/', and names containing the current directory '.' or parent directory '..' are correctly reconstructed. Returns NULL if '~' is the leading character and HOME is unset or disabled (see FcConfigEnableHome). Version Fontconfig version 2.10.91 FcStrCmp Name FcStrCmp -- compare UTF-8 strings Synopsis #include int FcStrCmp(const FcChar8 *s1, const FcChar8 *s2); Description Returns the usual <0, 0, >0 result of comparing s1 and s2. Version Fontconfig version 2.10.91 FcStrCmpIgnoreCase Name FcStrCmpIgnoreCase -- compare UTF-8 strings ignoring case Synopsis #include int FcStrCmpIgnoreCase(const FcChar8 *s1, const FcChar8 *s2); Description Returns the usual <0, 0, >0 result of comparing s1 and s2. This test is case-insensitive for all proper UTF-8 encoded strings. Version Fontconfig version 2.10.91 FcStrStr Name FcStrStr -- locate UTF-8 substring Synopsis #include FcChar8 * FcStrStr(const FcChar8 *s1, const FcChar8 *s2); Description Returns the location of s2 in s1. Returns NULL if s2 is not present in s1. This test will operate properly with UTF8 encoded strings. Version Fontconfig version 2.10.91 FcStrStrIgnoreCase Name FcStrStrIgnoreCase -- locate UTF-8 substring ignoring ASCII case Synopsis #include FcChar8 * FcStrStrIgnoreCase(const FcChar8 *s1, const FcChar8 *s2); Description Returns the location of s2 in s1, ignoring case. Returns NULL if s2 is not present in s1. This test is case-insensitive for all proper UTF-8 encoded strings. Version Fontconfig version 2.10.91 FcStrPlus Name FcStrPlus -- concatenate two strings Synopsis #include FcChar8 * FcStrPlus(const FcChar8 *s1, const FcChar8 *s2); Description This function allocates new storage and places the concatenation of s1 and s2 there, returning the new string. Version Fontconfig version 2.10.91 FcStrFree Name FcStrFree -- free a string Synopsis #include void FcStrFree(FcChar8 *s); Description This is just a wrapper around free(3) which helps track memory usage of strings within the fontconfig library. Version Fontconfig version 2.10.91 FcStrDirname Name FcStrDirname -- directory part of filename Synopsis #include FcChar8 * FcStrDirname(const FcChar8 *file); Description Returns the directory containing file. This is returned in newly allocated storage which should be freed when no longer needed. Version Fontconfig version 2.10.91 FcStrBasename Name FcStrBasename -- last component of filename Synopsis #include FcChar8 * FcStrBasename(const FcChar8 *file); Description Returns the filename of file stripped of any leading directory names. This is returned in newly allocated storage which should be freed when no longer needed. Version Fontconfig version 2.10.91 References Visible links 1. file:///tmp/html-l8lfPm#AEN16 2. file:///tmp/html-l8lfPm#AEN19 3. file:///tmp/html-l8lfPm#AEN31 4. file:///tmp/html-l8lfPm#AEN102 5. file:///tmp/html-l8lfPm#FCINITLOADCONFIG 6. file:///tmp/html-l8lfPm#FCINITLOADCONFIGANDFONTS 7. file:///tmp/html-l8lfPm#FCINIT 8. file:///tmp/html-l8lfPm#FCFINI 9. file:///tmp/html-l8lfPm#FCGETVERSION 10. file:///tmp/html-l8lfPm#FCINITREINITIALIZE 11. file:///tmp/html-l8lfPm#FCINITBRINGUPTODATE 12. file:///tmp/html-l8lfPm#FCPATTERNCREATE 13. file:///tmp/html-l8lfPm#FCPATTERNDUPLICATE 14. file:///tmp/html-l8lfPm#FCPATTERNREFERENCE 15. file:///tmp/html-l8lfPm#FCPATTERNDESTROY 16. file:///tmp/html-l8lfPm#FCPATTERNEQUAL 17. file:///tmp/html-l8lfPm#FCPATTERNEQUALSUBSET 18. file:///tmp/html-l8lfPm#FCPATTERNFILTER 19. file:///tmp/html-l8lfPm#FCPATTERNHASH 20. file:///tmp/html-l8lfPm#FCPATTERNADD 21. file:///tmp/html-l8lfPm#FCPATTERNADDWEAK 22. file:///tmp/html-l8lfPm#FCPATTERNADD-TYPE 23. file:///tmp/html-l8lfPm#FCPATTERNGET 24. file:///tmp/html-l8lfPm#FCPATTERNGET-TYPE 25. file:///tmp/html-l8lfPm#FCPATTERNBUILD 26. file:///tmp/html-l8lfPm#FCPATTERNDEL 27. file:///tmp/html-l8lfPm#FCPATTERNREMOVE 28. file:///tmp/html-l8lfPm#FCPATTERNPRINT 29. file:///tmp/html-l8lfPm#FCDEFAULTSUBSTITUTE 30. file:///tmp/html-l8lfPm#FCNAMEPARSE 31. file:///tmp/html-l8lfPm#FCNAMEUNPARSE 32. file:///tmp/html-l8lfPm#FCPATTERNFORMAT 33. file:///tmp/html-l8lfPm#FCFONTSETCREATE 34. file:///tmp/html-l8lfPm#FCFONTSETDESTROY 35. file:///tmp/html-l8lfPm#FCFONTSETADD 36. file:///tmp/html-l8lfPm#FCFONTSETLIST 37. file:///tmp/html-l8lfPm#FCFONTSETMATCH 38. file:///tmp/html-l8lfPm#FCFONTSETPRINT 39. file:///tmp/html-l8lfPm#FCFONTSETSORT 40. file:///tmp/html-l8lfPm#FCFONTSETSORTDESTROY 41. file:///tmp/html-l8lfPm#FCOBJECTSETCREATE 42. file:///tmp/html-l8lfPm#FCOBJECTSETADD 43. file:///tmp/html-l8lfPm#FCOBJECTSETDESTROY 44. file:///tmp/html-l8lfPm#FCOBJECTSETBUILD 45. file:///tmp/html-l8lfPm#FCFREETYPECHARINDEX 46. file:///tmp/html-l8lfPm#FCFREETYPECHARSET 47. file:///tmp/html-l8lfPm#FCFREETYPECHARSETANDSPACING 48. file:///tmp/html-l8lfPm#FCFREETYPEQUERY 49. file:///tmp/html-l8lfPm#FCFREETYPEQUERYFACE 50. file:///tmp/html-l8lfPm#FCVALUEDESTROY 51. file:///tmp/html-l8lfPm#FCVALUESAVE 52. file:///tmp/html-l8lfPm#FCVALUEPRINT 53. file:///tmp/html-l8lfPm#FCVALUEEQUAL 54. file:///tmp/html-l8lfPm#FCCHARSETCREATE 55. file:///tmp/html-l8lfPm#FCCHARSETDESTROY 56. file:///tmp/html-l8lfPm#FCCHARSETADDCHAR 57. file:///tmp/html-l8lfPm#FCCHARSETDELCHAR 58. file:///tmp/html-l8lfPm#FCCHARSETCOPY 59. file:///tmp/html-l8lfPm#FCCHARSETEQUAL 60. file:///tmp/html-l8lfPm#FCCHARSETINTERSECT 61. file:///tmp/html-l8lfPm#FCCHARSETUNION 62. file:///tmp/html-l8lfPm#FCCHARSETSUBTRACT 63. file:///tmp/html-l8lfPm#FCCHARSETMERGE 64. file:///tmp/html-l8lfPm#FCCHARSETHASCHAR 65. file:///tmp/html-l8lfPm#FCCHARSETCOUNT 66. file:///tmp/html-l8lfPm#FCCHARSETINTERSECTCOUNT 67. file:///tmp/html-l8lfPm#FCCHARSETSUBTRACTCOUNT 68. file:///tmp/html-l8lfPm#FCCHARSETISSUBSET 69. file:///tmp/html-l8lfPm#FCCHARSETFIRSTPAGE 70. file:///tmp/html-l8lfPm#FCCHARSETNEXTPAGE 71. file:///tmp/html-l8lfPm#FCCHARSETCOVERAGE 72. file:///tmp/html-l8lfPm#FCCHARSETNEW 73. file:///tmp/html-l8lfPm#FCLANGSETCREATE 74. file:///tmp/html-l8lfPm#FCLANGSETDESTROY 75. file:///tmp/html-l8lfPm#FCLANGSETCOPY 76. file:///tmp/html-l8lfPm#FCLANGSETADD 77. file:///tmp/html-l8lfPm#FCLANGSETDEL 78. file:///tmp/html-l8lfPm#FCLANGSETUNION 79. file:///tmp/html-l8lfPm#FCLANGSETSUBTRACT 80. file:///tmp/html-l8lfPm#FCLANGSETCOMPARE 81. file:///tmp/html-l8lfPm#FCLANGSETCONTAINS 82. file:///tmp/html-l8lfPm#FCLANGSETEQUAL 83. file:///tmp/html-l8lfPm#FCLANGSETHASH 84. file:///tmp/html-l8lfPm#FCLANGSETHASLANG 85. file:///tmp/html-l8lfPm#FCGETDEFAULTLANGS 86. file:///tmp/html-l8lfPm#FCGETLANGS 87. file:///tmp/html-l8lfPm#FCLANGNORMALIZE 88. file:///tmp/html-l8lfPm#FCLANGGETCHARSET 89. file:///tmp/html-l8lfPm#FCMATRIXINIT 90. file:///tmp/html-l8lfPm#FCMATRIXCOPY 91. file:///tmp/html-l8lfPm#FCMATRIXEQUAL 92. file:///tmp/html-l8lfPm#FCMATRIXMULTIPLY 93. file:///tmp/html-l8lfPm#FCMATRIXROTATE 94. file:///tmp/html-l8lfPm#FCMATRIXSCALE 95. file:///tmp/html-l8lfPm#FCMATRIXSHEAR 96. file:///tmp/html-l8lfPm#FCCONFIGCREATE 97. file:///tmp/html-l8lfPm#FCCONFIGREFERENCE 98. file:///tmp/html-l8lfPm#FCCONFIGDESTROY 99. file:///tmp/html-l8lfPm#FCCONFIGSETCURRENT 100. file:///tmp/html-l8lfPm#FCCONFIGGETCURRENT 101. file:///tmp/html-l8lfPm#FCCONFIGUPTODATE 102. file:///tmp/html-l8lfPm#FCCONFIGHOME 103. file:///tmp/html-l8lfPm#FCCONFIGENABLEHOME 104. file:///tmp/html-l8lfPm#FCCONFIGBUILDFONTS 105. file:///tmp/html-l8lfPm#FCCONFIGGETCONFIGDIRS 106. file:///tmp/html-l8lfPm#FCCONFIGGETFONTDIRS 107. file:///tmp/html-l8lfPm#FCCONFIGGETCONFIGFILES 108. file:///tmp/html-l8lfPm#FCCONFIGGETCACHE 109. file:///tmp/html-l8lfPm#FCCONFIGGETCACHEDIRS 110. file:///tmp/html-l8lfPm#FCCONFIGGETFONTS 111. file:///tmp/html-l8lfPm#FCCONFIGGETBLANKS 112. file:///tmp/html-l8lfPm#FCCONFIGGETRESCANINTERVAL 113. file:///tmp/html-l8lfPm#FCCONFIGSETRESCANINTERVAL 114. file:///tmp/html-l8lfPm#FCCONFIGAPPFONTADDFILE 115. file:///tmp/html-l8lfPm#FCCONFIGAPPFONTADDDIR 116. file:///tmp/html-l8lfPm#FCCONFIGAPPFONTCLEAR 117. file:///tmp/html-l8lfPm#FCCONFIGSUBSTITUTEWITHPAT 118. file:///tmp/html-l8lfPm#FCCONFIGSUBSTITUTE 119. file:///tmp/html-l8lfPm#FCFONTMATCH 120. file:///tmp/html-l8lfPm#FCFONTSORT 121. file:///tmp/html-l8lfPm#FCFONTRENDERPREPARE 122. file:///tmp/html-l8lfPm#FCFONTLIST 123. file:///tmp/html-l8lfPm#FCCONFIGFILENAME 124. file:///tmp/html-l8lfPm#FCCONFIGPARSEANDLOAD 125. file:///tmp/html-l8lfPm#FCNAMEREGISTEROBJECTTYPES 126. file:///tmp/html-l8lfPm#FCNAMEUNREGISTEROBJECTTYPES 127. file:///tmp/html-l8lfPm#FCNAMEGETOBJECTTYPE 128. file:///tmp/html-l8lfPm#FCNAMEREGISTERCONSTANTS 129. file:///tmp/html-l8lfPm#FCNAMEUNREGISTERCONSTANTS 130. file:///tmp/html-l8lfPm#FCNAMEGETCONSTANT 131. file:///tmp/html-l8lfPm#FCNAMECONSTANT 132. file:///tmp/html-l8lfPm#FCBLANKSCREATE 133. file:///tmp/html-l8lfPm#FCBLANKSDESTROY 134. file:///tmp/html-l8lfPm#FCBLANKSADD 135. file:///tmp/html-l8lfPm#FCBLANKSISMEMBER 136. file:///tmp/html-l8lfPm#FCATOMICCREATE 137. file:///tmp/html-l8lfPm#FCATOMICLOCK 138. file:///tmp/html-l8lfPm#FCATOMICNEWFILE 139. file:///tmp/html-l8lfPm#FCATOMICORIGFILE 140. file:///tmp/html-l8lfPm#FCATOMICREPLACEORIG 141. file:///tmp/html-l8lfPm#FCATOMICDELETENEW 142. file:///tmp/html-l8lfPm#FCATOMICUNLOCK 143. file:///tmp/html-l8lfPm#FCATOMICDESTROY 144. file:///tmp/html-l8lfPm#FCFILESCAN 145. file:///tmp/html-l8lfPm#FCFILEISDIR 146. file:///tmp/html-l8lfPm#FCDIRSCAN 147. file:///tmp/html-l8lfPm#FCDIRSAVE 148. file:///tmp/html-l8lfPm#FCDIRCACHEUNLINK 149. file:///tmp/html-l8lfPm#FCDIRCACHEVALID 150. file:///tmp/html-l8lfPm#FCDIRCACHELOAD 151. file:///tmp/html-l8lfPm#FCDIRCACHEREAD 152. file:///tmp/html-l8lfPm#FCDIRCACHELOADFILE 153. file:///tmp/html-l8lfPm#FCDIRCACHEUNLOAD 154. file:///tmp/html-l8lfPm#FCCACHEDIR 155. file:///tmp/html-l8lfPm#FCCACHECOPYSET 156. file:///tmp/html-l8lfPm#FCCACHESUBDIR 157. file:///tmp/html-l8lfPm#FCCACHENUMSUBDIR 158. file:///tmp/html-l8lfPm#FCCACHENUMFONT 159. file:///tmp/html-l8lfPm#FCDIRCACHECLEAN 160. file:///tmp/html-l8lfPm#FCCACHECREATETAGFILE 161. file:///tmp/html-l8lfPm#FCSTRSETCREATE 162. file:///tmp/html-l8lfPm#FCSTRSETMEMBER 163. file:///tmp/html-l8lfPm#FCSTRSETEQUAL 164. file:///tmp/html-l8lfPm#FCSTRSETADD 165. file:///tmp/html-l8lfPm#FCSTRSETADDFILENAME 166. file:///tmp/html-l8lfPm#FCSTRSETDEL 167. file:///tmp/html-l8lfPm#FCSTRSETDESTROY 168. file:///tmp/html-l8lfPm#FCSTRLISTCREATE 169. file:///tmp/html-l8lfPm#FCSTRLISTNEXT 170. file:///tmp/html-l8lfPm#FCSTRLISTDONE 171. file:///tmp/html-l8lfPm#FCUTF8TOUCS4 172. file:///tmp/html-l8lfPm#FCUCS4TOUTF8 173. file:///tmp/html-l8lfPm#FCUTF8LEN 174. file:///tmp/html-l8lfPm#FCUTF16TOUCS4 175. file:///tmp/html-l8lfPm#FCUTF16LEN 176. file:///tmp/html-l8lfPm#FCISLOWER 177. file:///tmp/html-l8lfPm#FCISUPPER 178. file:///tmp/html-l8lfPm#FCTOLOWER 179. file:///tmp/html-l8lfPm#FCSTRCOPY 180. file:///tmp/html-l8lfPm#FCSTRDOWNCASE 181. file:///tmp/html-l8lfPm#FCSTRCOPYFILENAME 182. file:///tmp/html-l8lfPm#FCSTRCMP 183. file:///tmp/html-l8lfPm#FCSTRCMPIGNORECASE 184. file:///tmp/html-l8lfPm#FCSTRSTR 185. file:///tmp/html-l8lfPm#FCSTRSTRIGNORECASE 186. file:///tmp/html-l8lfPm#FCSTRPLUS 187. file:///tmp/html-l8lfPm#FCSTRFREE 188. file:///tmp/html-l8lfPm#FCSTRDIRNAME 189. file:///tmp/html-l8lfPm#FCSTRBASENAME