x31.htmlPrev  4. FUNCTIONS 
These are grouped by functionality, often using the main datatype being
manipulated.
  
4.1. Initialization 
Table of Contents r99.htmlFcInitLoadConfig  -- load configuration r120.htmlFcInitLoadConfigAndFonts  -- load configuration and font data r141.htmlFcInit  -- initialize fontconfig library r162.htmlFcFini  -- finalize fonconfig library r183.htmlFcGetVersion  -- library version number r204.htmlFcInitReinitialize  -- re-initialize library r225.htmlFcInitBringUptoDate  -- reload configuration files if needed These functions provide some control over how the library is initialized.
    
4.2. FcPattern 
Table of Contents r249.htmlFcPatternCreate  -- Create a pattern r270.htmlFcPatternDestroy  -- Destroy a pattern r291.htmlFcPatternEqual  -- Compare patterns r316.htmlFcPatternEqualSubset  -- Compare portions of patterns r344.htmlFcPatternHash  -- Compute a pattern hash value r365.htmlFcPatternAdd  -- Add a value to a pattern r393.htmlFcPatternAddWeak  -- Add a value to a pattern with weak binding r422.htmlFcPatternAdd-Type  -- Add a typed value to a pattern r497.htmlFcPatternGet  -- Return a value from a pattern r527.htmlFcPatternGet-Type  -- Return a typed value from a pattern r614.htmlFcPatternBuild  -- Create patterns from arguments r655.htmlFcPatternDel  -- Delete a property from a pattern r678.htmlFcPatternRemove  -- Remove one object of the specified type from the pattern r703.htmlFcPatternPrint  -- Print a pattern for debugging r724.htmlFcDefaultSubstitute  -- Perform default substitutions in a pattern r752.htmlFcNameParse  -- Parse a pattern string r774.htmlFcNameUnparse  -- Convert a pattern back into a string that can be parsed An FcPattern is an opaque type that holds both patterns to match against the
available fonts, as well as the information about each font.
    
4.3. FcFontSet 
Table of Contents r798.htmlFcFontSetCreate  -- Create a font set r819.htmlFcFontSetDestroy  -- Destroy a font set r840.htmlFcFontSetAdd  -- Add to a font set An FcFontSet simply holds a list of patterns; these are used to return the
results of listing available fonts.
    
4.4. FcObjectSet 
Table of Contents r866.htmlFcObjectSetCreate  -- Create an object set r887.htmlFcObjectSetAdd  -- Add to an object set r910.htmlFcObjectSetDestroy  -- Destroy an object set r931.htmlFcObjectSetBuild  -- Build object set from args 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.
    
4.5. FreeType specific functions 
Table of Contents r965.htmlFcFreeTypeCharIndex  -- map Unicode to glyph id r988.htmlFcFreeTypeCharSet  -- compute unicode coverage r1011.htmlFcFreeTypeQuery  -- compute font file pattern While the fontconfig library doesn't insist that FreeType be used as the
rasterization mechanism for fonts, it does provide some convenience
functions.
    
4.6. FcValue 
Table of Contents r1042.htmlFcValueDestroy  -- Free a value r1064.htmlFcValueSave  -- Copy a value FcValue is a structure containing a type tag and a union of all possible
datatypes.  The tag is an enum of type 
FcTypeand is intended to provide a measure of run-time
typechecking, although that depends on careful programming.
    
4.7. FcCharSet 
Table of Contents r1090.htmlFcCharSetCreate  -- Create an empty character set r1112.htmlFcCharSetDestroy  -- Destroy a character set r1135.htmlFcCharSetAddChar  -- Add a character to a charset r1159.htmlFcCharSetCopy  -- Copy a charset r1182.htmlFcCharSetEqual  -- Compare two charsets r1207.htmlFcCharSetIntersect  -- Intersect charsets r1232.htmlFcCharSetUnion  -- Add charsets r1257.htmlFcCharSetSubtract  -- Subtract charsets r1282.htmlFcCharSetHasChar  -- Check a charset for a char r1307.htmlFcCharSetCount  -- Count entries in a charset r1329.htmlFcCharSetIntersectCount  -- Intersect and count charsets r1354.htmlFcCharSetSubtractCount  -- Subtract and count charsets r1379.htmlFcCharSetIsSubset  -- Test for charset inclusion r1404.htmlFcCharSetFirstPage  -- Start enumerating charset contents r1431.htmlFcCharSetNextPage  -- Continue enumerating charset contents 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.
    
4.8. FcMatrix 
Table of Contents r1462.htmlFcMatrixInit  -- initialize an FcMatrix structure r1485.htmlFcMatrixCopy  -- Copy a matrix r1508.htmlFcMatrixEqual  -- Compare two matrices r1534.htmlFcMatrixMultiply  -- Multiply matrices r1563.htmlFcMatrixRotate  -- Rotate a matrix r1593.htmlFcMatrixScale  -- Scale a matrix r1623.htmlFcMatrixShear  -- Shear a matrix FcMatrix structures hold an affine transformation in matrix form.
    
4.9. FcConfig 
Table of Contents r1656.htmlFcConfigCreate  -- Create a configuration r1677.htmlFcConfigDestroy  -- Destroy a configuration r1698.htmlFcConfigSetCurrent  -- Set configuration as default r1720.htmlFcConfigGetCurrent  -- Return current configuration r1741.htmlFcConfigUptoDate  -- Check timestamps on config files r1763.htmlFcConfigBuildFonts  -- Build font database r1784.htmlFcConfigGetConfigDirs  -- Get config directories r1806.htmlFcConfigGetFontDirs  -- Get font directories r1828.htmlFcConfigGetConfigFiles  -- Get config files r1850.htmlFcConfigGetCache  -- Get cache filename r1871.htmlFcConfigGetFonts  -- Get config font set r1895.htmlFcConfigGetBlanks  -- Get config blanks r1916.htmlFcConfigGetRescanInverval  -- Get config rescan interval r1938.htmlFcConfigSetRescanInverval  -- Set config rescan interval r1961.htmlFcConfigAppFontAddFile  -- Add font file to font database r1984.htmlFcConfigAppFontAddDir  -- Add fonts from directory to font database r2007.htmlFcConfigAppFontClear  -- Remove all app fonts from font database r2028.htmlFcConfigSubstituteWithPat  -- Execute substitutions r2057.htmlFcConfigSubstitute  -- Execute substitutions r2082.htmlFcFontMatch  -- Return best font r2110.htmlFcFontSort  -- Return list of matching fonts r2147.htmlFcFontRenderPrepare  -- Prepare pattern for loading font file r2178.htmlFcFontList  -- List fonts r2205.htmlFcConfigFilename  -- Find a config file r2229.htmlFcConfigParseAndLoad  -- load a configuration file An FcConfig object holds the internal representation of a configuration.
There is a default configuration which applications may use by passing 0 to
any function using the data within an FcConfig.
    
4.10. FcObjectType 
Table of Contents r2255.htmlFcNameRegisterObjectTypes  -- Register object types r2279.htmlFcNameUnregisterObjectTypes  -- Unregister object types r2303.htmlFcNameGetObjectType  -- Lookup an object type Provides for applcation-specified font name object types so that new
pattern elements can be generated from font names.
    
4.11. FcConstant 
Table of Contents r2328.htmlFcNameRegisterConstants  -- Register symbolic constants r2352.htmlFcNameUnregisterConstants  -- Unregister symbolic constants r2376.htmlFcNameGetConstant  -- Lookup symbolic constant r2398.htmlFcNameConstant  -- Get the value for a symbolic constant Provides for application-specified symbolic constants for font names.
    
4.12. FcBlanks 
Table of Contents r2426.htmlFcBlanksCreate  -- Create an FcBlanks r2447.htmlFcBlanksDestroy  -- Destroy and FcBlanks r2468.htmlFcBlanksAdd  -- Add a character to an FcBlanks r2491.htmlFcBlanksIsMember  -- Query membership in an FcBlanks An FcBlanks object holds a list of Unicode chars which are expected to
be blank when drawn.  When scanning new fonts, any glyphs which are
empty and not in this list will be assumed to be broken and not placed in
the FcCharSet associated with the font.  This provides a significantly more
accurate CharSet for applications.
    
4.13. FcAtomic 
Table of Contents r2517.htmlFcAtomicCreate  -- create an FcAtomic object r2539.htmlFcAtomicLock  -- lock a file r2561.htmlFcAtomicNewFile  -- return new temporary file name r2583.htmlFcAtomicOrigFile  -- return original file name r2605.htmlFcAtomicReplaceOrig  -- replace original with new r2627.htmlFcAtomicDeleteNew  -- delete new file r2648.htmlFcAtomicUnlock  -- unlock a file r2669.htmlFcAtomicDestroy  -- destroy an FcAtomic object 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.
    
4.14. File and Directory routines 
Table of Contents r2694.htmlFcFileScan  -- scan a font file r2730.htmlFcDirScan  -- scan a font directory r2765.htmlFcDirSave  -- save a directory cache r2793.htmlFcDirCacheValid  -- check directory cache timestamp These routines work with font files and directories, including font
directory cache files.
    
4.15. FcStrSet and FcStrList 
Table of Contents r2818.htmlFcStrSetCreate  -- create a string set r2839.htmlFcStrSetMember  -- check set for membership r2864.htmlFcStrSetAdd  -- add to a string set r2889.htmlFcStrSetAddFilename  -- add a filename to a string set r2914.htmlFcStrSetDel  -- delete from a string set r2940.htmlFcStrSetDestroy  -- destroy a string set r2962.htmlFcStrListCreate  -- create a string iterator r2984.htmlFcStrListNext  -- get next string in iteration r3006.htmlFcStrListDone  -- destroy a string iterator A data structure for enumerating strings, used to list directories while
scanning the configuration as directories are added while scanning.
    
4.16. String utilities 
Table of Contents r3031.htmlFcUtf8ToUcs4  -- convert UTF-8 to UCS4 r3060.htmlFcUcs4ToUtf8  -- convert UCS4 to UTF-8 r3085.htmlFcUtf8Len  -- count UTF-8 encoded chars r3117.htmlFcUtf16ToUcs4  -- convert UTF-16 to UCS4 r3150.htmlFcUtf16Len  -- count UTF-16 encoded chars r3186.htmlFcStrCopy  -- duplicate a string r3209.htmlFcStrDowncase  -- create a lower case translation of a string r3231.htmlFcStrCopyFilename  -- copy a string, expanding '~' r3254.htmlFcStrCmpIgnoreCase  -- compare UTF-8 strings ignoring ASCII case r3279.htmlFcStrStr  -- locate UTF-8 substring r3306.htmlFcStrStrIgnoreCase  -- locate UTF-8 substring ignoring ASCII case r3333.htmlFcStrDirname  -- directory part of filename r3355.htmlFcStrBasename  -- last component of filename Fontconfig manipulates many UTF-8 strings represented with the FcChar8 type.
These functions are exposed to help applications deal with these UTF-8
strings in a locale-insensitive manner.
    
x31.htmlPrev index.htmlHome  Datatypes   