xenocara/dist/fontconfig/doc/FcFontSetMatch.3

22 lines
878 B
Groff
Raw Normal View History

.\" auto-generated by docbook2man-spec from docbook-utils package
.TH "FcFontSetMatch" "3" "24 3月 2014" "Fontconfig 2.11.1" ""
.SH NAME
FcFontSetMatch \- Return the best font from a set of font sets
.SH SYNOPSIS
.nf
\fB#include <fontconfig/fontconfig.h>
.sp
FcPattern * FcFontSetMatch (FcConfig *\fIconfig\fB, FcFontSet **\fIsets\fB, int\fInsets\fB, FcPattern *\fIpattern\fB, FcResult *\fIresult\fB);
.fi\fR
.SH "DESCRIPTION"
.PP
Finds the font in \fIsets\fR most closely matching
\fIpattern\fR and returns the result of
\fBFcFontRenderPrepare\fR for that font and the provided
pattern. This function should be called only after
\fBFcConfigSubstitute\fR and
\fBFcDefaultSubstitute\fR have been called for
\fIpattern\fR; otherwise the results will not be correct.
If \fIconfig\fR is NULL, the current configuration is used.
Returns NULL if an error occurs during this process.