Blame doc/FcFontSetSort.3
|
Packit |
352660 |
.\" auto-generated by docbook2man-spec from docbook-utils package
|
|
Packit |
352660 |
.TH "FcFontSetSort" "3" "30 8月 2018" "Fontconfig 2.13.1" ""
|
|
Packit |
352660 |
.SH NAME
|
|
Packit |
352660 |
FcFontSetSort \- Add to a font set
|
|
Packit |
352660 |
.SH SYNOPSIS
|
|
Packit |
352660 |
.nf
|
|
Packit |
352660 |
\fB#include <fontconfig/fontconfig.h>
|
|
Packit |
352660 |
.sp
|
|
Packit |
352660 |
FcFontSetSort (FcConfig *\fIconfig\fB, FcFontSet **\fIsets\fB, int\fInsets\fB, FcPattern *\fIpattern\fB, FcBool \fItrim\fB, FcCharSet **\fIcsp\fB, FcResult *\fIresult\fB);
|
|
Packit |
352660 |
.fi\fR
|
|
Packit |
352660 |
.SH "DESCRIPTION"
|
|
Packit |
352660 |
.PP
|
|
Packit |
352660 |
Returns the list of fonts from \fIsets\fR
|
|
Packit |
352660 |
sorted by closeness to \fIpattern\fR\&.
|
|
Packit |
352660 |
If \fItrim\fR is FcTrue,
|
|
Packit |
352660 |
elements in the list which don't include Unicode coverage not provided by
|
|
Packit |
352660 |
earlier elements in the list are elided. The union of Unicode coverage of
|
|
Packit |
352660 |
all of the fonts is returned in \fIcsp\fR,
|
|
Packit |
352660 |
if \fIcsp\fR is not NULL. This function
|
|
Packit |
352660 |
should be called only after FcConfigSubstitute and FcDefaultSubstitute have
|
|
Packit |
352660 |
been called for \fIp\fR;
|
|
Packit |
352660 |
otherwise the results will not be correct.
|
|
Packit |
352660 |
.PP
|
|
Packit |
352660 |
The returned FcFontSet references FcPattern structures which may be shared
|
|
Packit |
352660 |
by the return value from multiple FcFontSort calls, applications cannot
|
|
Packit |
352660 |
modify these patterns. Instead, they should be passed, along with
|
|
Packit |
352660 |
\fIpattern\fR to
|
|
Packit |
352660 |
\fBFcFontRenderPrepare\fR which combines them into a complete pattern.
|
|
Packit |
352660 |
.PP
|
|
Packit |
352660 |
The FcFontSet returned by FcFontSetSort is destroyed by calling FcFontSetDestroy.
|