xenocara/lib/fontconfig/doc/fontconfig-devel/r2873.html
matthieu 6cd6a1d6f1 Update to fontconfig 2.6.0. ok naddy@
this uses a patched version of libtool to fix linking on vax.
2009-04-05 16:43:35 +00:00

234 lines
3.5 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>FcFontSort</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
HREF="index.html"><LINK
REL="UP"
TITLE="FcConfig"
HREF="x102.html#AEN2346"><LINK
REL="PREVIOUS"
TITLE="FcFontMatch"
HREF="r2842.html"><LINK
REL="NEXT"
TITLE="FcFontRenderPrepare"
HREF="r2911.html"></HEAD
><BODY
CLASS="REFENTRY"
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="r2842.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="r2911.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="FCFONTSORT"
></A
>FcFontSort</H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN2877"
></A
><H2
>Name</H2
>FcFontSort&nbsp;--&nbsp;Return list of matching fonts</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN2880"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><P
></P
><A
NAME="AEN2881"
></A
><PRE
CLASS="FUNCSYNOPSISINFO"
>#include &lt;fontconfig.h&gt;
</PRE
><P
><CODE
><CODE
CLASS="FUNCDEF"
>FcFontSet * FcFontSort</CODE
>(FcConfig *config, FcPattern *p, FcBool trim, FcCharSet **csp, FcResult *result);</CODE
></P
><P
></P
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN2896"
></A
><H2
>Description</H2
><P
>Returns the list of fonts sorted by closeness to <CODE
CLASS="PARAMETER"
>p</CODE
>. If <CODE
CLASS="PARAMETER"
>trim</CODE
> 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 <CODE
CLASS="PARAMETER"
>csp</CODE
>, if <CODE
CLASS="PARAMETER"
>csp</CODE
> is not NULL. This function
should be called only after FcConfigSubstitute and FcDefaultSubstitute have
been called for <CODE
CLASS="PARAMETER"
>p</CODE
>; otherwise the results will not be correct.
</P
><P
>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 <CODE
CLASS="PARAMETER"
>p</CODE
> to
<CODE
CLASS="FUNCTION"
>FcFontRenderPrepare</CODE
> which combines them into a complete pattern.
</P
><P
>The FcFontSet returned by FcFontSort is destroyed by caling FcFontSetDestroy.
</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN2908"
></A
><H2
>Version</H2
><P
>Fontconfig version 2.6.0
</P
></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="r2842.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"
><A
HREF="r2911.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>FcFontMatch</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="x102.html#AEN2346"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>FcFontRenderPrepare</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>