xenocara/lib/fontconfig/doc/fontconfig-devel/x93.html

1143 lines
19 KiB
HTML
Raw Normal View History

2006-11-25 11:41:30 -07:00
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>FUNCTIONS</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
HREF="index.html"><LINK
REL="PREVIOUS"
TITLE="Datatypes"
HREF="x31.html"></HEAD
><BODY
CLASS="SECT1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
></TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="x31.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
>&nbsp;</TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="AEN93"
>4. FUNCTIONS</A
></H1
><P
>These are grouped by functionality, often using the main datatype being
manipulated.
</P
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN96"
>4.1. Initialization</A
></H2
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
HREF="r99.html"
>FcInitLoadConfig</A
>&nbsp;--&nbsp;load configuration</DT
><DT
><A
HREF="r120.html"
>FcInitLoadConfigAndFonts</A
>&nbsp;--&nbsp;load configuration and font data</DT
><DT
><A
HREF="r141.html"
>FcInit</A
>&nbsp;--&nbsp;initialize fontconfig library</DT
><DT
><A
HREF="r162.html"
>FcFini</A
>&nbsp;--&nbsp;finalize fonconfig library</DT
><DT
><A
HREF="r183.html"
>FcGetVersion</A
>&nbsp;--&nbsp;library version number</DT
><DT
><A
HREF="r204.html"
>FcInitReinitialize</A
>&nbsp;--&nbsp;re-initialize library</DT
><DT
><A
HREF="r225.html"
>FcInitBringUptoDate</A
>&nbsp;--&nbsp;reload configuration files if needed</DT
></DL
></DIV
><P
>These functions provide some control over how the library is initialized.
</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN246"
>4.2. FcPattern</A
></H2
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
HREF="r249.html"
>FcPatternCreate</A
>&nbsp;--&nbsp;Create a pattern</DT
><DT
><A
HREF="r270.html"
>FcPatternDestroy</A
>&nbsp;--&nbsp;Destroy a pattern</DT
><DT
><A
HREF="r291.html"
>FcPatternEqual</A
>&nbsp;--&nbsp;Compare patterns</DT
><DT
><A
HREF="r316.html"
>FcPatternEqualSubset</A
>&nbsp;--&nbsp;Compare portions of patterns</DT
><DT
><A
HREF="r344.html"
>FcPatternHash</A
>&nbsp;--&nbsp;Compute a pattern hash value</DT
><DT
><A
HREF="r365.html"
>FcPatternAdd</A
>&nbsp;--&nbsp;Add a value to a pattern</DT
><DT
><A
HREF="r393.html"
>FcPatternAddWeak</A
>&nbsp;--&nbsp;Add a value to a pattern with weak binding</DT
><DT
><A
HREF="r422.html"
>FcPatternAdd-Type</A
>&nbsp;--&nbsp;Add a typed value to a pattern</DT
><DT
><A
HREF="r497.html"
>FcPatternGet</A
>&nbsp;--&nbsp;Return a value from a pattern</DT
><DT
><A
HREF="r527.html"
>FcPatternGet-Type</A
>&nbsp;--&nbsp;Return a typed value from a pattern</DT
><DT
><A
HREF="r614.html"
>FcPatternBuild</A
>&nbsp;--&nbsp;Create patterns from arguments</DT
><DT
><A
HREF="r655.html"
>FcPatternDel</A
>&nbsp;--&nbsp;Delete a property from a pattern</DT
><DT
><A
HREF="r678.html"
>FcPatternRemove</A
>&nbsp;--&nbsp;Remove one object of the specified type from the pattern</DT
><DT
><A
HREF="r703.html"
>FcPatternPrint</A
>&nbsp;--&nbsp;Print a pattern for debugging</DT
><DT
><A
HREF="r724.html"
>FcDefaultSubstitute</A
>&nbsp;--&nbsp;Perform default substitutions in a pattern</DT
><DT
><A
HREF="r752.html"
>FcNameParse</A
>&nbsp;--&nbsp;Parse a pattern string</DT
><DT
><A
HREF="r774.html"
>FcNameUnparse</A
>&nbsp;--&nbsp;Convert a pattern back into a string that can be parsed</DT
></DL
></DIV
><P
>An FcPattern is an opaque type that holds both patterns to match against the
available fonts, as well as the information about each font.
</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN795"
>4.3. FcFontSet</A
></H2
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
HREF="r798.html"
>FcFontSetCreate</A
>&nbsp;--&nbsp;Create a font set</DT
><DT
><A
HREF="r819.html"
>FcFontSetDestroy</A
>&nbsp;--&nbsp;Destroy a font set</DT
><DT
><A
HREF="r840.html"
>FcFontSetAdd</A
>&nbsp;--&nbsp;Add to a font set</DT
></DL
></DIV
><P
>An FcFontSet simply holds a list of patterns; these are used to return the
results of listing available fonts.
</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN863"
>4.4. FcObjectSet</A
></H2
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
HREF="r866.html"
>FcObjectSetCreate</A
>&nbsp;--&nbsp;Create an object set</DT
><DT
><A
HREF="r887.html"
>FcObjectSetAdd</A
>&nbsp;--&nbsp;Add to an object set</DT
><DT
><A
HREF="r910.html"
>FcObjectSetDestroy</A
>&nbsp;--&nbsp;Destroy an object set</DT
><DT
><A
HREF="r931.html"
>FcObjectSetBuild</A
>&nbsp;--&nbsp;Build object set from args</DT
></DL
></DIV
><P
>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.
</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN962"
>4.5. FreeType specific functions</A
></H2
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
HREF="r965.html"
>FcFreeTypeCharIndex</A
>&nbsp;--&nbsp;map Unicode to glyph id</DT
><DT
><A
HREF="r988.html"
>FcFreeTypeCharSet</A
>&nbsp;--&nbsp;compute unicode coverage</DT
><DT
><A
HREF="r1011.html"
>FcFreeTypeQuery</A
2006-12-31 07:57:18 -07:00
>&nbsp;--&nbsp;compute pattern from font file (and index)</DT
><DT
><A
HREF="r1038.html"
>FcFreeTypeQueryFace</A
>&nbsp;--&nbsp;compute pattern from FT_Face</DT
2006-11-25 11:41:30 -07:00
></DL
></DIV
><P
>While the fontconfig library doesn't insist that FreeType be used as the
rasterization mechanism for fonts, it does provide some convenience
functions.
</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
2006-12-31 07:57:18 -07:00
NAME="AEN1065"
2006-11-25 11:41:30 -07:00
>4.6. FcValue</A
></H2
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1069.html"
2006-11-25 11:41:30 -07:00
>FcValueDestroy</A
>&nbsp;--&nbsp;Free a value</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1091.html"
2006-11-25 11:41:30 -07:00
>FcValueSave</A
>&nbsp;--&nbsp;Copy a value</DT
></DL
></DIV
><P
>FcValue is a structure containing a type tag and a union of all possible
datatypes. The tag is an enum of type
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>FcType</I
></SPAN
>
and is intended to provide a measure of run-time
typechecking, although that depends on careful programming.
</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
2006-12-31 07:57:18 -07:00
NAME="AEN1114"
2006-11-25 11:41:30 -07:00
>4.7. FcCharSet</A
></H2
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1117.html"
2006-11-25 11:41:30 -07:00
>FcCharSetCreate</A
>&nbsp;--&nbsp;Create an empty character set</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1139.html"
2006-11-25 11:41:30 -07:00
>FcCharSetDestroy</A
>&nbsp;--&nbsp;Destroy a character set</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1162.html"
2006-11-25 11:41:30 -07:00
>FcCharSetAddChar</A
>&nbsp;--&nbsp;Add a character to a charset</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1186.html"
2006-11-25 11:41:30 -07:00
>FcCharSetCopy</A
>&nbsp;--&nbsp;Copy a charset</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1209.html"
2006-11-25 11:41:30 -07:00
>FcCharSetEqual</A
>&nbsp;--&nbsp;Compare two charsets</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1234.html"
2006-11-25 11:41:30 -07:00
>FcCharSetIntersect</A
>&nbsp;--&nbsp;Intersect charsets</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1259.html"
2006-11-25 11:41:30 -07:00
>FcCharSetUnion</A
>&nbsp;--&nbsp;Add charsets</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1284.html"
2006-11-25 11:41:30 -07:00
>FcCharSetSubtract</A
>&nbsp;--&nbsp;Subtract charsets</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1309.html"
2006-11-25 11:41:30 -07:00
>FcCharSetHasChar</A
>&nbsp;--&nbsp;Check a charset for a char</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1334.html"
2006-11-25 11:41:30 -07:00
>FcCharSetCount</A
>&nbsp;--&nbsp;Count entries in a charset</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1356.html"
2006-11-25 11:41:30 -07:00
>FcCharSetIntersectCount</A
>&nbsp;--&nbsp;Intersect and count charsets</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1381.html"
2006-11-25 11:41:30 -07:00
>FcCharSetSubtractCount</A
>&nbsp;--&nbsp;Subtract and count charsets</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1406.html"
2006-11-25 11:41:30 -07:00
>FcCharSetIsSubset</A
>&nbsp;--&nbsp;Test for charset inclusion</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1431.html"
2006-11-25 11:41:30 -07:00
>FcCharSetFirstPage</A
>&nbsp;--&nbsp;Start enumerating charset contents</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1458.html"
2006-11-25 11:41:30 -07:00
>FcCharSetNextPage</A
>&nbsp;--&nbsp;Continue enumerating charset contents</DT
></DL
></DIV
><P
>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.
</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
2006-12-31 07:57:18 -07:00
NAME="AEN1486"
2006-11-25 11:41:30 -07:00
>4.8. FcMatrix</A
></H2
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1489.html"
2006-11-25 11:41:30 -07:00
>FcMatrixInit</A
>&nbsp;--&nbsp;initialize an FcMatrix structure</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1512.html"
2006-11-25 11:41:30 -07:00
>FcMatrixCopy</A
>&nbsp;--&nbsp;Copy a matrix</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1535.html"
2006-11-25 11:41:30 -07:00
>FcMatrixEqual</A
>&nbsp;--&nbsp;Compare two matrices</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1561.html"
2006-11-25 11:41:30 -07:00
>FcMatrixMultiply</A
>&nbsp;--&nbsp;Multiply matrices</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1590.html"
2006-11-25 11:41:30 -07:00
>FcMatrixRotate</A
>&nbsp;--&nbsp;Rotate a matrix</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1620.html"
2006-11-25 11:41:30 -07:00
>FcMatrixScale</A
>&nbsp;--&nbsp;Scale a matrix</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1650.html"
2006-11-25 11:41:30 -07:00
>FcMatrixShear</A
>&nbsp;--&nbsp;Shear a matrix</DT
></DL
></DIV
><P
>FcMatrix structures hold an affine transformation in matrix form.
</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
2006-12-31 07:57:18 -07:00
NAME="AEN1680"
2006-11-25 11:41:30 -07:00
>4.9. FcConfig</A
></H2
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1683.html"
2006-11-25 11:41:30 -07:00
>FcConfigCreate</A
>&nbsp;--&nbsp;Create a configuration</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1704.html"
2006-11-25 11:41:30 -07:00
>FcConfigDestroy</A
>&nbsp;--&nbsp;Destroy a configuration</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1725.html"
2006-11-25 11:41:30 -07:00
>FcConfigSetCurrent</A
>&nbsp;--&nbsp;Set configuration as default</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1747.html"
2006-11-25 11:41:30 -07:00
>FcConfigGetCurrent</A
>&nbsp;--&nbsp;Return current configuration</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1768.html"
2006-11-25 11:41:30 -07:00
>FcConfigUptoDate</A
>&nbsp;--&nbsp;Check timestamps on config files</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1790.html"
2006-11-25 11:41:30 -07:00
>FcConfigBuildFonts</A
>&nbsp;--&nbsp;Build font database</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1811.html"
2006-11-25 11:41:30 -07:00
>FcConfigGetConfigDirs</A
>&nbsp;--&nbsp;Get config directories</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1833.html"
2006-11-25 11:41:30 -07:00
>FcConfigGetFontDirs</A
>&nbsp;--&nbsp;Get font directories</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1855.html"
2006-11-25 11:41:30 -07:00
>FcConfigGetConfigFiles</A
>&nbsp;--&nbsp;Get config files</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1877.html"
2006-11-25 11:41:30 -07:00
>FcConfigGetCache</A
>&nbsp;--&nbsp;Get cache filename</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1898.html"
2006-11-25 11:41:30 -07:00
>FcConfigGetFonts</A
>&nbsp;--&nbsp;Get config font set</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1922.html"
2006-11-25 11:41:30 -07:00
>FcConfigGetBlanks</A
>&nbsp;--&nbsp;Get config blanks</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1943.html"
2006-11-25 11:41:30 -07:00
>FcConfigGetRescanInverval</A
>&nbsp;--&nbsp;Get config rescan interval</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1965.html"
2006-11-25 11:41:30 -07:00
>FcConfigSetRescanInverval</A
>&nbsp;--&nbsp;Set config rescan interval</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r1988.html"
2006-11-25 11:41:30 -07:00
>FcConfigAppFontAddFile</A
>&nbsp;--&nbsp;Add font file to font database</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2011.html"
2006-11-25 11:41:30 -07:00
>FcConfigAppFontAddDir</A
>&nbsp;--&nbsp;Add fonts from directory to font database</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2034.html"
2006-11-25 11:41:30 -07:00
>FcConfigAppFontClear</A
>&nbsp;--&nbsp;Remove all app fonts from font database</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2055.html"
2006-11-25 11:41:30 -07:00
>FcConfigSubstituteWithPat</A
>&nbsp;--&nbsp;Execute substitutions</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2084.html"
2006-11-25 11:41:30 -07:00
>FcConfigSubstitute</A
>&nbsp;--&nbsp;Execute substitutions</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2109.html"
2006-11-25 11:41:30 -07:00
>FcFontMatch</A
>&nbsp;--&nbsp;Return best font</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2137.html"
2006-11-25 11:41:30 -07:00
>FcFontSort</A
>&nbsp;--&nbsp;Return list of matching fonts</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2174.html"
2006-11-25 11:41:30 -07:00
>FcFontRenderPrepare</A
>&nbsp;--&nbsp;Prepare pattern for loading font file</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2205.html"
2006-11-25 11:41:30 -07:00
>FcFontList</A
>&nbsp;--&nbsp;List fonts</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2232.html"
2006-11-25 11:41:30 -07:00
>FcConfigFilename</A
>&nbsp;--&nbsp;Find a config file</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2256.html"
2006-11-25 11:41:30 -07:00
>FcConfigParseAndLoad</A
>&nbsp;--&nbsp;load a configuration file</DT
></DL
></DIV
><P
>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.
</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
2006-12-31 07:57:18 -07:00
NAME="AEN2279"
2006-11-25 11:41:30 -07:00
>4.10. FcObjectType</A
></H2
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2282.html"
2006-11-25 11:41:30 -07:00
>FcNameRegisterObjectTypes</A
>&nbsp;--&nbsp;Register object types</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2306.html"
2006-11-25 11:41:30 -07:00
>FcNameUnregisterObjectTypes</A
>&nbsp;--&nbsp;Unregister object types</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2330.html"
2006-11-25 11:41:30 -07:00
>FcNameGetObjectType</A
>&nbsp;--&nbsp;Lookup an object type</DT
></DL
></DIV
><P
>Provides for applcation-specified font name object types so that new
pattern elements can be generated from font names.
</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
2006-12-31 07:57:18 -07:00
NAME="AEN2352"
2006-11-25 11:41:30 -07:00
>4.11. FcConstant</A
></H2
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2355.html"
2006-11-25 11:41:30 -07:00
>FcNameRegisterConstants</A
>&nbsp;--&nbsp;Register symbolic constants</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2379.html"
2006-11-25 11:41:30 -07:00
>FcNameUnregisterConstants</A
>&nbsp;--&nbsp;Unregister symbolic constants</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2403.html"
2006-11-25 11:41:30 -07:00
>FcNameGetConstant</A
>&nbsp;--&nbsp;Lookup symbolic constant</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2425.html"
2006-11-25 11:41:30 -07:00
>FcNameConstant</A
>&nbsp;--&nbsp;Get the value for a symbolic constant</DT
></DL
></DIV
><P
>Provides for application-specified symbolic constants for font names.
</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
2006-12-31 07:57:18 -07:00
NAME="AEN2450"
2006-11-25 11:41:30 -07:00
>4.12. FcBlanks</A
></H2
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2453.html"
2006-11-25 11:41:30 -07:00
>FcBlanksCreate</A
>&nbsp;--&nbsp;Create an FcBlanks</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2474.html"
2006-11-25 11:41:30 -07:00
>FcBlanksDestroy</A
>&nbsp;--&nbsp;Destroy and FcBlanks</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2495.html"
2006-11-25 11:41:30 -07:00
>FcBlanksAdd</A
>&nbsp;--&nbsp;Add a character to an FcBlanks</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2518.html"
2006-11-25 11:41:30 -07:00
>FcBlanksIsMember</A
>&nbsp;--&nbsp;Query membership in an FcBlanks</DT
></DL
></DIV
><P
>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.
</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
2006-12-31 07:57:18 -07:00
NAME="AEN2541"
2006-11-25 11:41:30 -07:00
>4.13. FcAtomic</A
></H2
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2544.html"
2006-11-25 11:41:30 -07:00
>FcAtomicCreate</A
>&nbsp;--&nbsp;create an FcAtomic object</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2566.html"
2006-11-25 11:41:30 -07:00
>FcAtomicLock</A
>&nbsp;--&nbsp;lock a file</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2588.html"
2006-11-25 11:41:30 -07:00
>FcAtomicNewFile</A
>&nbsp;--&nbsp;return new temporary file name</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2610.html"
2006-11-25 11:41:30 -07:00
>FcAtomicOrigFile</A
>&nbsp;--&nbsp;return original file name</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2632.html"
2006-11-25 11:41:30 -07:00
>FcAtomicReplaceOrig</A
>&nbsp;--&nbsp;replace original with new</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2654.html"
2006-11-25 11:41:30 -07:00
>FcAtomicDeleteNew</A
>&nbsp;--&nbsp;delete new file</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2675.html"
2006-11-25 11:41:30 -07:00
>FcAtomicUnlock</A
>&nbsp;--&nbsp;unlock a file</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2696.html"
2006-11-25 11:41:30 -07:00
>FcAtomicDestroy</A
>&nbsp;--&nbsp;destroy an FcAtomic object</DT
></DL
></DIV
><P
>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.
</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
2006-12-31 07:57:18 -07:00
NAME="AEN2718"
2006-11-25 11:41:30 -07:00
>4.14. File and Directory routines</A
></H2
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2721.html"
2006-11-25 11:41:30 -07:00
>FcFileScan</A
>&nbsp;--&nbsp;scan a font file</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2757.html"
2006-11-25 11:41:30 -07:00
>FcDirScan</A
>&nbsp;--&nbsp;scan a font directory</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2792.html"
2006-11-25 11:41:30 -07:00
>FcDirSave</A
>&nbsp;--&nbsp;save a directory cache</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2820.html"
2006-11-25 11:41:30 -07:00
>FcDirCacheValid</A
>&nbsp;--&nbsp;check directory cache timestamp</DT
></DL
></DIV
><P
>These routines work with font files and directories, including font
directory cache files.
</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
2006-12-31 07:57:18 -07:00
NAME="AEN2842"
2006-11-25 11:41:30 -07:00
>4.15. FcStrSet and FcStrList</A
></H2
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2845.html"
2006-11-25 11:41:30 -07:00
>FcStrSetCreate</A
>&nbsp;--&nbsp;create a string set</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2866.html"
2006-11-25 11:41:30 -07:00
>FcStrSetMember</A
>&nbsp;--&nbsp;check set for membership</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2891.html"
2006-11-25 11:41:30 -07:00
>FcStrSetAdd</A
>&nbsp;--&nbsp;add to a string set</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2916.html"
2006-11-25 11:41:30 -07:00
>FcStrSetAddFilename</A
>&nbsp;--&nbsp;add a filename to a string set</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2941.html"
2006-11-25 11:41:30 -07:00
>FcStrSetDel</A
>&nbsp;--&nbsp;delete from a string set</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2967.html"
2006-11-25 11:41:30 -07:00
>FcStrSetDestroy</A
>&nbsp;--&nbsp;destroy a string set</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r2989.html"
2006-11-25 11:41:30 -07:00
>FcStrListCreate</A
>&nbsp;--&nbsp;create a string iterator</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r3011.html"
2006-11-25 11:41:30 -07:00
>FcStrListNext</A
>&nbsp;--&nbsp;get next string in iteration</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r3033.html"
2006-11-25 11:41:30 -07:00
>FcStrListDone</A
>&nbsp;--&nbsp;destroy a string iterator</DT
></DL
></DIV
><P
>A data structure for enumerating strings, used to list directories while
scanning the configuration as directories are added while scanning.
</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
2006-12-31 07:57:18 -07:00
NAME="AEN3055"
2006-11-25 11:41:30 -07:00
>4.16. String utilities</A
></H2
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r3058.html"
2006-11-25 11:41:30 -07:00
>FcUtf8ToUcs4</A
>&nbsp;--&nbsp;convert UTF-8 to UCS4</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r3087.html"
2006-11-25 11:41:30 -07:00
>FcUcs4ToUtf8</A
>&nbsp;--&nbsp;convert UCS4 to UTF-8</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r3112.html"
2006-11-25 11:41:30 -07:00
>FcUtf8Len</A
>&nbsp;--&nbsp;count UTF-8 encoded chars</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r3144.html"
2006-11-25 11:41:30 -07:00
>FcUtf16ToUcs4</A
>&nbsp;--&nbsp;convert UTF-16 to UCS4</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r3177.html"
2006-11-25 11:41:30 -07:00
>FcUtf16Len</A
>&nbsp;--&nbsp;count UTF-16 encoded chars</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r3213.html"
2006-11-25 11:41:30 -07:00
>FcStrCopy</A
>&nbsp;--&nbsp;duplicate a string</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r3236.html"
2006-11-25 11:41:30 -07:00
>FcStrDowncase</A
>&nbsp;--&nbsp;create a lower case translation of a string</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r3258.html"
2006-11-25 11:41:30 -07:00
>FcStrCopyFilename</A
>&nbsp;--&nbsp;copy a string, expanding '~'</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r3281.html"
2006-11-25 11:41:30 -07:00
>FcStrCmpIgnoreCase</A
>&nbsp;--&nbsp;compare UTF-8 strings ignoring ASCII case</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r3306.html"
2006-11-25 11:41:30 -07:00
>FcStrStr</A
>&nbsp;--&nbsp;locate UTF-8 substring</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r3333.html"
2006-11-25 11:41:30 -07:00
>FcStrStrIgnoreCase</A
>&nbsp;--&nbsp;locate UTF-8 substring ignoring ASCII case</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r3360.html"
2006-11-25 11:41:30 -07:00
>FcStrDirname</A
>&nbsp;--&nbsp;directory part of filename</DT
><DT
><A
2006-12-31 07:57:18 -07:00
HREF="r3382.html"
2006-11-25 11:41:30 -07:00
>FcStrBasename</A
>&nbsp;--&nbsp;last component of filename</DT
></DL
></DIV
><P
>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.
</P
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="x31.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Datatypes</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
>&nbsp;</TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>&nbsp;</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>