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