fcfontsetmatch.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>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="x102.html#AEN1056"><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="AEN1161"
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="AEN1164"
87></A
88><H2
89>Synopsis</H2
90><DIV
91CLASS="FUNCSYNOPSIS"
92><P
93></P
94><A
95NAME="AEN1165"
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="AEN1180"
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="REFSECT1"
199><A
200NAME="AEN1190"
201></A
202><H2
203>Version</H2
204><P
205>Fontconfig version 2.10.93
206
207	    </P
208></DIV
209><DIV
210CLASS="NAVFOOTER"
211><HR
212ALIGN="LEFT"
213WIDTH="100%"><TABLE
214SUMMARY="Footer navigation table"
215WIDTH="100%"
216BORDER="0"
217CELLPADDING="0"
218CELLSPACING="0"
219><TR
220><TD
221WIDTH="33%"
222ALIGN="left"
223VALIGN="top"
224><A
225HREF="fcfontsetlist.html"
226ACCESSKEY="P"
227>&#60;&#60;&#60; Previous</A
228></TD
229><TD
230WIDTH="34%"
231ALIGN="center"
232VALIGN="top"
233><A
234HREF="t1.html"
235ACCESSKEY="H"
236>Home</A
237></TD
238><TD
239WIDTH="33%"
240ALIGN="right"
241VALIGN="top"
242><A
243HREF="fcfontsetprint.html"
244ACCESSKEY="N"
245>Next &#62;&#62;&#62;</A
246></TD
247></TR
248><TR
249><TD
250WIDTH="33%"
251ALIGN="left"
252VALIGN="top"
253>FcFontSetList</TD
254><TD
255WIDTH="34%"
256ALIGN="center"
257VALIGN="top"
258><A
259HREF="x102.html#AEN1056"
260ACCESSKEY="U"
261>Up</A
262></TD
263><TD
264WIDTH="33%"
265ALIGN="right"
266VALIGN="top"
267>FcFontSetPrint</TD
268></TR
269></TABLE
270></DIV
271></BODY
272></HTML
273>