doc/fontconfig-devel/fcfontsetmatch.html

   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#AEN1066"><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="AEN1164"
  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="AEN1167"
  87 ></A
  88 ><H2
  89 >Synopsis</H2
  90 ><DIV
  91 CLASS="FUNCSYNOPSIS"
  92 ><P
  93 ></P
  94 ><A
  95 NAME="AEN1168"
  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="AEN1183"
 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#AEN1066"
 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 >