fcfontmatch.html revision a32e9e42 
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="x103.html#AEN3038"><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="AEN3531"
79></A
80><H2
81>Name</H2
82>FcFontMatch&nbsp;--&nbsp;Return best font</DIV
83><DIV
84CLASS="REFSYNOPSISDIV"
85><A
86NAME="AEN3534"
87></A
88><H2
89>Synopsis</H2
90><DIV
91CLASS="FUNCSYNOPSIS"
92><P
93></P
94><A
95NAME="AEN3535"
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="AEN3546"
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="NAVFOOTER"
188><HR
189ALIGN="LEFT"
190WIDTH="100%"><TABLE
191SUMMARY="Footer navigation table"
192WIDTH="100%"
193BORDER="0"
194CELLPADDING="0"
195CELLSPACING="0"
196><TR
197><TD
198WIDTH="33%"
199ALIGN="left"
200VALIGN="top"
201><A
202HREF="fcconfigsubstitute.html"
203ACCESSKEY="P"
204>&#60;&#60;&#60; Previous</A
205></TD
206><TD
207WIDTH="34%"
208ALIGN="center"
209VALIGN="top"
210><A
211HREF="t1.html"
212ACCESSKEY="H"
213>Home</A
214></TD
215><TD
216WIDTH="33%"
217ALIGN="right"
218VALIGN="top"
219><A
220HREF="fcfontsort.html"
221ACCESSKEY="N"
222>Next &#62;&#62;&#62;</A
223></TD
224></TR
225><TR
226><TD
227WIDTH="33%"
228ALIGN="left"
229VALIGN="top"
230>FcConfigSubstitute</TD
231><TD
232WIDTH="34%"
233ALIGN="center"
234VALIGN="top"
235><A
236HREF="x103.html#AEN3038"
237ACCESSKEY="U"
238>Up</A
239></TD
240><TD
241WIDTH="33%"
242ALIGN="right"
243VALIGN="top"
244>FcFontSort</TD
245></TR
246></TABLE
247></DIV
248></BODY
249></HTML
250>