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 >FcFontMatch</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="FcConfig"
     13 HREF="x103.html#AEN3038"><LINK
     14 REL="PREVIOUS"
     15 TITLE="FcConfigSubstitute"
     16 HREF="fcconfigsubstitute.html"><LINK
     17 REL="NEXT"
     18 TITLE="FcFontSort"
     19 HREF="fcfontsort.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="fcconfigsubstitute.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="fcfontsort.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="FCFONTMATCH"
     73 ></A
     74 >FcFontMatch</H1
     75 ><DIV
     76 CLASS="REFNAMEDIV"
     77 ><A
     78 NAME="AEN3539"
     79 ></A
     80 ><H2
     81 >Name</H2
     82 >FcFontMatch&nbsp;--&nbsp;Return best font</DIV
     83 ><DIV
     84 CLASS="REFSYNOPSISDIV"
     85 ><A
     86 NAME="AEN3542"
     87 ></A
     88 ><H2
     89 >Synopsis</H2
     90 ><DIV
     91 CLASS="FUNCSYNOPSIS"
     92 ><P
     93 ></P
     94 ><A
     95 NAME="AEN3543"
     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 >FcFontMatch</TT
    117 ></CODE
    118 >(FcConfig *<TT
    119 CLASS="PARAMETER"
    120 ><I
    121 >config</I
    122 ></TT
    123 >, FcPattern *<TT
    124 CLASS="PARAMETER"
    125 ><I
    126 >p</I
    127 ></TT
    128 >, FcResult *<TT
    129 CLASS="PARAMETER"
    130 ><I
    131 >result</I
    132 ></TT
    133 >);</CODE
    134 ></P
    135 ><P
    136 ></P
    137 ></DIV
    138 ></DIV
    139 ><DIV
    140 CLASS="REFSECT1"
    141 ><A
    142 NAME="AEN3554"
    143 ></A
    144 ><H2
    145 >Description</H2
    146 ><P
    147 >Finds the font in <TT
    148 CLASS="PARAMETER"
    149 ><I
    150 >sets</I
    151 ></TT
    152 > most closely matching
    153 <TT
    154 CLASS="PARAMETER"
    155 ><I
    156 >pattern</I
    157 ></TT
    158 > and returns the result of
    159 <TT
    160 CLASS="FUNCTION"
    161 >FcFontRenderPrepare</TT
    162 > for that font and the provided
    163 pattern. This function should be called only after
    164 <TT
    165 CLASS="FUNCTION"
    166 >FcConfigSubstitute</TT
    167 > and
    168 <TT
    169 CLASS="FUNCTION"
    170 >FcDefaultSubstitute</TT
    171 > have been called for
    172 <TT
    173 CLASS="PARAMETER"
    174 ><I
    175 >p</I
    176 ></TT
    177 >; otherwise the results will not be correct.
    178 If <TT
    179 CLASS="PARAMETER"
    180 ><I
    181 >config</I
    182 ></TT
    183 > is NULL, the current configuration is used.
    184             </P
    185 ></DIV
    186 ><DIV
    187 CLASS="NAVFOOTER"
    188 ><HR
    189 ALIGN="LEFT"
    190 WIDTH="100%"><TABLE
    191 SUMMARY="Footer navigation table"
    192 WIDTH="100%"
    193 BORDER="0"
    194 CELLPADDING="0"
    195 CELLSPACING="0"
    196 ><TR
    197 ><TD
    198 WIDTH="33%"
    199 ALIGN="left"
    200 VALIGN="top"
    201 ><A
    202 HREF="fcconfigsubstitute.html"
    203 ACCESSKEY="P"
    204 >&#60;&#60;&#60; Previous</A
    205 ></TD
    206 ><TD
    207 WIDTH="34%"
    208 ALIGN="center"
    209 VALIGN="top"
    210 ><A
    211 HREF="t1.html"
    212 ACCESSKEY="H"
    213 >Home</A
    214 ></TD
    215 ><TD
    216 WIDTH="33%"
    217 ALIGN="right"
    218 VALIGN="top"
    219 ><A
    220 HREF="fcfontsort.html"
    221 ACCESSKEY="N"
    222 >Next &#62;&#62;&#62;</A
    223 ></TD
    224 ></TR
    225 ><TR
    226 ><TD
    227 WIDTH="33%"
    228 ALIGN="left"
    229 VALIGN="top"
    230 >FcConfigSubstitute</TD
    231 ><TD
    232 WIDTH="34%"
    233 ALIGN="center"
    234 VALIGN="top"
    235 ><A
    236 HREF="x103.html#AEN3038"
    237 ACCESSKEY="U"
    238 >Up</A
    239 ></TD
    240 ><TD
    241 WIDTH="33%"
    242 ALIGN="right"
    243 VALIGN="top"
    244 >FcFontSort</TD
    245 ></TR
    246 ></TABLE
    247 ></DIV
    248 ></BODY
    249 ></HTML
    250 >