Home | History | Annotate | Line # | Download | only in fontconfig-devel 
      1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd">
      2 <HTML
      3 ><HEAD
      4 ><TITLE
      5 >FcFontSetMatch</TITLE
      6 ><META
      7 NAME="GENERATOR"
      8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
      9 REL="HOME"
     10 HREF="t1.html"><LINK
     11 REL="UP"
     12 TITLE="FcFontSet"
     13 HREF="x103.html#AEN1316"><LINK
     14 REL="PREVIOUS"
     15 TITLE="FcFontSetList"
     16 HREF="fcfontsetlist.html"><LINK
     17 REL="NEXT"
     18 TITLE="FcFontSetPrint"
     19 HREF="fcfontsetprint.html"></HEAD
     20 ><BODY
     21 CLASS="REFENTRY"
     22 BGCOLOR="#FFFFFF"
     23 TEXT="#000000"
     24 LINK="#0000FF"
     25 VLINK="#840084"
     26 ALINK="#0000FF"
     27 ><DIV
     28 CLASS="NAVHEADER"
     29 ><TABLE
     30 SUMMARY="Header navigation table"
     31 WIDTH="100%"
     32 BORDER="0"
     33 CELLPADDING="0"
     34 CELLSPACING="0"
     35 ><TR
     36 ><TH
     37 COLSPAN="3"
     38 ALIGN="center"
     39 ></TH
     40 ></TR
     41 ><TR
     42 ><TD
     43 WIDTH="10%"
     44 ALIGN="left"
     45 VALIGN="bottom"
     46 ><A
     47 HREF="fcfontsetlist.html"
     48 ACCESSKEY="P"
     49 >&#60;&#60;&#60; Previous</A
     50 ></TD
     51 ><TD
     52 WIDTH="80%"
     53 ALIGN="center"
     54 VALIGN="bottom"
     55 ></TD
     56 ><TD
     57 WIDTH="10%"
     58 ALIGN="right"
     59 VALIGN="bottom"
     60 ><A
     61 HREF="fcfontsetprint.html"
     62 ACCESSKEY="N"
     63 >Next &#62;&#62;&#62;</A
     64 ></TD
     65 ></TR
     66 ></TABLE
     67 ><HR
     68 ALIGN="LEFT"
     69 WIDTH="100%"></DIV
     70 ><H1
     71 ><A
     72 NAME="FCFONTSETMATCH"
     73 ></A
     74 >FcFontSetMatch</H1
     75 ><DIV
     76 CLASS="REFNAMEDIV"
     77 ><A
     78 NAME="AEN1414"
     79 ></A
     80 ><H2
     81 >Name</H2
     82 >FcFontSetMatch&nbsp;--&nbsp;Return the best font from a set of font sets</DIV
     83 ><DIV
     84 CLASS="REFSYNOPSISDIV"
     85 ><A
     86 NAME="AEN1417"
     87 ></A
     88 ><H2
     89 >Synopsis</H2
     90 ><DIV
     91 CLASS="FUNCSYNOPSIS"
     92 ><P
     93 ></P
     94 ><A
     95 NAME="AEN1418"
     96 ></A
     97 ><TABLE
     98 BORDER="0"
     99 BGCOLOR="#E0E0E0"
    100 WIDTH="100%"
    101 ><TR
    102 ><TD
    103 ><PRE
    104 CLASS="FUNCSYNOPSISINFO"
    105 >#include &#60;fontconfig/fontconfig.h&#62;
    106         </PRE
    107 ></TD
    108 ></TR
    109 ></TABLE
    110 ><P
    111 ><CODE
    112 ><CODE
    113 CLASS="FUNCDEF"
    114 >FcPattern * <TT
    115 CLASS="FUNCTION"
    116 >FcFontSetMatch</TT
    117 ></CODE
    118 >(FcConfig *<TT
    119 CLASS="PARAMETER"
    120 ><I
    121 >config</I
    122 ></TT
    123 >, FcFontSet **<TT
    124 CLASS="PARAMETER"
    125 ><I
    126 >sets</I
    127 ></TT
    128 >, int<TT
    129 CLASS="PARAMETER"
    130 ><I
    131 >nsets</I
    132 ></TT
    133 >, FcPattern *<TT
    134 CLASS="PARAMETER"
    135 ><I
    136 >pattern</I
    137 ></TT
    138 >, FcResult *<TT
    139 CLASS="PARAMETER"
    140 ><I
    141 >result</I
    142 ></TT
    143 >);</CODE
    144 ></P
    145 ><P
    146 ></P
    147 ></DIV
    148 ></DIV
    149 ><DIV
    150 CLASS="REFSECT1"
    151 ><A
    152 NAME="AEN1433"
    153 ></A
    154 ><H2
    155 >Description</H2
    156 ><P
    157 >Finds the font in <TT
    158 CLASS="PARAMETER"
    159 ><I
    160 >sets</I
    161 ></TT
    162 > most closely matching
    163 <TT
    164 CLASS="PARAMETER"
    165 ><I
    166 >pattern</I
    167 ></TT
    168 > and returns the result of
    169 <TT
    170 CLASS="FUNCTION"
    171 >FcFontRenderPrepare</TT
    172 > for that font and the provided
    173 pattern. This function should be called only after
    174 <TT
    175 CLASS="FUNCTION"
    176 >FcConfigSubstitute</TT
    177 > and
    178 <TT
    179 CLASS="FUNCTION"
    180 >FcDefaultSubstitute</TT
    181 > have been called for
    182 <TT
    183 CLASS="PARAMETER"
    184 ><I
    185 >pattern</I
    186 ></TT
    187 >; otherwise the results will not be correct.
    188 If <TT
    189 CLASS="PARAMETER"
    190 ><I
    191 >config</I
    192 ></TT
    193 > is NULL, the current configuration is used.
    194 Returns NULL if an error occurs during this process.
    195             </P
    196 ></DIV
    197 ><DIV
    198 CLASS="NAVFOOTER"
    199 ><HR
    200 ALIGN="LEFT"
    201 WIDTH="100%"><TABLE
    202 SUMMARY="Footer navigation table"
    203 WIDTH="100%"
    204 BORDER="0"
    205 CELLPADDING="0"
    206 CELLSPACING="0"
    207 ><TR
    208 ><TD
    209 WIDTH="33%"
    210 ALIGN="left"
    211 VALIGN="top"
    212 ><A
    213 HREF="fcfontsetlist.html"
    214 ACCESSKEY="P"
    215 >&#60;&#60;&#60; Previous</A
    216 ></TD
    217 ><TD
    218 WIDTH="34%"
    219 ALIGN="center"
    220 VALIGN="top"
    221 ><A
    222 HREF="t1.html"
    223 ACCESSKEY="H"
    224 >Home</A
    225 ></TD
    226 ><TD
    227 WIDTH="33%"
    228 ALIGN="right"
    229 VALIGN="top"
    230 ><A
    231 HREF="fcfontsetprint.html"
    232 ACCESSKEY="N"
    233 >Next &#62;&#62;&#62;</A
    234 ></TD
    235 ></TR
    236 ><TR
    237 ><TD
    238 WIDTH="33%"
    239 ALIGN="left"
    240 VALIGN="top"
    241 >FcFontSetList</TD
    242 ><TD
    243 WIDTH="34%"
    244 ALIGN="center"
    245 VALIGN="top"
    246 ><A
    247 HREF="x103.html#AEN1316"
    248 ACCESSKEY="U"
    249 >Up</A
    250 ></TD
    251 ><TD
    252 WIDTH="33%"
    253 ALIGN="right"
    254 VALIGN="top"
    255 >FcFontSetPrint</TD
    256 ></TR
    257 ></TABLE
    258 ></DIV
    259 ></BODY
    260 ></HTML
    261 >