1 1.1 mrg <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2 1.1 mrg <HTML 3 1.1 mrg ><HEAD 4 1.1 mrg ><TITLE 5 1.1 mrg >FcFontSort</TITLE 6 1.1 mrg ><META 7 1.1 mrg NAME="GENERATOR" 8 1.1 mrg CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK 9 1.1 mrg REL="HOME" 10 1.1 mrg HREF="t1.html"><LINK 11 1.1 mrg REL="UP" 12 1.1 mrg TITLE="FcConfig" 13 1.1.1.7 mrg HREF="x103.html#AEN3038"><LINK 14 1.1 mrg REL="PREVIOUS" 15 1.1 mrg TITLE="FcFontMatch" 16 1.1 mrg HREF="fcfontmatch.html"><LINK 17 1.1 mrg REL="NEXT" 18 1.1 mrg TITLE="FcFontRenderPrepare" 19 1.1 mrg HREF="fcfontrenderprepare.html"></HEAD 20 1.1 mrg ><BODY 21 1.1 mrg CLASS="REFENTRY" 22 1.1 mrg BGCOLOR="#FFFFFF" 23 1.1 mrg TEXT="#000000" 24 1.1 mrg LINK="#0000FF" 25 1.1 mrg VLINK="#840084" 26 1.1 mrg ALINK="#0000FF" 27 1.1 mrg ><DIV 28 1.1 mrg CLASS="NAVHEADER" 29 1.1 mrg ><TABLE 30 1.1 mrg SUMMARY="Header navigation table" 31 1.1 mrg WIDTH="100%" 32 1.1 mrg BORDER="0" 33 1.1 mrg CELLPADDING="0" 34 1.1 mrg CELLSPACING="0" 35 1.1 mrg ><TR 36 1.1 mrg ><TH 37 1.1 mrg COLSPAN="3" 38 1.1 mrg ALIGN="center" 39 1.1 mrg ></TH 40 1.1 mrg ></TR 41 1.1 mrg ><TR 42 1.1 mrg ><TD 43 1.1 mrg WIDTH="10%" 44 1.1 mrg ALIGN="left" 45 1.1 mrg VALIGN="bottom" 46 1.1 mrg ><A 47 1.1 mrg HREF="fcfontmatch.html" 48 1.1 mrg ACCESSKEY="P" 49 1.1 mrg ><<< Previous</A 50 1.1 mrg ></TD 51 1.1 mrg ><TD 52 1.1 mrg WIDTH="80%" 53 1.1 mrg ALIGN="center" 54 1.1 mrg VALIGN="bottom" 55 1.1 mrg ></TD 56 1.1 mrg ><TD 57 1.1 mrg WIDTH="10%" 58 1.1 mrg ALIGN="right" 59 1.1 mrg VALIGN="bottom" 60 1.1 mrg ><A 61 1.1 mrg HREF="fcfontrenderprepare.html" 62 1.1 mrg ACCESSKEY="N" 63 1.1 mrg >Next >>></A 64 1.1 mrg ></TD 65 1.1 mrg ></TR 66 1.1 mrg ></TABLE 67 1.1 mrg ><HR 68 1.1 mrg ALIGN="LEFT" 69 1.1 mrg WIDTH="100%"></DIV 70 1.1 mrg ><H1 71 1.1 mrg ><A 72 1.1 mrg NAME="FCFONTSORT" 73 1.1 mrg ></A 74 1.1 mrg >FcFontSort</H1 75 1.1 mrg ><DIV 76 1.1 mrg CLASS="REFNAMEDIV" 77 1.1 mrg ><A 78 1.1.1.10 mrg NAME="AEN3569" 79 1.1 mrg ></A 80 1.1 mrg ><H2 81 1.1 mrg >Name</H2 82 1.1 mrg >FcFontSort -- Return list of matching fonts</DIV 83 1.1 mrg ><DIV 84 1.1 mrg CLASS="REFSYNOPSISDIV" 85 1.1 mrg ><A 86 1.1.1.10 mrg NAME="AEN3572" 87 1.1 mrg ></A 88 1.1 mrg ><H2 89 1.1 mrg >Synopsis</H2 90 1.1 mrg ><DIV 91 1.1 mrg CLASS="FUNCSYNOPSIS" 92 1.1 mrg ><P 93 1.1 mrg ></P 94 1.1 mrg ><A 95 1.1.1.10 mrg NAME="AEN3573" 96 1.1 mrg ></A 97 1.1 mrg ><TABLE 98 1.1 mrg BORDER="0" 99 1.1 mrg BGCOLOR="#E0E0E0" 100 1.1 mrg WIDTH="100%" 101 1.1 mrg ><TR 102 1.1 mrg ><TD 103 1.1 mrg ><PRE 104 1.1 mrg CLASS="FUNCSYNOPSISINFO" 105 1.1.1.3 mrg >#include <fontconfig/fontconfig.h> 106 1.1.1.9 mrg </PRE 107 1.1 mrg ></TD 108 1.1 mrg ></TR 109 1.1 mrg ></TABLE 110 1.1 mrg ><P 111 1.1 mrg ><CODE 112 1.1 mrg ><CODE 113 1.1 mrg CLASS="FUNCDEF" 114 1.1 mrg >FcFontSet * <TT 115 1.1 mrg CLASS="FUNCTION" 116 1.1 mrg >FcFontSort</TT 117 1.1 mrg ></CODE 118 1.1 mrg >(FcConfig *<TT 119 1.1 mrg CLASS="PARAMETER" 120 1.1 mrg ><I 121 1.1 mrg >config</I 122 1.1 mrg ></TT 123 1.1 mrg >, FcPattern *<TT 124 1.1 mrg CLASS="PARAMETER" 125 1.1 mrg ><I 126 1.1 mrg >p</I 127 1.1 mrg ></TT 128 1.1 mrg >, FcBool <TT 129 1.1 mrg CLASS="PARAMETER" 130 1.1 mrg ><I 131 1.1 mrg >trim</I 132 1.1 mrg ></TT 133 1.1 mrg >, FcCharSet **<TT 134 1.1 mrg CLASS="PARAMETER" 135 1.1 mrg ><I 136 1.1 mrg >csp</I 137 1.1 mrg ></TT 138 1.1 mrg >, FcResult *<TT 139 1.1 mrg CLASS="PARAMETER" 140 1.1 mrg ><I 141 1.1 mrg >result</I 142 1.1 mrg ></TT 143 1.1 mrg >);</CODE 144 1.1 mrg ></P 145 1.1 mrg ><P 146 1.1 mrg ></P 147 1.1 mrg ></DIV 148 1.1 mrg ></DIV 149 1.1 mrg ><DIV 150 1.1 mrg CLASS="REFSECT1" 151 1.1 mrg ><A 152 1.1.1.10 mrg NAME="AEN3588" 153 1.1 mrg ></A 154 1.1 mrg ><H2 155 1.1 mrg >Description</H2 156 1.1 mrg ><P 157 1.1 mrg >Returns the list of fonts sorted by closeness to <TT 158 1.1 mrg CLASS="PARAMETER" 159 1.1 mrg ><I 160 1.1 mrg >p</I 161 1.1 mrg ></TT 162 1.1 mrg >. If <TT 163 1.1 mrg CLASS="PARAMETER" 164 1.1 mrg ><I 165 1.1 mrg >trim</I 166 1.1 mrg ></TT 167 1.1 mrg > is FcTrue, 168 1.1 mrg elements in the list which don't include Unicode coverage not provided by 169 1.1 mrg earlier elements in the list are elided. The union of Unicode coverage of 170 1.1 mrg all of the fonts is returned in <TT 171 1.1 mrg CLASS="PARAMETER" 172 1.1 mrg ><I 173 1.1 mrg >csp</I 174 1.1 mrg ></TT 175 1.1 mrg >, if <TT 176 1.1 mrg CLASS="PARAMETER" 177 1.1 mrg ><I 178 1.1 mrg >csp</I 179 1.1 mrg ></TT 180 1.1 mrg > is not NULL. This function 181 1.1 mrg should be called only after FcConfigSubstitute and FcDefaultSubstitute have 182 1.1 mrg been called for <TT 183 1.1 mrg CLASS="PARAMETER" 184 1.1 mrg ><I 185 1.1 mrg >p</I 186 1.1 mrg ></TT 187 1.1 mrg >; otherwise the results will not be correct. 188 1.1 mrg </P 189 1.1 mrg ><P 190 1.1 mrg >The returned FcFontSet references FcPattern structures which may be shared 191 1.1 mrg by the return value from multiple FcFontSort calls, applications must not 192 1.1 mrg modify these patterns. Instead, they should be passed, along with <TT 193 1.1 mrg CLASS="PARAMETER" 194 1.1 mrg ><I 195 1.1 mrg >p</I 196 1.1 mrg ></TT 197 1.1 mrg > to 198 1.1 mrg <TT 199 1.1 mrg CLASS="FUNCTION" 200 1.1 mrg >FcFontRenderPrepare</TT 201 1.1 mrg > which combines them into a complete pattern. 202 1.1 mrg </P 203 1.1 mrg ><P 204 1.1.1.2 mrg >The FcFontSet returned by FcFontSort is destroyed by calling FcFontSetDestroy. 205 1.1 mrg If <TT 206 1.1 mrg CLASS="PARAMETER" 207 1.1 mrg ><I 208 1.1 mrg >config</I 209 1.1 mrg ></TT 210 1.1 mrg > is NULL, the current configuration is used. 211 1.1.1.9 mrg </P 212 1.1 mrg ></DIV 213 1.1 mrg ><DIV 214 1.1 mrg CLASS="NAVFOOTER" 215 1.1 mrg ><HR 216 1.1 mrg ALIGN="LEFT" 217 1.1 mrg WIDTH="100%"><TABLE 218 1.1 mrg SUMMARY="Footer navigation table" 219 1.1 mrg WIDTH="100%" 220 1.1 mrg BORDER="0" 221 1.1 mrg CELLPADDING="0" 222 1.1 mrg CELLSPACING="0" 223 1.1 mrg ><TR 224 1.1 mrg ><TD 225 1.1 mrg WIDTH="33%" 226 1.1 mrg ALIGN="left" 227 1.1 mrg VALIGN="top" 228 1.1 mrg ><A 229 1.1 mrg HREF="fcfontmatch.html" 230 1.1 mrg ACCESSKEY="P" 231 1.1 mrg ><<< Previous</A 232 1.1 mrg ></TD 233 1.1 mrg ><TD 234 1.1 mrg WIDTH="34%" 235 1.1 mrg ALIGN="center" 236 1.1 mrg VALIGN="top" 237 1.1 mrg ><A 238 1.1 mrg HREF="t1.html" 239 1.1 mrg ACCESSKEY="H" 240 1.1 mrg >Home</A 241 1.1 mrg ></TD 242 1.1 mrg ><TD 243 1.1 mrg WIDTH="33%" 244 1.1 mrg ALIGN="right" 245 1.1 mrg VALIGN="top" 246 1.1 mrg ><A 247 1.1 mrg HREF="fcfontrenderprepare.html" 248 1.1 mrg ACCESSKEY="N" 249 1.1 mrg >Next >>></A 250 1.1 mrg ></TD 251 1.1 mrg ></TR 252 1.1 mrg ><TR 253 1.1 mrg ><TD 254 1.1 mrg WIDTH="33%" 255 1.1 mrg ALIGN="left" 256 1.1 mrg VALIGN="top" 257 1.1 mrg >FcFontMatch</TD 258 1.1 mrg ><TD 259 1.1 mrg WIDTH="34%" 260 1.1 mrg ALIGN="center" 261 1.1 mrg VALIGN="top" 262 1.1 mrg ><A 263 1.1.1.7 mrg HREF="x103.html#AEN3038" 264 1.1 mrg ACCESSKEY="U" 265 1.1 mrg >Up</A 266 1.1 mrg ></TD 267 1.1 mrg ><TD 268 1.1 mrg WIDTH="33%" 269 1.1 mrg ALIGN="right" 270 1.1 mrg VALIGN="top" 271 1.1 mrg >FcFontRenderPrepare</TD 272 1.1 mrg ></TR 273 1.1 mrg ></TABLE 274 1.1 mrg ></DIV 275 1.1 mrg ></BODY 276 1.1 mrg ></HTML 277 1.1 mrg >
Indexes created Tue Oct 27 00:25:24 UTC 2026