1a6844aabSmrg<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd">
2a6844aabSmrg<HTML
3a6844aabSmrg><HEAD
4a6844aabSmrg><TITLE
5a6844aabSmrg>FcFontSetSort</TITLE
6a6844aabSmrg><META
7a6844aabSmrgNAME="GENERATOR"
8a6844aabSmrgCONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
9a6844aabSmrgREL="HOME"
10a6844aabSmrgHREF="t1.html"><LINK
11a6844aabSmrgREL="UP"
12a6844aabSmrgTITLE="FcFontSet"
13a32e9e42SmrgHREF="x103.html#AEN1316"><LINK
14a6844aabSmrgREL="PREVIOUS"
15a6844aabSmrgTITLE="FcFontSetPrint"
16a6844aabSmrgHREF="fcfontsetprint.html"><LINK
17a6844aabSmrgREL="NEXT"
18a6844aabSmrgTITLE="FcFontSetSortDestroy"
19a6844aabSmrgHREF="fcfontsetsortdestroy.html"></HEAD
20a6844aabSmrg><BODY
21a6844aabSmrgCLASS="REFENTRY"
22a6844aabSmrgBGCOLOR="#FFFFFF"
23a6844aabSmrgTEXT="#000000"
24a6844aabSmrgLINK="#0000FF"
25a6844aabSmrgVLINK="#840084"
26a6844aabSmrgALINK="#0000FF"
27a6844aabSmrg><DIV
28a6844aabSmrgCLASS="NAVHEADER"
29a6844aabSmrg><TABLE
30a6844aabSmrgSUMMARY="Header navigation table"
31a6844aabSmrgWIDTH="100%"
32a6844aabSmrgBORDER="0"
33a6844aabSmrgCELLPADDING="0"
34a6844aabSmrgCELLSPACING="0"
35a6844aabSmrg><TR
36a6844aabSmrg><TH
37a6844aabSmrgCOLSPAN="3"
38a6844aabSmrgALIGN="center"
39a6844aabSmrg></TH
40a6844aabSmrg></TR
41a6844aabSmrg><TR
42a6844aabSmrg><TD
43a6844aabSmrgWIDTH="10%"
44a6844aabSmrgALIGN="left"
45a6844aabSmrgVALIGN="bottom"
46a6844aabSmrg><A
47a6844aabSmrgHREF="fcfontsetprint.html"
48a6844aabSmrgACCESSKEY="P"
49a6844aabSmrg>&#60;&#60;&#60; Previous</A
50a6844aabSmrg></TD
51a6844aabSmrg><TD
52a6844aabSmrgWIDTH="80%"
53a6844aabSmrgALIGN="center"
54a6844aabSmrgVALIGN="bottom"
55a6844aabSmrg></TD
56a6844aabSmrg><TD
57a6844aabSmrgWIDTH="10%"
58a6844aabSmrgALIGN="right"
59a6844aabSmrgVALIGN="bottom"
60a6844aabSmrg><A
61a6844aabSmrgHREF="fcfontsetsortdestroy.html"
62a6844aabSmrgACCESSKEY="N"
63a6844aabSmrg>Next &#62;&#62;&#62;</A
64a6844aabSmrg></TD
65a6844aabSmrg></TR
66a6844aabSmrg></TABLE
67a6844aabSmrg><HR
68a6844aabSmrgALIGN="LEFT"
69a6844aabSmrgWIDTH="100%"></DIV
70a6844aabSmrg><H1
71a6844aabSmrg><A
72a6844aabSmrgNAME="FCFONTSETSORT"
73a6844aabSmrg></A
74a6844aabSmrg>FcFontSetSort</H1
75a6844aabSmrg><DIV
76a6844aabSmrgCLASS="REFNAMEDIV"
77a6844aabSmrg><A
78a32e9e42SmrgNAME="AEN1468"
79a6844aabSmrg></A
80a6844aabSmrg><H2
81a6844aabSmrg>Name</H2
82a6844aabSmrg>FcFontSetSort&nbsp;--&nbsp;Add to a font set</DIV
83a6844aabSmrg><DIV
84a6844aabSmrgCLASS="REFSYNOPSISDIV"
85a6844aabSmrg><A
86a32e9e42SmrgNAME="AEN1471"
87a6844aabSmrg></A
88a6844aabSmrg><H2
89a6844aabSmrg>Synopsis</H2
90a6844aabSmrg><DIV
91a6844aabSmrgCLASS="FUNCSYNOPSIS"
92a6844aabSmrg><P
93a6844aabSmrg></P
94a6844aabSmrg><A
95a32e9e42SmrgNAME="AEN1472"
96a6844aabSmrg></A
97a6844aabSmrg><TABLE
98a6844aabSmrgBORDER="0"
99a6844aabSmrgBGCOLOR="#E0E0E0"
100a6844aabSmrgWIDTH="100%"
101a6844aabSmrg><TR
102a6844aabSmrg><TD
103a6844aabSmrg><PRE
104a6844aabSmrgCLASS="FUNCSYNOPSISINFO"
105c9710b42Smrg>#include &#60;fontconfig/fontconfig.h&#62;
1061cc69409Smrg        </PRE
107a6844aabSmrg></TD
108a6844aabSmrg></TR
109a6844aabSmrg></TABLE
110a6844aabSmrg><P
111a6844aabSmrg><CODE
112a6844aabSmrg><CODE
113a6844aabSmrgCLASS="FUNCDEF"
114a4e54154Smrg>FcFontSet * <TT
115a6844aabSmrgCLASS="FUNCTION"
116a6844aabSmrg>FcFontSetSort</TT
117a6844aabSmrg></CODE
118a6844aabSmrg>(FcConfig *<TT
119a6844aabSmrgCLASS="PARAMETER"
120a6844aabSmrg><I
121a6844aabSmrg>config</I
122a6844aabSmrg></TT
123a6844aabSmrg>, FcFontSet **<TT
124a6844aabSmrgCLASS="PARAMETER"
125a6844aabSmrg><I
126a6844aabSmrg>sets</I
127a6844aabSmrg></TT
128a6844aabSmrg>, int<TT
129a6844aabSmrgCLASS="PARAMETER"
130a6844aabSmrg><I
131a6844aabSmrg>nsets</I
132a6844aabSmrg></TT
133a6844aabSmrg>, FcPattern *<TT
134a6844aabSmrgCLASS="PARAMETER"
135a6844aabSmrg><I
136a6844aabSmrg>pattern</I
137a6844aabSmrg></TT
138a6844aabSmrg>, FcBool <TT
139a6844aabSmrgCLASS="PARAMETER"
140a6844aabSmrg><I
141a6844aabSmrg>trim</I
142a6844aabSmrg></TT
143a6844aabSmrg>, FcCharSet **<TT
144a6844aabSmrgCLASS="PARAMETER"
145a6844aabSmrg><I
146a6844aabSmrg>csp</I
147a6844aabSmrg></TT
148a6844aabSmrg>, FcResult *<TT
149a6844aabSmrgCLASS="PARAMETER"
150a6844aabSmrg><I
151a6844aabSmrg>result</I
152a6844aabSmrg></TT
153a6844aabSmrg>);</CODE
154a6844aabSmrg></P
155a6844aabSmrg><P
156a6844aabSmrg></P
157a6844aabSmrg></DIV
158a6844aabSmrg></DIV
159a6844aabSmrg><DIV
160a6844aabSmrgCLASS="REFSECT1"
161a6844aabSmrg><A
162a32e9e42SmrgNAME="AEN1491"
163a6844aabSmrg></A
164a6844aabSmrg><H2
165a6844aabSmrg>Description</H2
166a6844aabSmrg><P
167a6844aabSmrg>Returns the list of fonts from <TT
168a6844aabSmrgCLASS="PARAMETER"
169a6844aabSmrg><I
170a6844aabSmrg>sets</I
171a6844aabSmrg></TT
172a6844aabSmrg>
173a6844aabSmrgsorted by closeness to <TT
174a6844aabSmrgCLASS="PARAMETER"
175a6844aabSmrg><I
176a6844aabSmrg>pattern</I
177a6844aabSmrg></TT
1781cc69409Smrg>.
179a6844aabSmrgIf <TT
180a6844aabSmrgCLASS="PARAMETER"
181a6844aabSmrg><I
182a6844aabSmrg>trim</I
183a6844aabSmrg></TT
184a6844aabSmrg> is FcTrue,
185a6844aabSmrgelements in the list which don't include Unicode coverage not provided by
186a6844aabSmrgearlier elements in the list are elided.  The union of Unicode coverage of
187a6844aabSmrgall of the fonts is returned in <TT
188a6844aabSmrgCLASS="PARAMETER"
189a6844aabSmrg><I
190a6844aabSmrg>csp</I
191a6844aabSmrg></TT
192a6844aabSmrg>,
193a6844aabSmrgif <TT
194a6844aabSmrgCLASS="PARAMETER"
195a6844aabSmrg><I
196a6844aabSmrg>csp</I
197a6844aabSmrg></TT
198a6844aabSmrg> is not NULL.  This function
199a6844aabSmrgshould be called only after FcConfigSubstitute and FcDefaultSubstitute have
200a6844aabSmrgbeen called for <TT
201a6844aabSmrgCLASS="PARAMETER"
202a6844aabSmrg><I
203a6844aabSmrg>p</I
204a6844aabSmrg></TT
205a6844aabSmrg>;
206a6844aabSmrgotherwise the results will not be correct.
207a6844aabSmrg    </P
208a6844aabSmrg><P
209a6844aabSmrg>The returned FcFontSet references FcPattern structures which may be shared
210a6844aabSmrgby the return value from multiple FcFontSort calls, applications cannot
211a6844aabSmrgmodify these patterns.  Instead, they should be passed, along with
212a6844aabSmrg<TT
213a6844aabSmrgCLASS="PARAMETER"
214a6844aabSmrg><I
215a6844aabSmrg>pattern</I
216a6844aabSmrg></TT
217a6844aabSmrg> to
218a6844aabSmrg<TT
219a6844aabSmrgCLASS="FUNCTION"
220a6844aabSmrg>FcFontRenderPrepare</TT
221a6844aabSmrg> which combines them into a complete pattern.
222a6844aabSmrg    </P
223a6844aabSmrg><P
224ca08ab68Smrg>The FcFontSet returned by FcFontSetSort is destroyed by calling FcFontSetDestroy.
2251cc69409Smrg            </P
226a6844aabSmrg></DIV
227a6844aabSmrg><DIV
228a6844aabSmrgCLASS="NAVFOOTER"
229a6844aabSmrg><HR
230a6844aabSmrgALIGN="LEFT"
231a6844aabSmrgWIDTH="100%"><TABLE
232a6844aabSmrgSUMMARY="Footer navigation table"
233a6844aabSmrgWIDTH="100%"
234a6844aabSmrgBORDER="0"
235a6844aabSmrgCELLPADDING="0"
236a6844aabSmrgCELLSPACING="0"
237a6844aabSmrg><TR
238a6844aabSmrg><TD
239a6844aabSmrgWIDTH="33%"
240a6844aabSmrgALIGN="left"
241a6844aabSmrgVALIGN="top"
242a6844aabSmrg><A
243a6844aabSmrgHREF="fcfontsetprint.html"
244a6844aabSmrgACCESSKEY="P"
245a6844aabSmrg>&#60;&#60;&#60; Previous</A
246a6844aabSmrg></TD
247a6844aabSmrg><TD
248a6844aabSmrgWIDTH="34%"
249a6844aabSmrgALIGN="center"
250a6844aabSmrgVALIGN="top"
251a6844aabSmrg><A
252a6844aabSmrgHREF="t1.html"
253a6844aabSmrgACCESSKEY="H"
254a6844aabSmrg>Home</A
255a6844aabSmrg></TD
256a6844aabSmrg><TD
257a6844aabSmrgWIDTH="33%"
258a6844aabSmrgALIGN="right"
259a6844aabSmrgVALIGN="top"
260a6844aabSmrg><A
261a6844aabSmrgHREF="fcfontsetsortdestroy.html"
262a6844aabSmrgACCESSKEY="N"
263a6844aabSmrg>Next &#62;&#62;&#62;</A
264a6844aabSmrg></TD
265a6844aabSmrg></TR
266a6844aabSmrg><TR
267a6844aabSmrg><TD
268a6844aabSmrgWIDTH="33%"
269a6844aabSmrgALIGN="left"
270a6844aabSmrgVALIGN="top"
271a6844aabSmrg>FcFontSetPrint</TD
272a6844aabSmrg><TD
273a6844aabSmrgWIDTH="34%"
274a6844aabSmrgALIGN="center"
275a6844aabSmrgVALIGN="top"
276a6844aabSmrg><A
277a32e9e42SmrgHREF="x103.html#AEN1316"
278a6844aabSmrgACCESSKEY="U"
279a6844aabSmrg>Up</A
280a6844aabSmrg></TD
281a6844aabSmrg><TD
282a6844aabSmrgWIDTH="33%"
283a6844aabSmrgALIGN="right"
284a6844aabSmrgVALIGN="top"
285a6844aabSmrg>FcFontSetSortDestroy</TD
286a6844aabSmrg></TR
287a6844aabSmrg></TABLE
288a6844aabSmrg></DIV
289a6844aabSmrg></BODY
290a6844aabSmrg></HTML
291a6844aabSmrg>