2013-03-09 06:33:45 -07:00
|
|
|
.\" auto-generated by docbook2man-spec from docbook-utils package
|
2016-08-09 12:57:41 -06:00
|
|
|
.TH "FcFontSort" "3" "05 8月 2016" "Fontconfig 2.12.1" ""
|
2013-03-09 06:33:45 -07:00
|
|
|
.SH NAME
|
|
|
|
|
FcFontSort \- Return list of matching fonts
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
.nf
|
|
|
|
|
\fB#include <fontconfig/fontconfig.h>
|
|
|
|
|
.sp
|
|
|
|
|
FcFontSet * FcFontSort (FcConfig *\fIconfig\fB, FcPattern *\fIp\fB, FcBool \fItrim\fB, FcCharSet **\fIcsp\fB, FcResult *\fIresult\fB);
|
|
|
|
|
.fi\fR
|
|
|
|
|
.SH "DESCRIPTION"
|
|
|
|
|
.PP
|
|
|
|
|
Returns the list of fonts sorted by closeness to \fIp\fR\&. If \fItrim\fR is FcTrue,
|
|
|
|
|
elements in the list which don't include Unicode coverage not provided by
|
|
|
|
|
earlier elements in the list are elided. The union of Unicode coverage of
|
|
|
|
|
all of the fonts is returned in \fIcsp\fR, if \fIcsp\fR is not NULL. This function
|
|
|
|
|
should be called only after FcConfigSubstitute and FcDefaultSubstitute have
|
|
|
|
|
been called for \fIp\fR; otherwise the results will not be correct.
|
|
|
|
|
.PP
|
|
|
|
|
The returned FcFontSet references FcPattern structures which may be shared
|
|
|
|
|
by the return value from multiple FcFontSort calls, applications must not
|
|
|
|
|
modify these patterns. Instead, they should be passed, along with \fIp\fR to
|
|
|
|
|
\fBFcFontRenderPrepare\fR which combines them into a complete pattern.
|
|
|
|
|
.PP
|
|
|
|
|
The FcFontSet returned by FcFontSort is destroyed by calling FcFontSetDestroy.
|
|
|
|
|
If \fIconfig\fR is NULL, the current configuration is used.
|
