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