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>FcFontSort</TITLE
6a6844aabSmrg><META
7a6844aabSmrgNAME="GENERATOR"
8a6844aabSmrgCONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
9a6844aabSmrgREL="HOME"
10a6844aabSmrgHREF="t1.html"><LINK
11a6844aabSmrgREL="UP"
12a6844aabSmrgTITLE="FcConfig"
13a32e9e42SmrgHREF="x103.html#AEN3038"><LINK
14a6844aabSmrgREL="PREVIOUS"
15a6844aabSmrgTITLE="FcFontMatch"
16a6844aabSmrgHREF="fcfontmatch.html"><LINK
17a6844aabSmrgREL="NEXT"
18a6844aabSmrgTITLE="FcFontRenderPrepare"
19a6844aabSmrgHREF="fcfontrenderprepare.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="fcfontmatch.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="fcfontrenderprepare.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="FCFONTSORT"
73a6844aabSmrg></A
74a6844aabSmrg>FcFontSort</H1
75a6844aabSmrg><DIV
76a6844aabSmrgCLASS="REFNAMEDIV"
77a6844aabSmrg><A
78ae02b298SmrgNAME="AEN3569"
79a6844aabSmrg></A
80a6844aabSmrg><H2
81a6844aabSmrg>Name</H2
82a6844aabSmrg>FcFontSort&nbsp;--&nbsp;Return list of matching fonts</DIV
83a6844aabSmrg><DIV
84a6844aabSmrgCLASS="REFSYNOPSISDIV"
85a6844aabSmrg><A
86ae02b298SmrgNAME="AEN3572"
87a6844aabSmrg></A
88a6844aabSmrg><H2
89a6844aabSmrg>Synopsis</H2
90a6844aabSmrg><DIV
91a6844aabSmrgCLASS="FUNCSYNOPSIS"
92a6844aabSmrg><P
93a6844aabSmrg></P
94a6844aabSmrg><A
95ae02b298SmrgNAME="AEN3573"
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"
114a6844aabSmrg>FcFontSet * <TT
115a6844aabSmrgCLASS="FUNCTION"
116a6844aabSmrg>FcFontSort</TT
117a6844aabSmrg></CODE
118a6844aabSmrg>(FcConfig *<TT
119a6844aabSmrgCLASS="PARAMETER"
120a6844aabSmrg><I
121a6844aabSmrg>config</I
122a6844aabSmrg></TT
123a6844aabSmrg>, FcPattern *<TT
124a6844aabSmrgCLASS="PARAMETER"
125a6844aabSmrg><I
126a6844aabSmrg>p</I
127a6844aabSmrg></TT
128a6844aabSmrg>, FcBool <TT
129a6844aabSmrgCLASS="PARAMETER"
130a6844aabSmrg><I
131a6844aabSmrg>trim</I
132a6844aabSmrg></TT
133a6844aabSmrg>, FcCharSet **<TT
134a6844aabSmrgCLASS="PARAMETER"
135a6844aabSmrg><I
136a6844aabSmrg>csp</I
137a6844aabSmrg></TT
138a6844aabSmrg>, FcResult *<TT
139a6844aabSmrgCLASS="PARAMETER"
140a6844aabSmrg><I
141a6844aabSmrg>result</I
142a6844aabSmrg></TT
143a6844aabSmrg>);</CODE
144a6844aabSmrg></P
145a6844aabSmrg><P
146a6844aabSmrg></P
147a6844aabSmrg></DIV
148a6844aabSmrg></DIV
149a6844aabSmrg><DIV
150a6844aabSmrgCLASS="REFSECT1"
151a6844aabSmrg><A
152ae02b298SmrgNAME="AEN3588"
153a6844aabSmrg></A
154a6844aabSmrg><H2
155a6844aabSmrg>Description</H2
156a6844aabSmrg><P
157a6844aabSmrg>Returns the list of fonts sorted by closeness to <TT
158a6844aabSmrgCLASS="PARAMETER"
159a6844aabSmrg><I
160a6844aabSmrg>p</I
161a6844aabSmrg></TT
162a6844aabSmrg>.  If <TT
163a6844aabSmrgCLASS="PARAMETER"
164a6844aabSmrg><I
165a6844aabSmrg>trim</I
166a6844aabSmrg></TT
167a6844aabSmrg> is FcTrue,
168a6844aabSmrgelements in the list which don't include Unicode coverage not provided by
169a6844aabSmrgearlier elements in the list are elided.  The union of Unicode coverage of
170a6844aabSmrgall of the fonts is returned in <TT
171a6844aabSmrgCLASS="PARAMETER"
172a6844aabSmrg><I
173a6844aabSmrg>csp</I
174a6844aabSmrg></TT
175a6844aabSmrg>, if <TT
176a6844aabSmrgCLASS="PARAMETER"
177a6844aabSmrg><I
178a6844aabSmrg>csp</I
179a6844aabSmrg></TT
180a6844aabSmrg> is not NULL.  This function
181a6844aabSmrgshould be called only after FcConfigSubstitute and FcDefaultSubstitute have
182a6844aabSmrgbeen called for <TT
183a6844aabSmrgCLASS="PARAMETER"
184a6844aabSmrg><I
185a6844aabSmrg>p</I
186a6844aabSmrg></TT
187a6844aabSmrg>; otherwise the results will not be correct.
188a6844aabSmrg    </P
189a6844aabSmrg><P
190a6844aabSmrg>The returned FcFontSet references FcPattern structures which may be shared
191a6844aabSmrgby the return value from multiple FcFontSort calls, applications must not
192a6844aabSmrgmodify these patterns.  Instead, they should be passed, along with <TT
193a6844aabSmrgCLASS="PARAMETER"
194a6844aabSmrg><I
195a6844aabSmrg>p</I
196a6844aabSmrg></TT
197a6844aabSmrg> to
198a6844aabSmrg<TT
199a6844aabSmrgCLASS="FUNCTION"
200a6844aabSmrg>FcFontRenderPrepare</TT
201a6844aabSmrg> which combines them into a complete pattern.
202a6844aabSmrg    </P
203a6844aabSmrg><P
204ca08ab68Smrg>The FcFontSet returned by FcFontSort is destroyed by calling FcFontSetDestroy.
205a6844aabSmrgIf <TT
206a6844aabSmrgCLASS="PARAMETER"
207a6844aabSmrg><I
208a6844aabSmrg>config</I
209a6844aabSmrg></TT
210a6844aabSmrg> is NULL, the current configuration is used.
2111cc69409Smrg            </P
212a6844aabSmrg></DIV
213a6844aabSmrg><DIV
214a6844aabSmrgCLASS="NAVFOOTER"
215a6844aabSmrg><HR
216a6844aabSmrgALIGN="LEFT"
217a6844aabSmrgWIDTH="100%"><TABLE
218a6844aabSmrgSUMMARY="Footer navigation table"
219a6844aabSmrgWIDTH="100%"
220a6844aabSmrgBORDER="0"
221a6844aabSmrgCELLPADDING="0"
222a6844aabSmrgCELLSPACING="0"
223a6844aabSmrg><TR
224a6844aabSmrg><TD
225a6844aabSmrgWIDTH="33%"
226a6844aabSmrgALIGN="left"
227a6844aabSmrgVALIGN="top"
228a6844aabSmrg><A
229a6844aabSmrgHREF="fcfontmatch.html"
230a6844aabSmrgACCESSKEY="P"
231a6844aabSmrg>&#60;&#60;&#60; Previous</A
232a6844aabSmrg></TD
233a6844aabSmrg><TD
234a6844aabSmrgWIDTH="34%"
235a6844aabSmrgALIGN="center"
236a6844aabSmrgVALIGN="top"
237a6844aabSmrg><A
238a6844aabSmrgHREF="t1.html"
239a6844aabSmrgACCESSKEY="H"
240a6844aabSmrg>Home</A
241a6844aabSmrg></TD
242a6844aabSmrg><TD
243a6844aabSmrgWIDTH="33%"
244a6844aabSmrgALIGN="right"
245a6844aabSmrgVALIGN="top"
246a6844aabSmrg><A
247a6844aabSmrgHREF="fcfontrenderprepare.html"
248a6844aabSmrgACCESSKEY="N"
249a6844aabSmrg>Next &#62;&#62;&#62;</A
250a6844aabSmrg></TD
251a6844aabSmrg></TR
252a6844aabSmrg><TR
253a6844aabSmrg><TD
254a6844aabSmrgWIDTH="33%"
255a6844aabSmrgALIGN="left"
256a6844aabSmrgVALIGN="top"
257a6844aabSmrg>FcFontMatch</TD
258a6844aabSmrg><TD
259a6844aabSmrgWIDTH="34%"
260a6844aabSmrgALIGN="center"
261a6844aabSmrgVALIGN="top"
262a6844aabSmrg><A
263a32e9e42SmrgHREF="x103.html#AEN3038"
264a6844aabSmrgACCESSKEY="U"
265a6844aabSmrg>Up</A
266a6844aabSmrg></TD
267a6844aabSmrg><TD
268a6844aabSmrgWIDTH="33%"
269a6844aabSmrgALIGN="right"
270a6844aabSmrgVALIGN="top"
271a6844aabSmrg>FcFontRenderPrepare</TD
272a6844aabSmrg></TR
273a6844aabSmrg></TABLE
274a6844aabSmrg></DIV
275a6844aabSmrg></BODY
276a6844aabSmrg></HTML
277a6844aabSmrg>