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>FcFontSetSort</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="FcFontSetPrint"
16HREF="fcfontsetprint.html"><LINK
17REL="NEXT"
18TITLE="FcFontSetSortDestroy"
19HREF="fcfontsetsortdestroy.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="fcfontsetprint.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="fcfontsetsortdestroy.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="FCFONTSETSORT"
73></A
74>FcFontSetSort</H1
75><DIV
76CLASS="REFNAMEDIV"
77><A
78NAME="AEN1468"
79></A
80><H2
81>Name</H2
82>FcFontSetSort&nbsp;--&nbsp;Add to a font set</DIV
83><DIV
84CLASS="REFSYNOPSISDIV"
85><A
86NAME="AEN1471"
87></A
88><H2
89>Synopsis</H2
90><DIV
91CLASS="FUNCSYNOPSIS"
92><P
93></P
94><A
95NAME="AEN1472"
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>FcFontSet * <TT
115CLASS="FUNCTION"
116>FcFontSetSort</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>, FcBool <TT
139CLASS="PARAMETER"
140><I
141>trim</I
142></TT
143>, FcCharSet **<TT
144CLASS="PARAMETER"
145><I
146>csp</I
147></TT
148>, FcResult *<TT
149CLASS="PARAMETER"
150><I
151>result</I
152></TT
153>);</CODE
154></P
155><P
156></P
157></DIV
158></DIV
159><DIV
160CLASS="REFSECT1"
161><A
162NAME="AEN1491"
163></A
164><H2
165>Description</H2
166><P
167>Returns the list of fonts from <TT
168CLASS="PARAMETER"
169><I
170>sets</I
171></TT
172>
173sorted by closeness to <TT
174CLASS="PARAMETER"
175><I
176>pattern</I
177></TT
178>.
179If <TT
180CLASS="PARAMETER"
181><I
182>trim</I
183></TT
184> is FcTrue,
185elements in the list which don't include Unicode coverage not provided by
186earlier elements in the list are elided.  The union of Unicode coverage of
187all of the fonts is returned in <TT
188CLASS="PARAMETER"
189><I
190>csp</I
191></TT
192>,
193if <TT
194CLASS="PARAMETER"
195><I
196>csp</I
197></TT
198> is not NULL.  This function
199should be called only after FcConfigSubstitute and FcDefaultSubstitute have
200been called for <TT
201CLASS="PARAMETER"
202><I
203>p</I
204></TT
205>;
206otherwise the results will not be correct.
207    </P
208><P
209>The returned FcFontSet references FcPattern structures which may be shared
210by the return value from multiple FcFontSort calls, applications cannot
211modify these patterns.  Instead, they should be passed, along with
212<TT
213CLASS="PARAMETER"
214><I
215>pattern</I
216></TT
217> to
218<TT
219CLASS="FUNCTION"
220>FcFontRenderPrepare</TT
221> which combines them into a complete pattern.
222    </P
223><P
224>The FcFontSet returned by FcFontSetSort is destroyed by calling FcFontSetDestroy.
225            </P
226></DIV
227><DIV
228CLASS="NAVFOOTER"
229><HR
230ALIGN="LEFT"
231WIDTH="100%"><TABLE
232SUMMARY="Footer navigation table"
233WIDTH="100%"
234BORDER="0"
235CELLPADDING="0"
236CELLSPACING="0"
237><TR
238><TD
239WIDTH="33%"
240ALIGN="left"
241VALIGN="top"
242><A
243HREF="fcfontsetprint.html"
244ACCESSKEY="P"
245>&#60;&#60;&#60; Previous</A
246></TD
247><TD
248WIDTH="34%"
249ALIGN="center"
250VALIGN="top"
251><A
252HREF="t1.html"
253ACCESSKEY="H"
254>Home</A
255></TD
256><TD
257WIDTH="33%"
258ALIGN="right"
259VALIGN="top"
260><A
261HREF="fcfontsetsortdestroy.html"
262ACCESSKEY="N"
263>Next &#62;&#62;&#62;</A
264></TD
265></TR
266><TR
267><TD
268WIDTH="33%"
269ALIGN="left"
270VALIGN="top"
271>FcFontSetPrint</TD
272><TD
273WIDTH="34%"
274ALIGN="center"
275VALIGN="top"
276><A
277HREF="x103.html#AEN1316"
278ACCESSKEY="U"
279>Up</A
280></TD
281><TD
282WIDTH="33%"
283ALIGN="right"
284VALIGN="top"
285>FcFontSetSortDestroy</TD
286></TR
287></TABLE
288></DIV
289></BODY
290></HTML
291>