fontconfig-2.4.2/ 0040777 0002720 0000144 00000000000 11602300264 011651 5 ustar users fontconfig-2.4.2/doc/ 0040777 0002720 0000144 00000000000 10534406441 012425 5 ustar users fontconfig-2.4.2/doc/fontconfig-devel/ 0040777 0002720 0000144 00000000000 10534406441 015656 5 ustar users fontconfig-2.4.2/doc/fontconfig-devel/index.html 0100664 0002720 0000144 00000037575 10534406407 017671 0 ustar users
Fontconfig Developers Reference, Version 2.4.2
HP Cambridge Research Lab
Fontconfig is a library designed to provide system-wide font configuration,
customization and application access.
FcFreeTypeQuery Name FcFreeTypeQuery -- compute pattern from font file (and index)
Synopsis
#include <fontconfig.h>
#include <fcfreetype.h>
FcPattern * FcFreeTypeQuery(const char *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.4.2
FcFreeTypeQueryFace Name FcFreeTypeQueryFace -- compute pattern from FT_Face
Synopsis
#include <fontconfig.h>
#include <fcfreetype.h>
FcPattern * FcFreeTypeQueryFace(const FT_Face face, const char *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.4.2
FcValueDestroy Name FcValueDestroy -- Free a value
Synopsis
#include <fontconfig.h>
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.4.2
FcValueSave Name FcValueSave -- Copy a value
Synopsis
#include <fontconfig.h>
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.4.2
FcCharSetCreate Name FcCharSetCreate -- Create an empty character set
Synopsis
#include <fontconfig.h>
FcCharSet * FcCharSetCreate(void);
Description FcCharSetCreate allocates and initializes a new empty
character set object.
Version Fontconfig version 2.4.2
FcCharSetDestroy Name FcCharSetDestroy -- Destroy a character set
Synopsis
#include <fontconfig.h>
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.4.2
FcCharSetAddChar Name FcCharSetAddChar -- Add a character to a charset
Synopsis
#include <fontconfig.h>
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.4.2
FcCharSetCopy Name FcCharSetCopy -- Copy a charset
Synopsis
#include <fontconfig.h>
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.4.2
FcCharSetEqual Name FcCharSetEqual -- Compare two charsets
Synopsis
#include <fontconfig.h>
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.4.2
FcInitLoadConfigAndFonts Name FcInitLoadConfigAndFonts -- load configuration and font data
Synopsis
#include <fontconfig.h>
FcConfig * FcInitLoadConfigAndFonts(void);
Description Loads the default configuration file and builds information about the
available fonts. Returns the resulting configuration.
Version Fontconfig version 2.4.2
FcCharSetIntersect Name FcCharSetIntersect -- Intersect charsets
Synopsis
#include <fontconfig.h>
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.4.2
FcCharSetUnion Name FcCharSetUnion -- Add charsets
Synopsis
#include <fontconfig.h>
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.4.2
FcCharSetSubtract Name FcCharSetSubtract -- Subtract charsets
Synopsis
#include <fontconfig.h>
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.4.2
FcCharSetHasChar Name FcCharSetHasChar -- Check a charset for a char
Synopsis
#include <fontconfig.h>
FcBool FcCharSetHasChar(const FcCharSet *fcs, FcChar32 ucs4);
Description Returns whether fcs contains the char ucs4.
Version Fontconfig version 2.4.2
FcCharSetCount Name FcCharSetCount -- Count entries in a charset
Synopsis
#include <fontconfig.h>
FcChar32 FcCharSetCount(const FcCharSet *a);
Description Returns the total number of unicode chars in a.
Version Fontconfig version 2.4.2
FcCharSetIntersectCount Name FcCharSetIntersectCount -- Intersect and count charsets
Synopsis
#include <fontconfig.h>
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.4.2
FcCharSetSubtractCount Name FcCharSetSubtractCount -- Subtract and count charsets
Synopsis
#include <fontconfig.h>
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.4.2
FcCharSetIsSubset Name FcCharSetIsSubset -- Test for charset inclusion
Synopsis
#include <fontconfig.h>
FcBool FcCharSetIsSubset(const FcCharSet *a, const FcCharSet *b);
Description Returns whether a is a subset of b.
Version Fontconfig version 2.4.2
FcInit Name FcInit -- initialize fontconfig library
Synopsis
#include <fontconfig.h>
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.4.2
FcCharSetFirstPage Name FcCharSetFirstPage -- Start enumerating charset contents
Synopsis
#include <fontconfig.h>
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.4.2
FcCharSetNextPage Name FcCharSetNextPage -- Continue enumerating charset contents
Synopsis
#include <fontconfig.h>
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.4.2
FcMatrixInit Name FcMatrixInit -- initialize an FcMatrix structure
Synopsis
#include <fontconfig.h>
void FcMatrixInit(FcMatrix *matrix);
Description FcMatrixInit initializes matrix
to the identity matrix.
Version Fontconfig version 2.4.2
FcMatrixCopy Name FcMatrixCopy -- Copy a matrix
Synopsis
#include <fontconfig.h>
void FcMatrixCopy(const FcMatrix *matrix);
Description FcMatrixCopy allocates a new FcMatrix
and copies mat into it.
Version Fontconfig version 2.4.2
FcMatrixEqual Name FcMatrixEqual -- Compare two matrices
Synopsis
#include <fontconfig.h>
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.4.2
FcMatrixMultiply Name FcMatrixMultiply -- Multiply matrices
Synopsis
#include <fontconfig.h>
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.4.2
FcMatrixRotate Name FcMatrixRotate -- Rotate a matrix
Synopsis
#include <fontconfig.h>
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.4.2
FcMatrixScale Name FcMatrixScale -- Scale a matrix
Synopsis
#include <fontconfig.h>
void FcMatrixScale(FcMatrix *matrix, double sx, double dy);
Description FcMatrixScale multiplies matrix
x values by sx and y values by
sy. This is done by multiplying by
the matrix:
sx 0
0 sy
Version Fontconfig version 2.4.2
FcFini Name FcFini -- finalize fonconfig library
Synopsis
#include <fontconfig.h>
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.4.2
FcMatrixShear Name FcMatrixShear -- Shear a matrix
Synopsis
#include <fontconfig.h>
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.4.2
FcConfigCreate Name FcConfigCreate -- Create a configuration
Synopsis
#include <fontconfig.h>
FcConfig * FcConfigCreate(void);
Description Creates an empty configuration.
Version Fontconfig version 2.4.2
FcConfigDestroy Name FcConfigDestroy -- Destroy a configuration
Synopsis
#include <fontconfig.h>
void FcConfigDestroy(FcConfig *config);
Description Destroys a configuration and any data associated with it. Note that calling
this function with the return from FcConfigGetCurrent will place the library
in an indeterminate state.
Version Fontconfig version 2.4.2
FcConfigSetCurrent Name FcConfigSetCurrent -- Set configuration as default
Synopsis
#include <fontconfig.h>
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.4.2
FcConfigGetCurrent Name FcConfigGetCurrent -- Return current configuration
Synopsis
#include <fontconfig.h>
FcConfig * FcConfigGetCurrent(void);
Description Returns the current default configuration.
Version Fontconfig version 2.4.2
FcConfigUptoDate Name FcConfigUptoDate -- Check timestamps on config files
Synopsis
#include <fontconfig.h>
FcBool FcConfigUptoDate(FcConfig *config);
Description Checks all of the files related to config and returns whether the
in-memory version is in sync with the disk version.
Version Fontconfig version 2.4.2
FcConfigBuildFonts Name FcConfigBuildFonts -- Build font database
Synopsis
#include <fontconfig.h>
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.
Version Fontconfig version 2.4.2
FcConfigGetConfigDirs Name FcConfigGetConfigDirs -- Get config directories
Synopsis
#include <fontconfig.h>
FcStrList * FcConfigGetConfigDirs(FcConfig *config);
Description Returns the list of font directories specified in the configuration files
for config. Does not include any subdirectories.
Version Fontconfig version 2.4.2
FcConfigGetFontDirs Name FcConfigGetFontDirs -- Get font directories
Synopsis
#include <fontconfig.h>
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.
Version Fontconfig version 2.4.2
FcGetVersion Name FcGetVersion -- library version number
Synopsis
#include <fontconfig.h>
int FcGetVersion(void);
Description Returns the version number of the library.
Version Fontconfig version 2.4.2
FcConfigGetConfigFiles Name FcConfigGetConfigFiles -- Get config files
Synopsis
#include <fontconfig.h>
FcStrList * FcConfigGetConfigFiles(FcConfig *config);
Description Returns the list of known configuration files used to generate config.
Note that this will not include any configuration done with FcConfigParse.
Version Fontconfig version 2.4.2
FcConfigGetCache Name FcConfigGetCache -- Get cache filename
Synopsis
#include <fontconfig.h>
char * FcConfigGetCache(FcConfig *config);
Description Returns the name of the file used to store per-user font information.
Version Fontconfig version 2.4.2
FcConfigGetFonts Name FcConfigGetFonts -- Get config font set
Synopsis
#include <fontconfig.h>
FcFontSet * FcConfigGetFonts(FcConfig *config, FcSetName set);
Description Returns one of the two sets of fonts from the configuration as specified
by set.
Version Fontconfig version 2.4.2
FcConfigGetBlanks Name FcConfigGetBlanks -- Get config blanks
Synopsis
#include <fontconfig.h>
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.
Version Fontconfig version 2.4.2
FcConfigGetRescanInverval Name FcConfigGetRescanInverval -- Get config rescan interval
Synopsis
#include <fontconfig.h>
int FcConfigGetRescanInverval(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.
Version Fontconfig version 2.4.2
FcConfigSetRescanInverval Name FcConfigSetRescanInverval -- Set config rescan interval
Synopsis
#include <fontconfig.h>
FcBool FcConfigSetRescanInverval(FcConfig *config, int rescanInterval);
Description Sets the rescan interval; returns FcFalse if an error occurred.
Version Fontconfig version 2.4.2
FcConfigAppFontAddFile Name FcConfigAppFontAddFile -- Add font file to font database
Synopsis
#include <fontconfig.h>
FcBool FcConfigAppFontAddFile(FcConfig *config, const char *file);
Description Adds an application-specific font to the configuration.
Version Fontconfig version 2.4.2
FcConfigAppFontAddDir Name FcConfigAppFontAddDir -- Add fonts from directory to font database
Synopsis
#include <fontconfig.h>
FcBool FcConfigAppFontAddDir(FcConfig *config, const char *);
Description Scans the specified directory for fonts, adding each one found to the
application-specific set of fonts.
Version Fontconfig version 2.4.2
FcConfigAppFontClear Name FcConfigAppFontClear -- Remove all app fonts from font database
Synopsis
#include <fontconfig.h>
void FcConfigAppFontClear(FcConfig *config);
Description Clears the set of application-specific fonts.
Version Fontconfig version 2.4.2
FcInitReinitialize Name FcInitReinitialize -- re-initialize library
Synopsis
#include <fontconfig.h>
FcBool FcInitReinitialize(void);
Description Forces the default configuration file to be reloaded and resets the default
configuration.
Version Fontconfig version 2.4.2
FcConfigSubstituteWithPat Name FcConfigSubstituteWithPat -- Execute substitutions
Synopsis
#include <fontconfig.h>
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 <test> elements with target=pattern.
Version Fontconfig version 2.4.2
FcConfigSubstitute Name FcConfigSubstitute -- Execute substitutions
Synopsis
#include <fontconfig.h>
FcBool FcConfigSubstitute(FcConfig *config, FcPattern *p, FcMatchKind kind);
Description Calls FcConfigSubstituteWithPat setting p_pat to NULL.
Version Fontconfig version 2.4.2
FcFontMatch Name FcFontMatch -- Return best font
Synopsis
#include <fontconfig.h>
FcPattern * FcFontMatch(FcConfig *config, FcPattern *p, FcResult *result);
Description Returns the font in config most close matching p. This function
should be called only after FcConfigSubstitute and FcDefaultSubstitute have
been called for p; otherwise the results will not be correct.
Version Fontconfig version 2.4.2
FcFontSort Name FcFontSort -- Return list of matching fonts
Synopsis
#include <fontconfig.h>
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 caling FcFontSetDestroy.
Version Fontconfig version 2.4.2
FcFontRenderPrepare Name FcFontRenderPrepare -- Prepare pattern for loading font file
Synopsis
#include <fontconfig.h>
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
FcConfigSubstitute with kind FcMatchFont and then returned.
Version Fontconfig version 2.4.2
FcFontList Name FcFontList -- List fonts
Synopsis
#include <fontconfig.h>
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.
Version Fontconfig version 2.4.2
FcConfigFilename Name FcConfigFilename -- Find a config file
Synopsis
#include <fontconfig.h>
char * FcConfigFilename(const char *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
FC_CONFIG_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
FC_CONFIG_DIR environment variable.
Version Fontconfig version 2.4.2
FcConfigParseAndLoad Name FcConfigParseAndLoad -- load a configuration file
Synopsis
#include <fontconfig.h>
FcBool FcConfigParseAndLoad(FcConfig *config, const FcChar8 *file);
Description Walks the configuration in 'file' and constructs the internal representation
in 'config'. Any include files referenced from within 'file' will be loaded
with FcConfigLoad and also parsed. If 'complain' is FcFalse, no warning
will be displayed if 'file' does not exist.
Version Fontconfig version 2.4.2
FcInitBringUptoDate Name FcInitBringUptoDate -- reload configuration files if needed
Synopsis
#include <fontconfig.h>
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.
Version Fontconfig version 2.4.2
FcNameRegisterObjectTypes Name FcNameRegisterObjectTypes -- Register object types
Synopsis
#include <fontconfig.h>
FcBool FcNameRegisterObjectTypes(const FcObjectType *types, int ntype);
Description Register ntype new object types.
Version Fontconfig version 2.4.2
FcNameUnregisterObjectTypes Name FcNameUnregisterObjectTypes -- Unregister object types
Synopsis
#include <fontconfig.h>
FcBool FcNameUnregisterObjectTypes(const FcObjectType *types, int ntype);
Description Unregister ntype object types.
Version Fontconfig version 2.4.2
FcNameGetObjectType Name FcNameGetObjectType -- Lookup an object type
Synopsis
#include <fontconfig.h>
const FcObjectType * FcNameGetObjectType(const char *object);
Description Return the object type for the pattern element named object.
Version Fontconfig version 2.4.2
FcNameRegisterConstants Name FcNameRegisterConstants -- Register symbolic constants
Synopsis
#include <fontconfig.h>
FcBool FcNameRegisterConstants(const FcConstant *consts, int nconsts);
Description Register nconsts new symbolic constants.
Version Fontconfig version 2.4.2
FcNameUnregisterConstants Name FcNameUnregisterConstants -- Unregister symbolic constants
Synopsis
#include <fontconfig.h>
FcBool FcNameUnregisterConstants(const FcConstant *consts, int nconsts);
Description Unregister nconsts symbolic constants.
Version Fontconfig version 2.4.2
FcNameGetConstant Name FcNameGetConstant -- Lookup symbolic constant
Synopsis
#include <fontconfig.h>
const FcConstant * FcNameGetConstant(FcChar8 *string);
Description Return the FcConstant structure related to symbolic constant string.
Version Fontconfig version 2.4.2
FcNameConstant Name FcNameConstant -- Get the value for a symbolic constant
Synopsis
#include <fontconfig.h>
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.4.2
FcBlanksCreate Name FcBlanksCreate -- Create an FcBlanks
Synopsis
#include <fontconfig.h>
FcBlanks * FcBlanksCreate(void);
Description Creates an empty FcBlanks object.
Version Fontconfig version 2.4.2
FcBlanksDestroy Name FcBlanksDestroy -- Destroy and FcBlanks
Synopsis
#include <fontconfig.h>
void FcBlanksDestroy(FcBlanks *b);
Description Destroys an FcBlanks object, freeing any associated memory.
Version Fontconfig version 2.4.2
FcBlanksAdd Name FcBlanksAdd -- Add a character to an FcBlanks
Synopsis
#include <fontconfig.h>
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.4.2
FcPatternCreate Name FcPatternCreate -- Create a pattern
Synopsis
#include <fontconfig.h>
FcPattern * FcPatternCreate(void);
Description Creates a pattern with no properties; used to build patterns from scratch.
Version Fontconfig version 2.4.2
FcBlanksIsMember Name FcBlanksIsMember -- Query membership in an FcBlanks
Synopsis
#include <fontconfig.h>
FcBool FcBlanksIsMember(FcBlanks *b, FcChar32 ucs4);
Description Returns whether the specified FcBlanks object contains the indicated Unicode
value.
Version Fontconfig version 2.4.2
FcAtomicCreate Name FcAtomicCreate -- create an FcAtomic object
Synopsis
#include <fontconfig.h>
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.4.2
FcAtomicLock Name FcAtomicLock -- lock a file
Synopsis
#include <fontconfig.h>
FcBool FcAtomicLock(FcAtomic *atomic);
Description Attempts to lock the file referenced by atomic. Returns FcFalse if the
file is locked by another process, else returns FcTrue and leaves the file
locked.
Version Fontconfig version 2.4.2
FcAtomicNewFile Name FcAtomicNewFile -- return new temporary file name
Synopsis
#include <fontconfig.h>
FcChar8 * FcAtomicNewFile(FcAtomic *atomic);
Description Returns the filename for writing a new version of the file referenced
by atomic.
Version Fontconfig version 2.4.2
FcAtomicOrigFile Name FcAtomicOrigFile -- return original file name
Synopsis
#include <fontconfig.h>
FcChar8 * FcAtomicOrigFile(FcAtomic *atomic);
Description Returns the file refernced by atomic.
Version Fontconfig version 2.4.2
FcAtomicReplaceOrig Name FcAtomicReplaceOrig -- replace original with new
Synopsis
#include <fontconfig.h>
FcBool FcAtomicReplaceOrig(FcAtomic *atomic);
Description Replaces the original file referenced by atomic with the new file.
Version Fontconfig version 2.4.2
FcAtomicDeleteNew Name FcAtomicDeleteNew -- delete new file
Synopsis
#include <fontconfig.h>
void FcAtomicDeleteNew(FcAtomic *atomic);
Description Deletes the new file. Used in error recovery to back out changes.
Version Fontconfig version 2.4.2
FcAtomicUnlock Name FcAtomicUnlock -- unlock a file
Synopsis
#include <fontconfig.h>
void FcAtomicUnlock(FcAtomic *atomic);
Description Unlocks the file.
Version Fontconfig version 2.4.2
FcAtomicDestroy Name FcAtomicDestroy -- destroy an FcAtomic object
Synopsis
#include <fontconfig.h>
void FcAtomicDestroy(FcAtomic *atomic);
Description Destroys atomic.
Version Fontconfig version 2.4.2
FcPatternDestroy Name FcPatternDestroy -- Destroy a pattern
Synopsis
#include <fontconfig.h>
void FcPatternDestroy(FcPattern *p);
Description Destroys a pattern, in the process destroying all related values.
Version Fontconfig version 2.4.2
FcFileScan Name FcFileScan -- scan a font file
Synopsis
#include <fontconfig.h>
FcBool FcFileScan(FcFontSet *set, FcStrSet *dirs, FcFileCache *cache, FcBlanks *blanks, const char *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.
Version Fontconfig version 2.4.2
FcDirScan Name FcDirScan -- scan a font directory
Synopsis
#include <fontconfig.h>
FcBool FcDirScan(FcFontSet *set, FcStrSet *dirs, FcFileCache *cache, FcBlanks *blanks, const char *dir, FcBool force);
Description Scans an entire directory and adds all fonts found to
set. If force is FcTrue, then
the directory and all files within it are scanned even if information is
present in the per-directory cache file or cache. Any
subdirectories found are added to dirs.
Version Fontconfig version 2.4.2
FcDirSave Name FcDirSave -- save a directory cache
Synopsis
#include <fontconfig.h>
FcBool FcDirSave(FcFontSet *set, FcStrSet *dirs, const char *dir);
Description Creates the per-directory cache file for dir and
populates it with the fonts in set and subdirectories
in dirs.
Version Fontconfig version 2.4.2
FcDirCacheValid Name FcDirCacheValid -- check directory cache timestamp
Synopsis
#include <fontconfig.h>
FcBool FcDirCacheValid(const FcChar8 *cache_file);
Description Returns FcTrue if cache_file is no older than the
directory containing it, else FcFalse.
Version Fontconfig version 2.4.2
FcStrSetCreate Name FcStrSetCreate -- create a string set
Synopsis
#include <fontconfig.h>
FcStrSet * FcStrSetCreate(void);
Description Create an empty set.
Version Fontconfig version 2.4.2
FcStrSetMember Name FcStrSetMember -- check set for membership
Synopsis
#include <fontconfig.h>
FcBool FcStrSetMember(FcStrSet *set, const FcChar8 *s);
Description Returns whether s is a member of
set.
Version Fontconfig version 2.4.2
FcStrSetAdd Name FcStrSetAdd -- add to a string set
Synopsis
#include <fontconfig.h>
FcBool FcStrSetAdd(FcStrSet *set, const FcChar8 *s);
Description Adds a copy of s to set.
Version Fontconfig version 2.4.2
FcStrSetAddFilename Name FcStrSetAddFilename -- add a filename to a string set
Synopsis
#include <fontconfig.h>
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.4.2
FcPatternEqual Name FcPatternEqual -- Compare patterns
Synopsis
#include <fontconfig.h>
FcBool FcPatternEqual(const FcPattern *pa, const FcPattern *pb);
Description Returns whether pa and pb are exactly alike.
Version Fontconfig version 2.4.2
FcStrSetDel Name FcStrSetDel -- delete from a string set
Synopsis
#include <fontconfig.h>
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.4.2
FcStrSetDestroy Name FcStrSetDestroy -- destroy a string set
Synopsis
#include <fontconfig.h>
void FcStrSetDestroy(FcStrSet *set);
Version Fontconfig version 2.4.2
FcStrListCreate Name FcStrListCreate -- create a string iterator
Synopsis
#include <fontconfig.h>
FcStrList * FcStrListCreate(FcStrSet *set);
Description Creates an iterator to list the strings in set.
Version Fontconfig version 2.4.2
FcStrListNext Name FcStrListNext -- get next string in iteration
Synopsis
#include <fontconfig.h>
FcChar8 * FcStrListNext(FcStrList *list);
Description Returns the next string in set.
Version Fontconfig version 2.4.2
FcStrListDone Name FcStrListDone -- destroy a string iterator
Synopsis
#include <fontconfig.h>
void FcStrListDone(FcStrList *list);
Description Destroys the enumerator list.
Version Fontconfig version 2.4.2
FcUtf8ToUcs4 Name FcUtf8ToUcs4 -- convert UTF-8 to UCS4
Synopsis
#include <fontconfig.h>
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 nust be at least
len bytes long.
Version Fontconfig version 2.4.2
FcUcs4ToUtf8 Name FcUcs4ToUtf8 -- convert UCS4 to UTF-8
Synopsis
#include <fontconfig.h>
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.4.2
FcUtf8Len Name FcUtf8Len -- count UTF-8 encoded chars
Synopsis
#include <fontconfig.h>
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.4.2
FcUtf16ToUcs4 Name FcUtf16ToUcs4 -- convert UTF-16 to UCS4
Synopsis
#include <fontconfig.h>
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.4.2
FcPatternEqualSubset Name FcPatternEqualSubset -- Compare portions of patterns
Synopsis
#include <fontconfig.h>
FcBool FcPatternEqualSubset(const FcPattern *pa, const FcPattern *pb, const FcObjectSet *os);
Description Returns whether pa and pb have exactly the same values for all of the
objects in os.
Version Fontconfig version 2.4.2
FcUtf16Len Name FcUtf16Len -- count UTF-16 encoded chars
Synopsis
#include <fontconfig.h>
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.4.2
FcStrCopy Name FcStrCopy -- duplicate a string
Synopsis
#include <fontconfig.h>
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.4.2
FcStrDowncase Name FcStrDowncase -- create a lower case translation of a string
Synopsis
#include <fontconfig.h>
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.4.2
FcStrCopyFilename Name FcStrCopyFilename -- copy a string, expanding '~'
Synopsis
#include <fontconfig.h>
FcChar8 * FcStrCopyFilename(const FcChar8 *s);
Description Just like FcStrCopy except that it converts any leading '~' characters in
s to the value of the HOME environment variable.
Returns NULL if '~' is present in s and HOME is unset.
Version Fontconfig version 2.4.2
FcStrCmpIgnoreCase Name FcStrCmpIgnoreCase -- compare UTF-8 strings ignoring ASCII case
Synopsis
#include <fontconfig.h>
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 in the ASCII range and will operate properly with UTF8
encoded strings, although it does not check for well formed strings.
Version Fontconfig version 2.4.2
FcStrStr Name FcStrStr -- locate UTF-8 substring
Synopsis
#include <fontconfig.h>
FcChar8 * FcStrStr(const char *s1, const char *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, although it does not check for well formed
strings.
Version Fontconfig version 2.4.2
FcStrStrIgnoreCase Name FcStrStrIgnoreCase -- locate UTF-8 substring ignoring ASCII case
Synopsis
#include <fontconfig.h>
FcChar8 * FcStrStrIgnoreCase(const char *s1, const char *s2);
Description Returns the location of s2 in
s1, ignoring ASCII case. Returns NULL if
s2 is not present in s1.
This test is case-insensitive in the ASCII range and will operate properly
with UTF8 encoded strings, although it does not check for well formed
strings.
Version Fontconfig version 2.4.2
FcStrDirname Name FcStrDirname -- directory part of filename
Synopsis
#include <fontconfig.h>
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.4.2
FcStrBasename Name FcStrBasename -- last component of filename
Synopsis
#include <fontconfig.h>
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.4.2
FcPatternHash Name FcPatternHash -- Compute a pattern hash value
Synopsis
#include <fontconfig.h>
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.4.2
FcPatternAdd Name FcPatternAdd -- Add a value to a pattern
Synopsis
#include <fontconfig.h>
FcBool FcPatternAdd(FcPattern *p, const char *object, FcValue value, FcBool append);
Description Adds a single value to the list of values associated with the property named
`object. If `append is FcTrue, the value is added at the end of any
existing list, otherwise it is inserted at the begining. `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.4.2
FcPatternAddWeak Name FcPatternAddWeak -- Add a value to a pattern with weak binding
Synopsis
#include <fontconfig.h>
FcBool FcPatternAddWeak(FcPattern *p, const char *object, FcValue value, FcBool append);
Description FcPatternAddWeak is essentially the same as FcPatternAdd except that any
values added to the list have binding weak instead of strong.
Version Fontconfig version 2.4.2
FcPatternAdd-Type Name FcPatternAddInteger, FcPatternAddDouble, FcPatternAddString, FcPatternAddMatrix, FcPatternAddCharSet, FcPatternAddBool -- Add a typed value to a pattern
Synopsis
#include <fontconfig.h>
FcBool FcPatternAddInteger(FcPattern *p, const char *object, int i);
FcBool FcPatternAddDouble(FcPattern *p, const char *object, double d);
FcBool FcPatternAddString(FcPattern *p, const char *object, const char *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);
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.4.2
FcPatternGet Name FcPatternGet -- Return a value from a pattern
Synopsis
#include <fontconfig.h>
FcResult FcPatternGet(FcPattern *p, const char *object, int id, FcValue *v);
Description Returns in v the id'th value
associated with the property object.
The value returned is not a copy, but rather refers to the data stored
within the pattern directly. Applications must not free this value.
Version Fontconfig version 2.4.2
FcPatternGet-Type Name FcPatternGetInteger, FcPatternGetDouble, FcPatternGetString, FcPatternGetMatrix, FcPatternGetCharSet, FcPatternGetBool -- Return a typed value from a pattern
Synopsis
#include <fontconfig.h>
FcResult FcPatternGetInteger(FcPattern *p, const char *object, int n, int *i);
FcResult FcPatternGetDouble(FcPattern *p, const char *object, int n, double *d);
FcResult FcPatternGetString(FcPattern *p, const char *object, int n, char **consts);
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);
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.4.2
FcPatternBuild Name FcPatternBuild, FcPatternVaBuild -- Create patterns from arguments
Synopsis
#include <fontconfig.h>
FcPattern * FcPatternBuild(FcPattern *orig, ...);
FcPattern * FcPatternVaBuild(FcPattern *orig, 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:
Object name, a string describing the property to be added.
Object type, one of the FcType enumerated values
Value, not an FcValue, but the raw type as passed to any of the
FcPatternAdd<type> functions. Must match the type of the second
argument.
The argument list is terminated by a null object name, no object type nor
value need be passed for this. The values are added to `pattern', if
`pattern' is null, a new pattern is created. In either case, the pattern is
returned. Example
pattern = FcPatternBuild (0, FC_FAMILY, FcTypeString, "Times", (char *) 0); FcPatternVaBuild is used when the arguments are already in the form of a
varargs value.
Version Fontconfig version 2.4.2
FcPatternDel Name FcPatternDel -- Delete a property from a pattern
Synopsis
#include <fontconfig.h>
FcBool FcPatternDel(FcPattern *p, const char *object);
Description Deletes all values associated with the property `object', returning
whether the property existed or not.
Version Fontconfig version 2.4.2
FcPatternRemove Name FcPatternRemove -- Remove one object of the specified type from the pattern
Synopsis
#include <fontconfig.h>
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.4.2
FcPatternPrint Name FcPatternPrint -- Print a pattern for debugging
Synopsis
#include <fontconfig.h>
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.4.2
FcDefaultSubstitute Name FcDefaultSubstitute -- Perform default substitutions in a pattern
Synopsis
#include <fontconfig.h>
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.4.2
FcNameParse Name FcNameParse -- Parse a pattern string
Synopsis
#include <fontconfig.h>
FcPattern * FcNameParse(const char *name);
Description Converts name from the standard text format described above into a pattern.
Version Fontconfig version 2.4.2
FcNameUnparse Name FcNameUnparse -- Convert a pattern back into a string that can be parsed
Synopsis
#include <fontconfig.h>
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.
Version Fontconfig version 2.4.2
FcFontSetCreate Name FcFontSetCreate -- Create a font set
Synopsis
#include <fontconfig.h>
FcFontSet * FcFontSetCreate(void);
Description Creates an empty font set.
Version Fontconfig version 2.4.2
FcFontSetDestroy Name FcFontSetDestroy -- Destroy a font set
Synopsis
#include <fontconfig.h>
void FcFontSetDestroy(FcFontSet *s);
Description Destroys a font set. Note that this destroys any referenced patterns as
well.
Version Fontconfig version 2.4.2
FcFontSetAdd Name FcFontSetAdd -- Add to a font set
Synopsis
#include <fontconfig.h>
FcBool FcFontSetAdd(FcFontSet *s, FcPattern *font);
Description Adds a pattern to a font set. Note that the pattern is not copied before
being inserted into the set.
Version Fontconfig version 2.4.2
FcObjectSetCreate Name FcObjectSetCreate -- Create an object set
Synopsis
#include <fontconfig.h>
FcObjectSet * FcObjectSetCreate(void);
Description Creates an empty set.
Version Fontconfig version 2.4.2
FcObjectSetAdd Name FcObjectSetAdd -- Add to an object set
Synopsis
#include <fontconfig.h>
FcBool FcObjectSetAdd(FcObjectSet *os, const char *object);
Description Adds a proprety name to the set.
Version Fontconfig version 2.4.2
FcObjectSetDestroy Name FcObjectSetDestroy -- Destroy an object set
Synopsis
#include <fontconfig.h>
void FcObjectSetDestroy(FcObjectSet *os);
Description Destroys an object set.
Version Fontconfig version 2.4.2
FcObjectSetBuild Name FcObjectSetBuild, FcObjectSetVaBuild -- Build object set from args
Synopsis
#include <fontconfig.h>
FcObjectSet * FcObjectSetBuild(const char *first, ...);
FcObjectSet * FcObjectSetVaBuild(const char *first, va_list va);
Description These build an object set from a null-terminated list of property names.
Version Fontconfig version 2.4.2
FcFreeTypeCharIndex Name FcFreeTypeCharIndex -- map Unicode to glyph id
Synopsis
#include <fontconfig.h>
#include <fcfreetype.h>
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.4.2
FcFreeTypeCharSet Name FcFreeTypeCharSet -- compute unicode coverage
Synopsis
#include <fontconfig.h>
#include <fcfreetype.h>
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.4.2
FcInitLoadConfig Name FcInitLoadConfig -- load configuration
Synopsis
#include <fontconfig.h>
FcConfig * FcInitLoadConfig(void);
Description Loads the default configuration file and returns the resulting configuration.
Does not load any font information.
Version Fontconfig version 2.4.2
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.
The configuration module consists of the FcConfig datatype, libexpat and
FcConfigParse which walks over an XML tree and ammends 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.
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 applications rendering mechanism.
Property Definitions
Property CPP Symbol Type Description
----------------------------------------------------
family FC_FAMILY String Font family names
familylang FC_FAMILYLANG String Language cooresponding to
each family name
style FC_STYLE String Font style. Overrides weight
and slant
stylelang FC_STYLELANG String Language cooresponding to
each style name
fullname FC_FULLNAME String Font face full name where
different from family and
family + style
fullnamelang FC_FULLNAMELANG String Language cooresponding 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
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
minspace FC_MINSPACE Bool Eliminate leading from line
spacing
charset FC_CHARSET CharSet Unicode chars encoded by
the font
lang FC_LANG String List 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
Datatypes Fontconfig uses abstract datatypes to hide internal implementation details
for most data structures. A few structures are exposed where appropriate.
These are primitive datatypes; the FcChar* types hold precisely the number
of bits stated (if supported by the C implementation). FcBool holds
one of two CPP symbols: FcFalse or FcTrue.
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;
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.
Tags the kind of data stored in an 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;
} u;
} FcValue;
FcValue Members
Type Union member Datatype
--------------------------------
FcTypeVoid (none) (none)
FcTypeInteger i int
FcTypeDouble d double
FcTypeString s char *
FcTypeBool b b
FcTypeMatrix m FcMatrix *
FcTypeCharSet c FcCharSet *
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.
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 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.
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.
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.
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'.
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.
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.
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 particulat set use one of the FcSetName enumerated
values.
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.
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
Used for locking access to config files. Provides a safe way to update
configuration files.
FUNCTIONS These are grouped by functionality, often using the main datatype being
manipulated.
These functions provide some control over how the library is initialized.
An FcPattern is an opaque type that holds both patterns to match against the
available fonts, as well as the information about each font.
An FcFontSet simply holds a list of patterns; these are used to return the
results of listing available fonts.
An FcObjectSet holds a list of pattern property names; it is used to
indiciate which properties are to be returned in the patterns from
FcFontList.
While the fontconfig library doesn't insist that FreeType be used as the
rasterization mechanism for fonts, it does provide some convenience
functions.
FcValue is a structure containing a type tag and a union of all possible
datatypes. The tag is an enum of type
FcType
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.
FcMatrix structures hold an affine transformation in matrix form.
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.
Provides for applcation-specified font name object types so that new
pattern elements can be generated from font names.
Provides for application-specified symbolic constants for font names.
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.
These functions provide a safe way to update config files, allowing ongoing
reading of the old config file while locked for writing and ensuring that a
consistent and complete version of the config file is always available.
These routines work with font files and directories, including font
directory cache files.
A data structure for enumerating strings, used to list directories while
scanning the configuration as directories are added while scanning.
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.
#include
#include
#include
static void *
New (int size);
static void *
Reallocate (void *p, int size);
static void
Dispose (void *p);
typedef enum { False, True } Bool;
typedef struct {
char *buf;
int size;
int len;
} String;
static String *
StringNew (void);
static void
StringAdd (String *s, char c);
static void
StringAddString (String *s, char *buf);
static String *
StringMake (char *buf);
static void
StringDel (String *s);
static void
StringPut (FILE *f, String *s);
static void
StringDispose (String *s);
typedef struct {
String *tag;
String *text;
} Replace;
static Replace *
ReplaceNew (void);
static void
ReplaceDispose (Replace *r);
static void
Bail (const char *format, const char *arg);
static Replace *
ReplaceRead (FILE *f);
typedef struct _replaceList {
struct _replaceList *next;
Replace *r;
} ReplaceList;
static ReplaceList *
ReplaceListNew (Replace *r, ReplaceList *next);
static void
ReplaceListDispose (ReplaceList *l);
typedef struct {
ReplaceList *head;
} ReplaceSet;
static ReplaceSet *
ReplaceSetNew (void);
static void
ReplaceSetDispose (ReplaceSet *s);
static void
ReplaceSetAdd (ReplaceSet *s, Replace *r);
static Replace *
ReplaceSetFind (ReplaceSet *s, char *tag);
static ReplaceSet *
ReplaceSetRead (FILE *f);
typedef struct _skipStack {
struct _skipStack *prev;
int skipping;
} SkipStack;
static SkipStack *
SkipStackPush (SkipStack *prev, int skipping);
static SkipStack *
SkipStackPop (SkipStack *prev);
typedef struct _loopStack {
struct _loopStack *prev;
String *tag;
String *extra;
long pos;
} LoopStack;
static LoopStack *
LoopStackPush (LoopStack *prev, FILE *f, char *tag);
static LoopStack *
LoopStackLoop (ReplaceSet *rs, LoopStack *ls, FILE *f);
static void
LineSkip (FILE *f);
static void
DoReplace (FILE *f, ReplaceSet *s);
#define STRING_INIT 128
static void *
New (int size)
{
void *m = malloc (size);
if (!m)
abort ();
return m;
}
static void *
Reallocate (void *p, int size)
{
void *r = realloc (p, size);
if (!r)
abort ();
return r;
}
static void
Dispose (void *p)
{
free (p);
}
static String *
StringNew (void)
{
String *s;
s = New (sizeof (String));
s->buf = New (STRING_INIT);
s->size = STRING_INIT - 1;
s->buf[0] = '\0';
s->len = 0;
return s;
}
static void
StringAdd (String *s, char c)
{
if (s->len == s->size)
s->buf = Reallocate (s->buf, (s->size *= 2) + 1);
s->buf[s->len++] = c;
s->buf[s->len] = '\0';
}
static void
StringAddString (String *s, char *buf)
{
while (*buf)
StringAdd (s, *buf++);
}
static String *
StringMake (char *buf)
{
String *s = StringNew ();
StringAddString (s, buf);
return s;
}
static void
StringDel (String *s)
{
if (s->len)
s->buf[--s->len] = '\0';
}
static void
StringPut (FILE *f, String *s)
{
char *b = s->buf;
while (*b)
putc (*b++, f);
}
#define StringLast(s) ((s)->len ? (s)->buf[(s)->len - 1] : '\0')
static void
StringDispose (String *s)
{
Dispose (s->buf);
Dispose (s);
}
static Replace *
ReplaceNew (void)
{
Replace *r = New (sizeof (Replace));
r->tag = StringNew ();
r->text = StringNew ();
return r;
}
static void
ReplaceDispose (Replace *r)
{
StringDispose (r->tag);
StringDispose (r->text);
Dispose (r);
}
static void
Bail (const char *format, const char *arg)
{
fprintf (stderr, "fatal: ");
fprintf (stderr, format, arg);
fprintf (stderr, "\n");
exit (1);
}
static Replace *
ReplaceRead (FILE *f)
{
int c;
Replace *r;
while ((c = getc (f)) != '@')
{
if (c == EOF)
return 0;
}
r = ReplaceNew();
while ((c = getc (f)) != '@')
{
if (c == EOF)
{
ReplaceDispose (r);
return 0;
}
if (isspace (c))
Bail ("invalid character after tag %s", r->tag->buf);
StringAdd (r->tag, c);
}
if (r->tag->buf[0] == '\0')
{
ReplaceDispose (r);
return 0;
}
while (isspace ((c = getc (f))))
;
ungetc (c, f);
while ((c = getc (f)) != '@' && c != EOF)
StringAdd (r->text, c);
if (c == '@')
ungetc (c, f);
while (isspace (StringLast (r->text)))
StringDel (r->text);
if (StringLast(r->text) == '%')
{
StringDel (r->text);
StringAdd (r->text, ' ');
}
return r;
}
static ReplaceList *
ReplaceListNew (Replace *r, ReplaceList *next)
{
ReplaceList *l = New (sizeof (ReplaceList));
l->r = r;
l->next = next;
return l;
}
static void
ReplaceListDispose (ReplaceList *l)
{
if (l)
{
ReplaceListDispose (l->next);
ReplaceDispose (l->r);
Dispose (l);
}
}
static ReplaceSet *
ReplaceSetNew (void)
{
ReplaceSet *s = New (sizeof (ReplaceSet));
s->head = 0;
return s;
}
static void
ReplaceSetDispose (ReplaceSet *s)
{
ReplaceListDispose (s->head);
Dispose (s);
}
static void
ReplaceSetAdd (ReplaceSet *s, Replace *r)
{
s->head = ReplaceListNew (r, s->head);
}
static Replace *
ReplaceSetFind (ReplaceSet *s, char *tag)
{
ReplaceList *l;
for (l = s->head; l; l = l->next)
if (!strcmp (tag, l->r->tag->buf))
return l->r;
return 0;
}
static ReplaceSet *
ReplaceSetRead (FILE *f)
{
ReplaceSet *s = ReplaceSetNew ();
Replace *r;
while ((r = ReplaceRead (f)))
{
while (ReplaceSetFind (s, r->tag->buf))
StringAdd (r->tag, '+');
ReplaceSetAdd (s, r);
}
if (!s->head)
{
ReplaceSetDispose (s);
s = 0;
}
return s;
}
static SkipStack *
SkipStackPush (SkipStack *prev, int skipping)
{
SkipStack *ss = New (sizeof (SkipStack));
ss->prev = prev;
ss->skipping = skipping;
return ss;
}
static SkipStack *
SkipStackPop (SkipStack *prev)
{
SkipStack *ss = prev->prev;
Dispose (prev);
return ss;
}
static LoopStack *
LoopStackPush (LoopStack *prev, FILE *f, char *tag)
{
LoopStack *ls = New (sizeof (LoopStack));
ls->prev = prev;
ls->tag = StringMake (tag);
ls->extra = StringNew ();
ls->pos = ftell (f);
return ls;
}
static LoopStack *
LoopStackLoop (ReplaceSet *rs, LoopStack *ls, FILE *f)
{
String *s = StringMake (ls->tag->buf);
LoopStack *ret = ls;
Bool loop;
StringAdd (ls->extra, '+');
StringAddString (s, ls->extra->buf);
loop = ReplaceSetFind (rs, s->buf) != 0;
StringDispose (s);
if (loop)
fseek (f, ls->pos, SEEK_SET);
else
{
ret = ls->prev;
StringDispose (ls->tag);
StringDispose (ls->extra);
Dispose (ls);
}
return ret;
}
static void
LineSkip (FILE *f)
{
int c;
while ((c = getc (f)) == '\n')
;
ungetc (c, f);
}
static void
DoReplace (FILE *f, ReplaceSet *s)
{
int c;
String *tag;
Replace *r;
SkipStack *ss = 0;
LoopStack *ls = 0;
int skipping = 0;
while ((c = getc (f)) != EOF)
{
if (c == '@')
{
tag = StringNew ();
while ((c = getc (f)) != '@')
{
if (c == EOF)
abort ();
StringAdd (tag, c);
}
if (ls)
StringAddString (tag, ls->extra->buf);
switch (tag->buf[0]) {
case '?':
ss = SkipStackPush (ss, skipping);
if (!ReplaceSetFind (s, tag->buf + 1))
skipping++;
LineSkip (f);
break;
case ':':
if (!ss)
abort ();
if (ss->skipping == skipping)
++skipping;
else
--skipping;
LineSkip (f);
break;
case ';':
skipping = ss->skipping;
ss = SkipStackPop (ss);
LineSkip (f);
break;
case '{':
ls = LoopStackPush (ls, f, tag->buf + 1);
LineSkip (f);
break;
case '}':
ls = LoopStackLoop (s, ls, f);
LineSkip (f);
break;
default:
r = ReplaceSetFind (s, tag->buf);
if (r && !skipping)
StringPut (stdout, r->text);
break;
}
StringDispose (tag);
}
else if (!skipping)
putchar (c);
}
}
int
main (int argc, char **argv)
{
FILE *f;
ReplaceSet *s;
if (!argv[1])
Bail ("usage: %s ", argv[0]);
f = fopen (argv[1], "r");
if (!f)
{
Bail ("can't open file %s", argv[1]);
exit (1);
}
while ((s = ReplaceSetRead (stdin)))
{
DoReplace (f, s);
ReplaceSetDispose (s);
rewind (f);
}
if (ferror (stdout))
Bail ("%s", "error writing output");
exit (0);
}
fontconfig-2.4.2/doc/FcAtomicCreate.3 0100664 0002720 0000144 00000001560 10534406354 015322 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcAtomicCreate" "3" "02 December 2006" "" ""
.SH NAME
FcAtomicCreate \- create an FcAtomic object
.SH SYNOPSIS
.sp
\fB#include
.sp
FcAtomic * FcAtomicCreate (const FcChar8 *\fIfile\fB);
\fR
.SH "DESCRIPTION"
.PP
Creates a data structure containing data needed to control access to \fIfile\fR\&.
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.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcAtomicLock.3 0100664 0002720 0000144 00000001303 10534406354 015002 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcAtomicLock" "3" "02 December 2006" "" ""
.SH NAME
FcAtomicLock \- lock a file
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcAtomicLock (FcAtomic *\fIatomic\fB);
\fR
.SH "DESCRIPTION"
.PP
Attempts to lock the file referenced by \fIatomic\fR\&. Returns FcFalse if the
file is locked by another process, else returns FcTrue and leaves the file
locked.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcAtomicNewFile.3 0100664 0002720 0000144 00000001230 10534406354 015442 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcAtomicNewFile" "3" "02 December 2006" "" ""
.SH NAME
FcAtomicNewFile \- return new temporary file name
.SH SYNOPSIS
.sp
\fB#include
.sp
FcChar8 * FcAtomicNewFile (FcAtomic *\fIatomic\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the filename for writing a new version of the file referenced
by \fIatomic\fR\&.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcAtomicOrigFile.3 0100664 0002720 0000144 00000001153 10534406354 015615 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcAtomicOrigFile" "3" "02 December 2006" "" ""
.SH NAME
FcAtomicOrigFile \- return original file name
.SH SYNOPSIS
.sp
\fB#include
.sp
FcChar8 * FcAtomicOrigFile (FcAtomic *\fIatomic\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the file refernced by \fIatomic\fR\&.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcAtomicReplaceOrig.3 0100664 0002720 0000144 00000001214 10534406354 016307 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcAtomicReplaceOrig" "3" "02 December 2006" "" ""
.SH NAME
FcAtomicReplaceOrig \- replace original with new
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcAtomicReplaceOrig (FcAtomic *\fIatomic\fB);
\fR
.SH "DESCRIPTION"
.PP
Replaces the original file referenced by \fIatomic\fR with the new file.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcAtomicDeleteNew.3 0100664 0002720 0000144 00000001164 10534406354 015773 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcAtomicDeleteNew" "3" "02 December 2006" "" ""
.SH NAME
FcAtomicDeleteNew \- delete new file
.SH SYNOPSIS
.sp
\fB#include
.sp
void FcAtomicDeleteNew (FcAtomic *\fIatomic\fB);
\fR
.SH "DESCRIPTION"
.PP
Deletes the new file. Used in error recovery to back out changes.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcAtomicUnlock.3 0100664 0002720 0000144 00000001070 10534406354 015346 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcAtomicUnlock" "3" "02 December 2006" "" ""
.SH NAME
FcAtomicUnlock \- unlock a file
.SH SYNOPSIS
.sp
\fB#include
.sp
void FcAtomicUnlock (FcAtomic *\fIatomic\fB);
\fR
.SH "DESCRIPTION"
.PP
Unlocks the file.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcAtomicDestroy.3 0100664 0002720 0000144 00000001117 10534406354 015546 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcAtomicDestroy" "3" "02 December 2006" "" ""
.SH NAME
FcAtomicDestroy \- destroy an FcAtomic object
.SH SYNOPSIS
.sp
\fB#include
.sp
void FcAtomicDestroy (FcAtomic *\fIatomic\fB);
\fR
.SH "DESCRIPTION"
.PP
Destroys \fIatomic\fR\&.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcBlanksCreate.3 0100664 0002720 0000144 00000001107 10534406354 015315 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcBlanksCreate" "3" "02 December 2006" "" ""
.SH NAME
FcBlanksCreate \- Create an FcBlanks
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBlanks * FcBlanksCreate (void\fI\fB);
\fR
.SH "DESCRIPTION"
.PP
Creates an empty FcBlanks object.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcBlanksDestroy.3 0100664 0002720 0000144 00000001147 10534406354 015547 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcBlanksDestroy" "3" "02 December 2006" "" ""
.SH NAME
FcBlanksDestroy \- Destroy and FcBlanks
.SH SYNOPSIS
.sp
\fB#include
.sp
void FcBlanksDestroy (FcBlanks *\fIb\fB);
\fR
.SH "DESCRIPTION"
.PP
Destroys an FcBlanks object, freeing any associated memory.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcBlanksAdd.3 0100664 0002720 0000144 00000001244 10534406354 014604 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcBlanksAdd" "3" "02 December 2006" "" ""
.SH NAME
FcBlanksAdd \- Add a character to an FcBlanks
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcBlanksAdd (FcBlanks *\fIb\fB, FcChar32 \fIucs4\fB);
\fR
.SH "DESCRIPTION"
.PP
Adds a single character to an FcBlanks object, returning FcFalse
if this process ran out of memory.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcBlanksIsMember.3 0100664 0002720 0000144 00000001244 10534406354 015617 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcBlanksIsMember" "3" "02 December 2006" "" ""
.SH NAME
FcBlanksIsMember \- Query membership in an FcBlanks
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcBlanksIsMember (FcBlanks *\fIb\fB, FcChar32 \fIucs4\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns whether the specified FcBlanks object contains the indicated Unicode
value.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcCharSetCreate.3 0100664 0002720 0000144 00000001206 10534406354 015434 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcCharSetCreate" "3" "02 December 2006" "" ""
.SH NAME
FcCharSetCreate \- Create an empty character set
.SH SYNOPSIS
.sp
\fB#include
.sp
FcCharSet * FcCharSetCreate (void\fI\fB);
\fR
.SH "DESCRIPTION"
.PP
\fBFcCharSetCreate\fR allocates and initializes a new empty
character set object.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcCharSetDestroy.3 0100664 0002720 0000144 00000001276 10534406354 015671 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcCharSetDestroy" "3" "02 December 2006" "" ""
.SH NAME
FcCharSetDestroy \- Destroy a character set
.SH SYNOPSIS
.sp
\fB#include
.sp
void FcCharSetDestroy (FcCharSet *\fIfcs\fB);
\fR
.SH "DESCRIPTION"
.PP
\fBFcCharSetDestroy\fR decrements the reference count
\fIfcs\fR\&. If the reference count becomes zero, all
memory referenced is freed.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcCharSetAddChar.3 0100664 0002720 0000144 00000001360 10534406354 015520 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcCharSetAddChar" "3" "02 December 2006" "" ""
.SH NAME
FcCharSetAddChar \- Add a character to a charset
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcCharSetAddChar (FcCharSet *\fIfcs\fB, FcChar32 \fIucs4\fB);
\fR
.SH "DESCRIPTION"
.PP
\fBFcCharSetAddChar\fR 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.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcCharSetCopy.3 0100664 0002720 0000144 00000001250 10534406354 015142 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcCharSetCopy" "3" "02 December 2006" "" ""
.SH NAME
FcCharSetCopy \- Copy a charset
.SH SYNOPSIS
.sp
\fB#include
.sp
FcCharSet * FcCharSetCopy (FcCharSet *\fIsrc\fB);
\fR
.SH "DESCRIPTION"
.PP
Makes a copy of \fIsrc\fR; note that this may not actually do anything more
than increment the reference count on \fIsrc\fR\&.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcCharSetEqual.3 0100664 0002720 0000144 00000001226 10534406354 015302 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcCharSetEqual" "3" "02 December 2006" "" ""
.SH NAME
FcCharSetEqual \- Compare two charsets
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcCharSetEqual (const FcCharSet *\fIa\fB, const FcCharSet *\fIb\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns whether \fIa\fR and \fIb\fR
contain the same set of unicode chars.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcCharSetIntersect.3 0100664 0002720 0000144 00000001250 10534406354 016170 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcCharSetIntersect" "3" "02 December 2006" "" ""
.SH NAME
FcCharSetIntersect \- Intersect charsets
.SH SYNOPSIS
.sp
\fB#include
.sp
FcCharSet * FcCharSetIntersect (const FcCharSet *\fIa\fB, const FcCharSet *\fIb\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns a set including only those chars found in both
\fIa\fR and \fIb\fR\&.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcCharSetUnion.3 0100664 0002720 0000144 00000001227 10534406354 015324 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcCharSetUnion" "3" "02 December 2006" "" ""
.SH NAME
FcCharSetUnion \- Add charsets
.SH SYNOPSIS
.sp
\fB#include
.sp
FcCharSet * FcCharSetUnion (const FcCharSet *\fIa\fB, const FcCharSet *\fIb\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns a set including only those chars found in either \fIa\fR or \fIb\fR\&.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcCharSetSubtract.3 0100664 0002720 0000144 00000001243 10534406354 016021 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcCharSetSubtract" "3" "02 December 2006" "" ""
.SH NAME
FcCharSetSubtract \- Subtract charsets
.SH SYNOPSIS
.sp
\fB#include
.sp
FcCharSet * FcCharSetSubtract (const FcCharSet *\fIa\fB, const FcCharSet *\fIb\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns a set including only those chars found in \fIa\fR but not \fIb\fR\&.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcCharSetHasChar.3 0100664 0002720 0000144 00000001216 10534406354 015543 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcCharSetHasChar" "3" "02 December 2006" "" ""
.SH NAME
FcCharSetHasChar \- Check a charset for a char
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcCharSetHasChar (const FcCharSet *\fIfcs\fB, FcChar32 \fIucs4\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns whether \fIfcs\fR contains the char \fIucs4\fR\&.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcCharSetCount.3 0100664 0002720 0000144 00000001161 10534406354 015321 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcCharSetCount" "3" "02 December 2006" "" ""
.SH NAME
FcCharSetCount \- Count entries in a charset
.SH SYNOPSIS
.sp
\fB#include
.sp
FcChar32 FcCharSetCount (const FcCharSet *\fIa\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the total number of unicode chars in \fIa\fR\&.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcCharSetIntersectCount.3 0100664 0002720 0000144 00000001264 10534406354 017206 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcCharSetIntersectCount" "3" "02 December 2006" "" ""
.SH NAME
FcCharSetIntersectCount \- Intersect and count charsets
.SH SYNOPSIS
.sp
\fB#include
.sp
FcChar32 FcCharSetIntersectCount (const FcCharSet *\fIa\fB, const FcCharSet *\fIb\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the number of chars that are in both \fIa\fR and \fIb\fR\&.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcCharSetSubtractCount.3 0100664 0002720 0000144 00000001262 10534406354 017033 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcCharSetSubtractCount" "3" "02 December 2006" "" ""
.SH NAME
FcCharSetSubtractCount \- Subtract and count charsets
.SH SYNOPSIS
.sp
\fB#include
.sp
FcChar32 FcCharSetSubtractCount (const FcCharSet *\fIa\fB, const FcCharSet *\fIb\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the number of chars that are in \fIa\fR but not in \fIb\fR\&.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcCharSetIsSubset.3 0100664 0002720 0000144 00000001214 10534406354 015771 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcCharSetIsSubset" "3" "02 December 2006" "" ""
.SH NAME
FcCharSetIsSubset \- Test for charset inclusion
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcCharSetIsSubset (const FcCharSet *\fIa\fB, const FcCharSet *\fIb\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns whether \fIa\fR is a subset of \fIb\fR\&.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcCharSetFirstPage.3 0100664 0002720 0000144 00000001453 10534406354 016121 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcCharSetFirstPage" "3" "02 December 2006" "" ""
.SH NAME
FcCharSetFirstPage \- Start enumerating charset contents
.SH SYNOPSIS
.sp
\fB#include
.sp
FcChar32 FcCharSetFirstPage (const FcCharSet *\fIa\fB, FcChar32[FC_CHARSET_MAP_SIZE] \fImap\fB, FcChar32 *\fInext\fB);
\fR
.SH "DESCRIPTION"
.PP
Builds an array of bits marking the first page of Unicode coverage of
\fIa\fR\&. Returns the base of the array. \fInext\fR contains the next page in the
font.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcCharSetNextPage.3 0100664 0002720 0000144 00000001462 10534406354 015750 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcCharSetNextPage" "3" "02 December 2006" "" ""
.SH NAME
FcCharSetNextPage \- Continue enumerating charset contents
.SH SYNOPSIS
.sp
\fB#include
.sp
FcChar32 FcCharSetNextPage (const FcCharSet *\fIa\fB, FcChar32[FC_CHARSET_MAP_SIZE] \fImap\fB, FcChar32 *\fInext\fB);
\fR
.SH "DESCRIPTION"
.PP
Builds an array of bits marking the Unicode coverage of \fIa\fR for page
\fI*next\fR\&. Returns the base of the array. \fInext\fR contains the next page in
the font.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcConfigCreate.3 0100664 0002720 0000144 00000001111 10534406354 015303 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcConfigCreate" "3" "02 December 2006" "" ""
.SH NAME
FcConfigCreate \- Create a configuration
.SH SYNOPSIS
.sp
\fB#include
.sp
FcConfig * FcConfigCreate (void\fI\fB);
\fR
.SH "DESCRIPTION"
.PP
Creates an empty configuration.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcConfigDestroy.3 0100664 0002720 0000144 00000001350 10534406354 015536 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcConfigDestroy" "3" "02 December 2006" "" ""
.SH NAME
FcConfigDestroy \- Destroy a configuration
.SH SYNOPSIS
.sp
\fB#include
.sp
void FcConfigDestroy (FcConfig *\fIconfig\fB);
\fR
.SH "DESCRIPTION"
.PP
Destroys a configuration and any data associated with it. Note that calling
this function with the return from FcConfigGetCurrent will place the library
in an indeterminate state.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcConfigSetCurrent.3 0100664 0002720 0000144 00000001326 10534406354 016206 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcConfigSetCurrent" "3" "02 December 2006" "" ""
.SH NAME
FcConfigSetCurrent \- Set configuration as default
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcConfigSetCurrent (FcConfig *\fIconfig\fB);
\fR
.SH "DESCRIPTION"
.PP
Sets the current default configuration to \fIconfig\fR\&. Implicitly calls
FcConfigBuildFonts if necessary, returning FcFalse if that call fails.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcConfigGetCurrent.3 0100664 0002720 0000144 00000001146 10534406354 016172 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcConfigGetCurrent" "3" "02 December 2006" "" ""
.SH NAME
FcConfigGetCurrent \- Return current configuration
.SH SYNOPSIS
.sp
\fB#include
.sp
FcConfig * FcConfigGetCurrent (void\fI\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the current default configuration.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcConfigUptoDate.3 0100664 0002720 0000144 00000001275 10534406354 015640 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcConfigUptoDate" "3" "02 December 2006" "" ""
.SH NAME
FcConfigUptoDate \- Check timestamps on config files
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcConfigUptoDate (FcConfig *\fIconfig\fB);
\fR
.SH "DESCRIPTION"
.PP
Checks all of the files related to \fIconfig\fR and returns whether the
in-memory version is in sync with the disk version.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcConfigBuildFonts.3 0100664 0002720 0000144 00000001407 10534406354 016161 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcConfigBuildFonts" "3" "02 December 2006" "" ""
.SH NAME
FcConfigBuildFonts \- Build font database
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcConfigBuildFonts (FcConfig *\fIconfig\fB);
\fR
.SH "DESCRIPTION"
.PP
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.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcConfigGetConfigDirs.3 0100664 0002720 0000144 00000001317 10534406354 016577 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcConfigGetConfigDirs" "3" "02 December 2006" "" ""
.SH NAME
FcConfigGetConfigDirs \- Get config directories
.SH SYNOPSIS
.sp
\fB#include
.sp
FcStrList * FcConfigGetConfigDirs (FcConfig *\fIconfig\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the list of font directories specified in the configuration files
for \fIconfig\fR\&. Does not include any subdirectories.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcConfigGetFontDirs.3 0100664 0002720 0000144 00000001343 10534406354 016277 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcConfigGetFontDirs" "3" "02 December 2006" "" ""
.SH NAME
FcConfigGetFontDirs \- Get font directories
.SH SYNOPSIS
.sp
\fB#include
.sp
FcStrList * FcConfigGetFontDirs (FcConfig *\fIconfig\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the list of font directories in \fIconfig\fR\&. This includes the
configured font directories along with any directories below those in the
filesystem.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcConfigGetConfigFiles.3 0100664 0002720 0000144 00000001342 10534406354 016736 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcConfigGetConfigFiles" "3" "02 December 2006" "" ""
.SH NAME
FcConfigGetConfigFiles \- Get config files
.SH SYNOPSIS
.sp
\fB#include
.sp
FcStrList * FcConfigGetConfigFiles (FcConfig *\fIconfig\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the list of known configuration files used to generate \fIconfig\fR\&.
Note that this will not include any configuration done with FcConfigParse.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcConfigGetCache.3 0100664 0002720 0000144 00000001171 10534406354 015551 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcConfigGetCache" "3" "02 December 2006" "" ""
.SH NAME
FcConfigGetCache \- Get cache filename
.SH SYNOPSIS
.sp
\fB#include
.sp
char * FcConfigGetCache (FcConfig *\fIconfig\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the name of the file used to store per-user font information.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcConfigGetFonts.3 0100664 0002720 0000144 00000001247 10534406354 015643 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcConfigGetFonts" "3" "02 December 2006" "" ""
.SH NAME
FcConfigGetFonts \- Get config font set
.SH SYNOPSIS
.sp
\fB#include
.sp
FcFontSet * FcConfigGetFonts (FcConfig *\fIconfig\fB, FcSetName \fIset\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns one of the two sets of fonts from the configuration as specified
by \fIset\fR\&.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcConfigGetBlanks.3 0100664 0002720 0000144 00000001313 10534406354 015756 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcConfigGetBlanks" "3" "02 December 2006" "" ""
.SH NAME
FcConfigGetBlanks \- Get config blanks
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBlanks * FcConfigGetBlanks (FcConfig *\fIconfig\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the FcBlanks object associated with the given configuration, if no
blanks were present in the configuration, this function will return 0.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcConfigGetRescanInverval.3 0100664 0002720 0000144 00000001456 10534406354 017476 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcConfigGetRescanInverval" "3" "02 December 2006" "" ""
.SH NAME
FcConfigGetRescanInverval \- Get config rescan interval
.SH SYNOPSIS
.sp
\fB#include
.sp
int FcConfigGetRescanInverval (FcConfig *\fIconfig\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the interval between automatic checks of the configuration (in
seconds) specified in \fIconfig\fR\&. The configuration is checked during
a call to FcFontList when this interval has passed since the last check.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcConfigSetRescanInverval.3 0100664 0002720 0000144 00000001260 10534406354 017503 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcConfigSetRescanInverval" "3" "02 December 2006" "" ""
.SH NAME
FcConfigSetRescanInverval \- Set config rescan interval
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcConfigSetRescanInverval (FcConfig *\fIconfig\fB, int \fIrescanInterval\fB);
\fR
.SH "DESCRIPTION"
.PP
Sets the rescan interval; returns FcFalse if an error occurred.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcConfigAppFontAddFile.3 0100664 0002720 0000144 00000001241 10534406354 016664 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcConfigAppFontAddFile" "3" "02 December 2006" "" ""
.SH NAME
FcConfigAppFontAddFile \- Add font file to font database
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcConfigAppFontAddFile (FcConfig *\fIconfig\fB, const char *\fIfile\fB);
\fR
.SH "DESCRIPTION"
.PP
Adds an application-specific font to the configuration.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcConfigAppFontAddDir.3 0100664 0002720 0000144 00000001326 10534406354 016527 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcConfigAppFontAddDir" "3" "02 December 2006" "" ""
.SH NAME
FcConfigAppFontAddDir \- Add fonts from directory to font database
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcConfigAppFontAddDir (FcConfig *\fIconfig\fB, const char *\fI\fB);
\fR
.SH "DESCRIPTION"
.PP
Scans the specified directory for fonts, adding each one found to the
application-specific set of fonts.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcConfigAppFontClear.3 0100664 0002720 0000144 00000001200 10534406354 016415 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcConfigAppFontClear" "3" "02 December 2006" "" ""
.SH NAME
FcConfigAppFontClear \- Remove all app fonts from font database
.SH SYNOPSIS
.sp
\fB#include
.sp
void FcConfigAppFontClear (FcConfig *\fIconfig\fB);
\fR
.SH "DESCRIPTION"
.PP
Clears the set of application-specific fonts.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcConfigSubstituteWithPat.3 0100664 0002720 0000144 00000001657 10534406354 017573 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcConfigSubstituteWithPat" "3" "02 December 2006" "" ""
.SH NAME
FcConfigSubstituteWithPat \- Execute substitutions
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcConfigSubstituteWithPat (FcConfig *\fIconfig\fB, FcPattern *\fIp\fB, FcPattern *\fIp_pat\fB, FcMatchKind \fIkind\fB);
\fR
.SH "DESCRIPTION"
.PP
Performs the sequence of pattern modification operations, if \fIkind\fR is
FcMatchPattern, then those tagged as pattern operations are applied, else
if \fIkind\fR is FcMatchFont, those tagged as font operations are applied and
p_pat is used for elements with target=pattern.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcConfigSubstitute.3 0100664 0002720 0000144 00000001237 10534406354 016264 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcConfigSubstitute" "3" "02 December 2006" "" ""
.SH NAME
FcConfigSubstitute \- Execute substitutions
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcConfigSubstitute (FcConfig *\fIconfig\fB, FcPattern *\fIp\fB, FcMatchKind \fIkind\fB);
\fR
.SH "DESCRIPTION"
.PP
Calls FcConfigSubstituteWithPat setting p_pat to NULL.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcFontMatch.3 0100664 0002720 0000144 00000001462 10534406354 014646 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcFontMatch" "3" "02 December 2006" "" ""
.SH NAME
FcFontMatch \- Return best font
.SH SYNOPSIS
.sp
\fB#include
.sp
FcPattern * FcFontMatch (FcConfig *\fIconfig\fB, FcPattern *\fIp\fB, FcResult *\fIresult\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the font in \fIconfig\fR most close matching \fIp\fR\&. This function
should be called only after FcConfigSubstitute and FcDefaultSubstitute have
been called for \fIp\fR; otherwise the results will not be correct.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcFontSort.3 0100664 0002720 0000144 00000002720 10534406354 014537 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcFontSort" "3" "02 December 2006" "" ""
.SH NAME
FcFontSort \- Return list of matching fonts
.SH SYNOPSIS
.sp
\fB#include
.sp
FcFontSet * FcFontSort (FcConfig *\fIconfig\fB, FcPattern *\fIp\fB, FcBool \fItrim\fB, FcCharSet **\fIcsp\fB, FcResult *\fIresult\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the list of fonts sorted by closeness to \fIp\fR\&. If \fItrim\fR 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 \fIcsp\fR, if \fIcsp\fR is not NULL. This function
should be called only after FcConfigSubstitute and FcDefaultSubstitute have
been called for \fIp\fR; otherwise the results will not be correct.
.PP
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 \fIp\fR to
FcFontRenderPrepare which combines them into a complete pattern.
.PP
The FcFontSet returned by FcFontSort is destroyed by caling FcFontSetDestroy.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcFontRenderPrepare.3 0100664 0002720 0000144 00000001660 10534406354 016350 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcFontRenderPrepare" "3" "02 December 2006" "" ""
.SH NAME
FcFontRenderPrepare \- Prepare pattern for loading font file
.SH SYNOPSIS
.sp
\fB#include
.sp
FcPattern * FcFontRenderPrepare (FcConfig *\fIconfig\fB, FcPattern *\fIpat\fB, FcPattern *\fIfont\fB);
\fR
.SH "DESCRIPTION"
.PP
Creates a new pattern consisting of elements of \fIfont\fR not appearing
in \fIpat\fR, elements of \fIpat\fR not appearing in \fIfont\fR and the best matching
value from \fIpat\fR for elements appearing in both. The result is passed to
FcConfigSubstitute with \fIkind\fR FcMatchFont and then returned.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcFontList.3 0100664 0002720 0000144 00000001340 10534406354 014520 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcFontList" "3" "02 December 2006" "" ""
.SH NAME
FcFontList \- List fonts
.SH SYNOPSIS
.sp
\fB#include
.sp
FcFontSet * FcFontList (FcConfig *\fIconfig\fB, FcPattern *\fIp\fB, FcObjectSet *\fIos\fB);
\fR
.SH "DESCRIPTION"
.PP
Selects fonts matching \fIp\fR, creates patterns from those fonts containing
only the objects in \fIos\fR and returns the set of unique such patterns.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcConfigFilename.3 0100664 0002720 0000144 00000002305 10534406354 015626 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcConfigFilename" "3" "02 December 2006" "" ""
.SH NAME
FcConfigFilename \- Find a config file
.SH SYNOPSIS
.sp
\fB#include
.sp
char * FcConfigFilename (const char *\fIname\fB);
\fR
.SH "DESCRIPTION"
.PP
Given the specified external entity name, return the associated filename.
This provides applications a way to convert various configuration file
references into filename form.
.PP
A null or empty \fIname\fR indicates that the default configuration file should
be used; which file this references can be overridden with the
FC_CONFIG_FILE environment variable. Next, if the name starts with \fI~\fR, 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
FC_CONFIG_DIR environment variable.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcConfigParseAndLoad.3 0100664 0002720 0000144 00000001560 10534406354 016405 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcConfigParseAndLoad" "3" "02 December 2006" "" ""
.SH NAME
FcConfigParseAndLoad \- load a configuration file
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcConfigParseAndLoad (FcConfig *\fIconfig\fB, const FcChar8 *\fIfile\fB);
\fR
.SH "DESCRIPTION"
.PP
Walks the configuration in 'file' and constructs the internal representation
in 'config'. Any include files referenced from within 'file' will be loaded
with FcConfigLoad and also parsed. If 'complain' is FcFalse, no warning
will be displayed if 'file' does not exist.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcNameRegisterConstants.3 0100664 0002720 0000144 00000001233 10534406354 017241 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcNameRegisterConstants" "3" "02 December 2006" "" ""
.SH NAME
FcNameRegisterConstants \- Register symbolic constants
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcNameRegisterConstants (const FcConstant *\fIconsts\fB, int \fInconsts\fB);
\fR
.SH "DESCRIPTION"
.PP
Register \fInconsts\fR new symbolic constants.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcNameUnregisterConstants.3 0100664 0002720 0000144 00000001241 10534406354 017603 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcNameUnregisterConstants" "3" "02 December 2006" "" ""
.SH NAME
FcNameUnregisterConstants \- Unregister symbolic constants
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcNameUnregisterConstants (const FcConstant *\fIconsts\fB, int \fInconsts\fB);
\fR
.SH "DESCRIPTION"
.PP
Unregister \fInconsts\fR symbolic constants.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcNameGetConstant.3 0100664 0002720 0000144 00000001224 10534406354 016011 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcNameGetConstant" "3" "02 December 2006" "" ""
.SH NAME
FcNameGetConstant \- Lookup symbolic constant
.SH SYNOPSIS
.sp
\fB#include
.sp
const FcConstant * FcNameGetConstant (FcChar8 *\fIstring\fB);
\fR
.SH "DESCRIPTION"
.PP
Return the FcConstant structure related to symbolic constant \fIstring\fR\&.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcNameConstant.3 0100664 0002720 0000144 00000001332 10534406354 015351 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcNameConstant" "3" "02 December 2006" "" ""
.SH NAME
FcNameConstant \- Get the value for a symbolic constant
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcNameConstant (FcChar8 *\fIstring\fB, int *\fIresult\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns whether a symbolic constant with name \fIstring\fR is registered,
placing the value of the constant in \fIresult\fR if present.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcFileScan.3 0100664 0002720 0000144 00000001567 10534406354 014455 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcFileScan" "3" "02 December 2006" "" ""
.SH NAME
FcFileScan \- scan a font file
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcFileScan (FcFontSet *\fIset\fB, FcStrSet *\fIdirs\fB, FcFileCache *\fIcache\fB, FcBlanks *\fIblanks\fB, const char *\fIfile\fB, FcBool \fIforce\fB);
\fR
.SH "DESCRIPTION"
.PP
Scans a single file and adds all fonts found to \fIset\fR\&.
If \fIforce\fR is FcTrue, then the file is scanned even if
associated information is found in \fIcache\fR\&. If
\fIfile\fR is a directory, it is added to
\fIdirs\fR\&.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcDirScan.3 0100664 0002720 0000144 00000001655 10534406354 014312 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcDirScan" "3" "02 December 2006" "" ""
.SH NAME
FcDirScan \- scan a font directory
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcDirScan (FcFontSet *\fIset\fB, FcStrSet *\fIdirs\fB, FcFileCache *\fIcache\fB, FcBlanks *\fIblanks\fB, const char *\fIdir\fB, FcBool \fIforce\fB);
\fR
.SH "DESCRIPTION"
.PP
Scans an entire directory and adds all fonts found to
\fIset\fR\&. If \fIforce\fR is FcTrue, then
the directory and all files within it are scanned even if information is
present in the per-directory cache file or \fIcache\fR\&. Any
subdirectories found are added to \fIdirs\fR\&.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcDirSave.3 0100664 0002720 0000144 00000001321 10534406354 014312 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcDirSave" "3" "02 December 2006" "" ""
.SH NAME
FcDirSave \- save a directory cache
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcDirSave (FcFontSet *\fIset\fB, FcStrSet *\fIdirs\fB, const char *\fIdir\fB);
\fR
.SH "DESCRIPTION"
.PP
Creates the per-directory cache file for \fIdir\fR and
populates it with the fonts in \fIset\fR and subdirectories
in \fIdirs\fR\&.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcDirCacheValid.3 0100664 0002720 0000144 00000001245 10534406354 015404 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcDirCacheValid" "3" "02 December 2006" "" ""
.SH NAME
FcDirCacheValid \- check directory cache timestamp
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcDirCacheValid (const FcChar8 *\fIcache_file\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns FcTrue if \fIcache_file\fR is no older than the
directory containing it, else FcFalse.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcFontSetCreate.3 0100664 0002720 0000144 00000001103 10534406353 015460 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcFontSetCreate" "3" "02 December 2006" "" ""
.SH NAME
FcFontSetCreate \- Create a font set
.SH SYNOPSIS
.sp
\fB#include
.sp
FcFontSet * FcFontSetCreate (void\fI\fB);
\fR
.SH "DESCRIPTION"
.PP
Creates an empty font set.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcFontSetDestroy.3 0100664 0002720 0000144 00000001174 10534406354 015717 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcFontSetDestroy" "3" "02 December 2006" "" ""
.SH NAME
FcFontSetDestroy \- Destroy a font set
.SH SYNOPSIS
.sp
\fB#include
.sp
void FcFontSetDestroy (FcFontSet *\fIs\fB);
\fR
.SH "DESCRIPTION"
.PP
Destroys a font set. Note that this destroys any referenced patterns as
well.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcFontSetAdd.3 0100664 0002720 0000144 00000001240 10534406354 014750 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcFontSetAdd" "3" "02 December 2006" "" ""
.SH NAME
FcFontSetAdd \- Add to a font set
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcFontSetAdd (FcFontSet *\fIs\fB, FcPattern *\fIfont\fB);
\fR
.SH "DESCRIPTION"
.PP
Adds a pattern to a font set. Note that the pattern is not copied before
being inserted into the set.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcFreeTypeCharIndex.3 0100664 0002720 0000144 00000001644 10534406354 016276 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcFreeTypeCharIndex" "3" "02 December 2006" "" ""
.SH NAME
FcFreeTypeCharIndex \- map Unicode to glyph id
.SH SYNOPSIS
.sp
\fB#include
#include
.sp
FT_UInt FcFreeTypeCharIndex (FT_Face \fIface\fB, FcChar32 \fIucs4\fB);
\fR
.SH "DESCRIPTION"
.PP
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.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcFreeTypeCharSet.3 0100664 0002720 0000144 00000001611 10534406354 015754 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcFreeTypeCharSet" "3" "02 December 2006" "" ""
.SH NAME
FcFreeTypeCharSet \- compute unicode coverage
.SH SYNOPSIS
.sp
\fB#include
#include
.sp
FcCharSet * FcFreeTypeCharSet (FT_Face \fIface\fB, FcBlanks *\fIblanks\fB);
\fR
.SH "DESCRIPTION"
.PP
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.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcFreeTypeQuery.3 0100664 0002720 0000144 00000001421 10534406354 015527 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcFreeTypeQuery" "3" "02 December 2006" "" ""
.SH NAME
FcFreeTypeQuery \- compute pattern from font file (and index)
.SH SYNOPSIS
.sp
\fB#include
#include
.sp
FcPattern * FcFreeTypeQuery (const char *\fIfile\fB, int \fIid\fB, FcBlanks *\fIblanks\fB, int *\fIcount\fB);
\fR
.SH "DESCRIPTION"
.PP
Constructs a pattern representing the 'id'th font in 'file'. The number
of fonts in 'file' is returned in 'count'.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcFreeTypeQueryFace.3 0100664 0002720 0000144 00000001467 10534406354 016320 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcFreeTypeQueryFace" "3" "02 December 2006" "" ""
.SH NAME
FcFreeTypeQueryFace \- compute pattern from FT_Face
.SH SYNOPSIS
.sp
\fB#include
#include
.sp
FcPattern * FcFreeTypeQueryFace (const FT_Face \fIface\fB, const char *\fIfile\fB, int \fIid\fB, FcBlanks *\fIblanks\fB);
\fR
.SH "DESCRIPTION"
.PP
Constructs a pattern representing 'face'. 'file' and 'id' are used solely as
data for pattern elements (FC_FILE, FC_INDEX and sometimes FC_FAMILY).
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcInitLoadConfig.3 0100664 0002720 0000144 00000001235 10534406353 015611 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcInitLoadConfig" "3" "02 December 2006" "" ""
.SH NAME
FcInitLoadConfig \- load configuration
.SH SYNOPSIS
.sp
\fB#include
.sp
FcConfig * FcInitLoadConfig (void\fI\fB);
\fR
.SH "DESCRIPTION"
.PP
Loads the default configuration file and returns the resulting configuration.
Does not load any font information.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcInitLoadConfigAndFonts.3 0100664 0002720 0000144 00000001316 10534406353 017246 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcInitLoadConfigAndFonts" "3" "02 December 2006" "" ""
.SH NAME
FcInitLoadConfigAndFonts \- load configuration and font data
.SH SYNOPSIS
.sp
\fB#include
.sp
FcConfig * FcInitLoadConfigAndFonts (void\fI\fB);
\fR
.SH "DESCRIPTION"
.PP
Loads the default configuration file and builds information about the
available fonts. Returns the resulting configuration.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcInit.3 0100664 0002720 0000144 00000001442 10534406353 013663 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcInit" "3" "02 December 2006" "" ""
.SH NAME
FcInit \- initialize fontconfig library
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcInit (void\fI\fB);
\fR
.SH "DESCRIPTION"
.PP
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.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcFini.3 0100664 0002720 0000144 00000001364 10534406353 013650 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcFini" "3" "02 December 2006" "" ""
.SH NAME
FcFini \- finalize fonconfig library
.SH SYNOPSIS
.sp
\fB#include
.sp
void FcFini (void\fI\fB);
\fR
.SH "DESCRIPTION"
.PP
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.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcGetVersion.3 0100664 0002720 0000144 00000001107 10534406353 015043 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcGetVersion" "3" "02 December 2006" "" ""
.SH NAME
FcGetVersion \- library version number
.SH SYNOPSIS
.sp
\fB#include
.sp
int FcGetVersion (void\fI\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the version number of the library.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcInitReinitialize.3 0100664 0002720 0000144 00000001213 10534406353 016230 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcInitReinitialize" "3" "02 December 2006" "" ""
.SH NAME
FcInitReinitialize \- re-initialize library
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcInitReinitialize (void\fI\fB);
\fR
.SH "DESCRIPTION"
.PP
Forces the default configuration file to be reloaded and resets the default
configuration.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcInitBringUptoDate.3 0100664 0002720 0000144 00000001363 10534406353 016315 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcInitBringUptoDate" "3" "02 December 2006" "" ""
.SH NAME
FcInitBringUptoDate \- reload configuration files if needed
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcInitBringUptoDate (void\fI\fB);
\fR
.SH "DESCRIPTION"
.PP
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.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcMatrixInit.3 0100664 0002720 0000144 00000001167 10534406354 015055 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcMatrixInit" "3" "02 December 2006" "" ""
.SH NAME
FcMatrixInit \- initialize an FcMatrix structure
.SH SYNOPSIS
.sp
\fB#include
.sp
void FcMatrixInit (FcMatrix *\fImatrix\fB);
\fR
.SH "DESCRIPTION"
.PP
\fBFcMatrixInit\fR initializes \fImatrix\fR
to the identity matrix.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcMatrixCopy.3 0100664 0002720 0000144 00000001160 10534406354 015055 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcMatrixCopy" "3" "02 December 2006" "" ""
.SH NAME
FcMatrixCopy \- Copy a matrix
.SH SYNOPSIS
.sp
\fB#include
.sp
void FcMatrixCopy (const FcMatrix *\fImatrix\fB);
\fR
.SH "DESCRIPTION"
.PP
\fBFcMatrixCopy\fR allocates a new FcMatrix
and copies \fImat\fR into it.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcMatrixEqual.3 0100664 0002720 0000144 00000001321 10534406354 015211 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcMatrixEqual" "3" "02 December 2006" "" ""
.SH NAME
FcMatrixEqual \- Compare two matrices
.SH SYNOPSIS
.sp
\fB#include
.sp
void FcMatrixEqual (const FcMatrix *\fImatrix1\fB, const FcMatrix *\fImatrix2\fB);
\fR
.SH "DESCRIPTION"
.PP
\fBFcMatrixEqual\fR compares \fImatrix1\fR
and \fImatrix2\fR returning FcTrue when they are equal and
FcFalse when they are not.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcMatrixMultiply.3 0100664 0002720 0000144 00000001326 10534406354 015766 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcMatrixMultiply" "3" "02 December 2006" "" ""
.SH NAME
FcMatrixMultiply \- Multiply matrices
.SH SYNOPSIS
.sp
\fB#include
.sp
void FcMatrixMultiply (FcMatrix *\fIresult\fB, const FcMatrix *\fImatrix1\fB, const FcMatrix *\fImatrix2\fB);
\fR
.SH "DESCRIPTION"
.PP
\fBFcMatrixMultiply\fR multiplies
\fImatrix1\fR and \fImatrix2\fR storing
the result in \fIresult\fR\&.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcMatrixRotate.3 0100664 0002720 0000144 00000001401 10534406354 015377 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcMatrixRotate" "3" "02 December 2006" "" ""
.SH NAME
FcMatrixRotate \- Rotate a matrix
.SH SYNOPSIS
.sp
\fB#include
.sp
void FcMatrixRotate (FcMatrix *\fImatrix\fB, double \fIcos\fB, double \fIsin\fB);
\fR
.SH "DESCRIPTION"
.PP
\fBFcMatrixRotate\fR rotates \fImatrix\fR
by the angle who's sine is \fIsin\fR and cosine is
\fIcos\fR\&. This is done by multiplying by the
matrix:
.nf
cos -sin
sin cos
.fi
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcMatrixScale.3 0100664 0002720 0000144 00000001353 10534406354 015176 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcMatrixScale" "3" "02 December 2006" "" ""
.SH NAME
FcMatrixScale \- Scale a matrix
.SH SYNOPSIS
.sp
\fB#include
.sp
void FcMatrixScale (FcMatrix *\fImatrix\fB, double \fIsx\fB, double \fIdy\fB);
\fR
.SH "DESCRIPTION"
.PP
\fBFcMatrixScale\fR multiplies \fImatrix\fR
x values by \fIsx\fR and y values by
\fIsy\fR\&. This is done by multiplying by
the matrix:
.nf
sx 0
0 sy
.fi
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcMatrixShear.3 0100664 0002720 0000144 00000001352 10534406354 015210 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcMatrixShear" "3" "02 December 2006" "" ""
.SH NAME
FcMatrixShear \- Shear a matrix
.SH SYNOPSIS
.sp
\fB#include
.sp
void FcMatrixShear (FcMatrix *\fImatrix\fB, double \fIsh\fB, double \fIsv\fB);
\fR
.SH "DESCRIPTION"
.PP
\fBFcMatrixShare\fR shears \fImatrix\fR
horizontally by \fIsh\fR and vertically by
\fIsv\fR\&. This is done by multiplying by
the matrix:
.nf
1 sh
sv 1
.fi
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcObjectSetCreate.3 0100664 0002720 0000144 00000001111 10534406354 015760 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcObjectSetCreate" "3" "02 December 2006" "" ""
.SH NAME
FcObjectSetCreate \- Create an object set
.SH SYNOPSIS
.sp
\fB#include
.sp
FcObjectSet * FcObjectSetCreate (void\fI\fB);
\fR
.SH "DESCRIPTION"
.PP
Creates an empty set.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcObjectSetAdd.3 0100664 0002720 0000144 00000001151 10534406354 015251 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcObjectSetAdd" "3" "02 December 2006" "" ""
.SH NAME
FcObjectSetAdd \- Add to an object set
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcObjectSetAdd (FcObjectSet *\fIos\fB, const char *\fIobject\fB);
\fR
.SH "DESCRIPTION"
.PP
Adds a proprety name to the set.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcObjectSetDestroy.3 0100664 0002720 0000144 00000001121 10534406354 016207 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcObjectSetDestroy" "3" "02 December 2006" "" ""
.SH NAME
FcObjectSetDestroy \- Destroy an object set
.SH SYNOPSIS
.sp
\fB#include
.sp
void FcObjectSetDestroy (FcObjectSet *\fIos\fB);
\fR
.SH "DESCRIPTION"
.PP
Destroys an object set.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcObjectSetBuild.3 0100664 0002720 0000144 00000001377 10534406354 015632 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcObjectSetBuild" "3" "02 December 2006" "" ""
.SH NAME
FcObjectSetBuild, FcObjectSetVaBuild \- Build object set from args
.SH SYNOPSIS
.sp
\fB#include
.sp
FcObjectSet * FcObjectSetBuild (const char *\fIfirst\fB, \&...\fI\fB);
.sp
FcObjectSet * FcObjectSetVaBuild (const char *\fIfirst\fB, va_list \fIva\fB);
\fR
.SH "DESCRIPTION"
.PP
These build an object set from a null-terminated list of property names.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcNameRegisterObjectTypes.3 0100664 0002720 0000144 00000001222 10534406354 017516 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcNameRegisterObjectTypes" "3" "02 December 2006" "" ""
.SH NAME
FcNameRegisterObjectTypes \- Register object types
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcNameRegisterObjectTypes (const FcObjectType *\fItypes\fB, int \fIntype\fB);
\fR
.SH "DESCRIPTION"
.PP
Register \fIntype\fR new object types.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcNameUnregisterObjectTypes.3 0100664 0002720 0000144 00000001230 10534406354 020060 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcNameUnregisterObjectTypes" "3" "02 December 2006" "" ""
.SH NAME
FcNameUnregisterObjectTypes \- Unregister object types
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcNameUnregisterObjectTypes (const FcObjectType *\fItypes\fB, int \fIntype\fB);
\fR
.SH "DESCRIPTION"
.PP
Unregister \fIntype\fR object types.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcNameGetObjectType.3 0100664 0002720 0000144 00000001224 10534406354 016270 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcNameGetObjectType" "3" "02 December 2006" "" ""
.SH NAME
FcNameGetObjectType \- Lookup an object type
.SH SYNOPSIS
.sp
\fB#include
.sp
const FcObjectType * FcNameGetObjectType (const char *\fIobject\fB);
\fR
.SH "DESCRIPTION"
.PP
Return the object type for the pattern element named \fIobject\fR\&.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcPatternCreate.3 0100664 0002720 0000144 00000001162 10534406353 015520 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcPatternCreate" "3" "02 December 2006" "" ""
.SH NAME
FcPatternCreate \- Create a pattern
.SH SYNOPSIS
.sp
\fB#include
.sp
FcPattern * FcPatternCreate (void\fI\fB);
\fR
.SH "DESCRIPTION"
.PP
Creates a pattern with no properties; used to build patterns from scratch.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcPatternDestroy.3 0100664 0002720 0000144 00000001156 10534406353 015751 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcPatternDestroy" "3" "02 December 2006" "" ""
.SH NAME
FcPatternDestroy \- Destroy a pattern
.SH SYNOPSIS
.sp
\fB#include
.sp
void FcPatternDestroy (FcPattern *\fIp\fB);
\fR
.SH "DESCRIPTION"
.PP
Destroys a pattern, in the process destroying all related values.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcPatternEqual.3 0100664 0002720 0000144 00000001202 10534406353 015357 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcPatternEqual" "3" "02 December 2006" "" ""
.SH NAME
FcPatternEqual \- Compare patterns
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcPatternEqual (const FcPattern *\fIpa\fB, const FcPattern *\fIpb\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns whether \fIpa\fR and \fIpb\fR are exactly alike.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcPatternEqualSubset.3 0100664 0002720 0000144 00000001355 10534406353 016556 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcPatternEqualSubset" "3" "02 December 2006" "" ""
.SH NAME
FcPatternEqualSubset \- Compare portions of patterns
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcPatternEqualSubset (const FcPattern *\fIpa\fB, const FcPattern *\fIpb\fB, const FcObjectSet *\fIos\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns whether \fIpa\fR and \fIpb\fR have exactly the same values for all of the
objects in \fIos\fR\&.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcPatternHash.3 0100664 0002720 0000144 00000001210 10534406353 015172 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcPatternHash" "3" "02 December 2006" "" ""
.SH NAME
FcPatternHash \- Compute a pattern hash value
.SH SYNOPSIS
.sp
\fB#include
.sp
FcChar32 FcPatternHash (const FcPattern *\fIp\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns a 32-bit number which is the same for any two patterns which are
equal.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcPatternAdd.3 0100664 0002720 0000144 00000001731 10534406353 015007 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcPatternAdd" "3" "02 December 2006" "" ""
.SH NAME
FcPatternAdd \- Add a value to a pattern
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcPatternAdd (FcPattern *\fIp\fB, const char *\fIobject\fB, FcValue \fIvalue\fB, FcBool \fIappend\fB);
\fR
.SH "DESCRIPTION"
.PP
Adds a single value to the list of values associated with the property named
`object\fI\&. If `append\fR is FcTrue, the value is added at the end of any
existing list, otherwise it is inserted at the begining. `value' is saved
(with FcValueSave) when inserted into the pattern so that the library
retains no reference to any application-supplied data structure.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcPatternAddWeak.3 0100664 0002720 0000144 00000001440 10534406353 015614 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcPatternAddWeak" "3" "02 December 2006" "" ""
.SH NAME
FcPatternAddWeak \- Add a value to a pattern with weak binding
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcPatternAddWeak (FcPattern *\fIp\fB, const char *\fIobject\fB, FcValue \fIvalue\fB, FcBool \fIappend\fB);
\fR
.SH "DESCRIPTION"
.PP
FcPatternAddWeak is essentially the same as FcPatternAdd except that any
values added to the list have binding \fIweak\fR instead of \fIstrong\fR\&.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcPatternAdd-Type.3 0100664 0002720 0000144 00000002653 10534406353 015732 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcPatternAdd-Type" "3" "02 December 2006" "" ""
.SH NAME
FcPatternAddInteger, FcPatternAddDouble, FcPatternAddString, FcPatternAddMatrix, FcPatternAddCharSet, FcPatternAddBool \- Add a typed value to a pattern
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcPatternAddInteger (FcPattern *\fIp\fB, const char *\fIobject\fB, int \fIi\fB);
.sp
FcBool FcPatternAddDouble (FcPattern *\fIp\fB, const char *\fIobject\fB, double \fId\fB);
.sp
FcBool FcPatternAddString (FcPattern *\fIp\fB, const char *\fIobject\fB, const char *\fIs\fB);
.sp
FcBool FcPatternAddMatrix (FcPattern *\fIp\fB, const char *\fIobject\fB, const FcMatrix *\fIm\fB);
.sp
FcBool FcPatternAddCharSet (FcPattern *\fIp\fB, const char *\fIobject\fB, const FcCharSet *\fIc\fB);
.sp
FcBool FcPatternAddBool (FcPattern *\fIp\fB, const char *\fIobject\fB, FcBool \fIb\fB);
\fR
.SH "DESCRIPTION"
.PP
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.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcPatternGet.3 0100664 0002720 0000144 00000001516 10534406353 015037 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcPatternGet" "3" "02 December 2006" "" ""
.SH NAME
FcPatternGet \- Return a value from a pattern
.SH SYNOPSIS
.sp
\fB#include
.sp
FcResult FcPatternGet (FcPattern *\fIp\fB, const char *\fIobject\fB, int \fIid\fB, FcValue *\fIv\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns in \fIv\fR the \fIid\fR\&'th value
associated with the property \fIobject\fR\&.
The value returned is not a copy, but rather refers to the data stored
within the pattern directly. Applications must not free this value.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcPatternGet-Type.3 0100664 0002720 0000144 00000003172 10534406353 015756 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcPatternGet-Type" "3" "02 December 2006" "" ""
.SH NAME
FcPatternGetInteger, FcPatternGetDouble, FcPatternGetString, FcPatternGetMatrix, FcPatternGetCharSet, FcPatternGetBool \- Return a typed value from a pattern
.SH SYNOPSIS
.sp
\fB#include
.sp
FcResult FcPatternGetInteger (FcPattern *\fIp\fB, const char *\fIobject\fB, int \fIn\fB, int *\fIi\fB);
.sp
FcResult FcPatternGetDouble (FcPattern *\fIp\fB, const char *\fIobject\fB, int \fIn\fB, double *\fId\fB);
.sp
FcResult FcPatternGetString (FcPattern *\fIp\fB, const char *\fIobject\fB, int \fIn\fB, char **const\fIs\fB);
.sp
FcResult FcPatternGetMatrix (FcPattern *\fIp\fB, const char *\fIobject\fB, int \fIn\fB, FcMatrix **\fIs\fB);
.sp
FcResult FcPatternGetCharSet (FcPattern *\fIp\fB, const char *\fIobject\fB, int \fIn\fB, FcCharSet **\fIc\fB);
.sp
FcResult FcPatternGetBool (FcPattern *\fIp\fB, const char *\fIobject\fB, int \fIn\fB, FcBool *\fIb\fB);
\fR
.SH "DESCRIPTION"
.PP
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.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcPatternBuild.3 0100664 0002720 0000144 00000002751 10534406353 015361 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcPatternBuild" "3" "02 December 2006" "" ""
.SH NAME
FcPatternBuild, FcPatternVaBuild \- Create patterns from arguments
.SH SYNOPSIS
.sp
\fB#include
.sp
FcPattern * FcPatternBuild (FcPattern *\fIorig\fB, \&...\fI\fB);
.sp
FcPattern * FcPatternVaBuild (FcPattern *\fIorig\fB, va_list \fIva\fB);
\fR
.SH "DESCRIPTION"
.PP
Builds a pattern using a list of objects, types and values. Each
value to be entered in the pattern is specified with three arguments:
.TP 3
1.
Object name, a string describing the property to be added.
.TP 3
2.
Object type, one of the FcType enumerated values
.TP 3
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.
.PP
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
.nf
pattern = FcPatternBuild (0, FC_FAMILY, FcTypeString, "Times", (char *) 0);
.fi
.PP
FcPatternVaBuild is used when the arguments are already in the form of a
varargs value.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcPatternDel.3 0100664 0002720 0000144 00000001265 10534406353 015025 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcPatternDel" "3" "02 December 2006" "" ""
.SH NAME
FcPatternDel \- Delete a property from a pattern
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcPatternDel (FcPattern *\fIp\fB, const char *\fIobject\fB);
\fR
.SH "DESCRIPTION"
.PP
Deletes all values associated with the property `object', returning
whether the property existed or not.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcPatternRemove.3 0100664 0002720 0000144 00000001425 10534406353 015554 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcPatternRemove" "3" "02 December 2006" "" ""
.SH NAME
FcPatternRemove \- Remove one object of the specified type from the pattern
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcPatternRemove (FcPattern *\fIp\fB, const char *\fIobject\fB, int \fIid\fB);
\fR
.SH "DESCRIPTION"
.PP
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.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcPatternPrint.3 0100664 0002720 0000144 00000001327 10534406353 015414 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcPatternPrint" "3" "02 December 2006" "" ""
.SH NAME
FcPatternPrint \- Print a pattern for debugging
.SH SYNOPSIS
.sp
\fB#include
.sp
void FcPatternPrint (const FcPattern *\fIp\fB);
\fR
.SH "DESCRIPTION"
.PP
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.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcDefaultSubstitute.3 0100664 0002720 0000144 00000001707 10534406353 016444 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcDefaultSubstitute" "3" "02 December 2006" "" ""
.SH NAME
FcDefaultSubstitute \- Perform default substitutions in a pattern
.SH SYNOPSIS
.sp
\fB#include
.sp
void FcDefaultSubstitute (FcPattern *\fIpattern\fB);
\fR
.SH "DESCRIPTION"
.PP
Supplies default values for underspecified font patterns:
.TP 0.2i
\(bu
Patterns without a specified style or weight are set to Medium
.TP 0.2i
\(bu
Patterns without a specified style or slant are set to Roman
.TP 0.2i
\(bu
Patterns without a specified pixel size are given one computed from any
specified point size (default 12), dpi (default 75) and scale (default 1).
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcNameParse.3 0100664 0002720 0000144 00000001177 10534406353 014640 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcNameParse" "3" "02 December 2006" "" ""
.SH NAME
FcNameParse \- Parse a pattern string
.SH SYNOPSIS
.sp
\fB#include
.sp
FcPattern * FcNameParse (const char *\fIname\fB);
\fR
.SH "DESCRIPTION"
.PP
Converts \fIname\fR from the standard text format described above into a pattern.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcNameUnparse.3 0100664 0002720 0000144 00000001414 10534406353 015175 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcNameUnparse" "3" "02 December 2006" "" ""
.SH NAME
FcNameUnparse \- Convert a pattern back into a string that can be parsed
.SH SYNOPSIS
.sp
\fB#include
.sp
FcChar8 * FcNameUnparse (FcPattern *\fIpat\fB);
\fR
.SH "DESCRIPTION"
.PP
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.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcUtf8ToUcs4.3 0100664 0002720 0000144 00000001353 10534406355 014653 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcUtf8ToUcs4" "3" "02 December 2006" "" ""
.SH NAME
FcUtf8ToUcs4 \- convert UTF-8 to UCS4
.SH SYNOPSIS
.sp
\fB#include
.sp
int FcUtf8ToUcs4 (FcChar8 *\fIsrc\fB, FcChar32 *\fIdst\fB, int \fIlen\fB);
\fR
.SH "DESCRIPTION"
.PP
Converts the next Unicode char from \fIsrc\fR into
\fIdst\fR and returns the number of bytes containing the
char. \fIsrc\fR nust be at least
\fIlen\fR bytes long.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcUcs4ToUtf8.3 0100664 0002720 0000144 00000001272 10534406355 014653 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcUcs4ToUtf8" "3" "02 December 2006" "" ""
.SH NAME
FcUcs4ToUtf8 \- convert UCS4 to UTF-8
.SH SYNOPSIS
.sp
\fB#include
.sp
int FcUcs4ToUtf8 (FcChar32 \fIsrc\fB, FcChar8 \fIdst[FC_UTF8_MAX_LEN]\fB);
\fR
.SH "DESCRIPTION"
.PP
Converts the Unicode char from \fIsrc\fR into
\fIdst\fR and returns the number of bytes needed to encode
the char.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcUtf8Len.3 0100664 0002720 0000144 00000001575 10534406355 014256 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcUtf8Len" "3" "02 December 2006" "" ""
.SH NAME
FcUtf8Len \- count UTF-8 encoded chars
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcUtf8Len (FcChar8 *\fIsrc\fB, int \fIlen\fB, int *\fInchar\fB, int *\fIwchar\fB);
\fR
.SH "DESCRIPTION"
.PP
Counts the number of Unicode chars in \fIlen\fR bytes of
\fIsrc\fR\&. Places that count in
\fInchar\fR\&. \fIwchar\fR contains 1, 2 or
4 depending on the number of bytes needed to hold the largest unicode char
counted. The return value indicates whether \fIsrc\fR is a
well-formed UTF8 string.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcUtf16ToUcs4.3 0100664 0002720 0000144 00000001525 10534406355 014733 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcUtf16ToUcs4" "3" "02 December 2006" "" ""
.SH NAME
FcUtf16ToUcs4 \- convert UTF-16 to UCS4
.SH SYNOPSIS
.sp
\fB#include
.sp
int FcUtf16ToUcs4 (FcChar8 *\fIsrc\fB, FcEndian \fIendian\fB, FcChar32 *\fIdst\fB, int \fIlen\fB);
\fR
.SH "DESCRIPTION"
.PP
Converts the next Unicode char from \fIsrc\fR into
\fIdst\fR and returns the number of bytes containing the
char. \fIsrc\fR must be at least \fIlen\fR
bytes long. Bytes of \fIsrc\fR are combined into 16-bit
units according to \fIendian\fR\&.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcUtf16Len.3 0100664 0002720 0000144 00000001752 10534406355 014332 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcUtf16Len" "3" "02 December 2006" "" ""
.SH NAME
FcUtf16Len \- count UTF-16 encoded chars
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcUtf16Len (FcChar8 *\fIsrc\fB, FcEndian \fIendian\fB, int \fIlen\fB, int *\fInchar\fB, int *\fIwchar\fB);
\fR
.SH "DESCRIPTION"
.PP
Counts the number of Unicode chars in \fIlen\fR bytes of
\fIsrc\fR\&. Bytes of \fIsrc\fR are
combined into 16-bit units according to \fIendian\fR\&.
Places that count in \fInchar\fR\&.
\fIwchar\fR contains 1, 2 or 4 depending on the number of
bytes needed to hold the largest unicode char counted. The return value
indicates whether \fIstring\fR is a well-formed UTF16
string.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcStrCopy.3 0100664 0002720 0000144 00000001265 10534406355 014370 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcStrCopy" "3" "02 December 2006" "" ""
.SH NAME
FcStrCopy \- duplicate a string
.SH SYNOPSIS
.sp
\fB#include
.sp
FcChar8 * FcStrCopy (const FcChar8 *\fIs\fB);
\fR
.SH "DESCRIPTION"
.PP
Allocates memory, copies \fIs\fR and returns the resulting
buffer. Yes, this is \fBstrdup\fR, but that function isn't
available on every platform.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcStrDowncase.3 0100664 0002720 0000144 00000001266 10534406355 015222 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcStrDowncase" "3" "02 December 2006" "" ""
.SH NAME
FcStrDowncase \- create a lower case translation of a string
.SH SYNOPSIS
.sp
\fB#include
.sp
FcChar8 * FcStrDowncase (const FcChar8 *\fIs\fB);
\fR
.SH "DESCRIPTION"
.PP
Allocates memory, copies \fIs\fR, converting upper case
letters to lower case and returns the allocated buffer.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcStrCopyFilename.3 0100664 0002720 0000144 00000001401 10534406355 016021 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcStrCopyFilename" "3" "02 December 2006" "" ""
.SH NAME
FcStrCopyFilename \- copy a string, expanding '~'
.SH SYNOPSIS
.sp
\fB#include
.sp
FcChar8 * FcStrCopyFilename (const FcChar8 *\fIs\fB);
\fR
.SH "DESCRIPTION"
.PP
Just like FcStrCopy except that it converts any leading '~' characters in
\fIs\fR to the value of the HOME environment variable.
Returns NULL if '~' is present in \fIs\fR and HOME is unset.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcStrCmpIgnoreCase.3 0100664 0002720 0000144 00000001513 10534406355 016131 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcStrCmpIgnoreCase" "3" "02 December 2006" "" ""
.SH NAME
FcStrCmpIgnoreCase \- compare UTF-8 strings ignoring ASCII case
.SH SYNOPSIS
.sp
\fB#include
.sp
int FcStrCmpIgnoreCase (const FcChar8 *\fIs1\fB, const FcChar8 *\fIs2\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the usual <0, 0, >0 result of comparing
\fIs1\fR and \fIs2\fR\&. This test is
case-insensitive in the ASCII range and will operate properly with UTF8
encoded strings, although it does not check for well formed strings.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcStrStr.3 0100664 0002720 0000144 00000001415 10534406355 014223 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcStrStr" "3" "02 December 2006" "" ""
.SH NAME
FcStrStr \- locate UTF-8 substring
.SH SYNOPSIS
.sp
\fB#include
.sp
FcChar8 * FcStrStr (const char *\fIs1\fB, const char *\fIs2\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the location of \fIs2\fR in
\fIs1\fR\&. Returns NULL if \fIs2\fR
is not present in \fIs1\fR\&. This test will operate properly
with UTF8 encoded strings, although it does not check for well formed
strings.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcStrStrIgnoreCase.3 0100664 0002720 0000144 00000001576 10534406355 016173 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcStrStrIgnoreCase" "3" "02 December 2006" "" ""
.SH NAME
FcStrStrIgnoreCase \- locate UTF-8 substring ignoring ASCII case
.SH SYNOPSIS
.sp
\fB#include
.sp
FcChar8 * FcStrStrIgnoreCase (const char *\fIs1\fB, const char *\fIs2\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the location of \fIs2\fR in
\fIs1\fR, ignoring ASCII case. Returns NULL if
\fIs2\fR is not present in \fIs1\fR\&.
This test is case-insensitive in the ASCII range and will operate properly
with UTF8 encoded strings, although it does not check for well formed
strings.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcStrDirname.3 0100664 0002720 0000144 00000001276 10534406355 015037 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcStrDirname" "3" "02 December 2006" "" ""
.SH NAME
FcStrDirname \- directory part of filename
.SH SYNOPSIS
.sp
\fB#include
.sp
FcChar8 * FcStrDirname (const FcChar8 *\fIfile\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the directory containing \fIfile\fR\&. This
is returned in newly allocated storage which should be freed when no longer
needed.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcStrBasename.3 0100664 0002720 0000144 00000001336 10534406355 015170 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcStrBasename" "3" "02 December 2006" "" ""
.SH NAME
FcStrBasename \- last component of filename
.SH SYNOPSIS
.sp
\fB#include
.sp
FcChar8 * FcStrBasename (const FcChar8 *\fIfile\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the filename of \fIfile\fR stripped of any leading
directory names. This is returned in newly allocated storage which should
be freed when no longer needed.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcStrSetCreate.3 0100664 0002720 0000144 00000001073 10534406354 015331 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcStrSetCreate" "3" "02 December 2006" "" ""
.SH NAME
FcStrSetCreate \- create a string set
.SH SYNOPSIS
.sp
\fB#include
.sp
FcStrSet * FcStrSetCreate (void\fI\fB);
\fR
.SH "DESCRIPTION"
.PP
Create an empty set.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcStrSetMember.3 0100664 0002720 0000144 00000001174 10534406354 015337 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcStrSetMember" "3" "02 December 2006" "" ""
.SH NAME
FcStrSetMember \- check set for membership
.SH SYNOPSIS
.sp
\fB#include
.sp
FcBool FcStrSetMember (FcStrSet *\fIset\fB, const FcChar8 *\fIs\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns whether \fIs\fR is a member of
\fIset\fR\&.
.SH "VERSION"
.PP
Fontconfig version 2.4.2
fontconfig-2.4.2/doc/FcStrSetAdd.3 0100664 0002720 0000144 00000001141 10534406354 014612 0 ustar users .\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" .
.TH "FcStrSetAdd" "3" "02 December 2006" "" ""
.SH NAME
FcStrSetAdd \- add to a string set
.SH SYNOPSIS
.sp
\fB#include