Imported Upstream version 2.12.1
[platform/upstream/fontconfig.git] / doc / FcFontSetMatch.3
1 .\" auto-generated by docbook2man-spec from docbook-utils package
2 .TH "FcFontSetMatch" "3" "05 8月 2016" "Fontconfig 2.12.1" ""
3 .SH NAME
4 FcFontSetMatch \- Return the best font from a set of font sets
5 .SH SYNOPSIS
6 .nf
7 \fB#include <fontconfig/fontconfig.h>
8 .sp
9 FcPattern * FcFontSetMatch (FcConfig *\fIconfig\fB, FcFontSet **\fIsets\fB, int\fInsets\fB, FcPattern *\fIpattern\fB, FcResult *\fIresult\fB);
10 .fi\fR
11 .SH "DESCRIPTION"
12 .PP
13 Finds the font in \fIsets\fR most closely matching
14 \fIpattern\fR and returns the result of
15 \fBFcFontRenderPrepare\fR for that font and the provided
16 pattern. This function should be called only after
17 \fBFcConfigSubstitute\fR and
18 \fBFcDefaultSubstitute\fR have been called for
19 \fIpattern\fR; otherwise the results will not be correct.
20 If \fIconfig\fR is NULL, the current configuration is used.
21 Returns NULL if an error occurs during this process.