Imported Upstream version 2.13.1
[platform/upstream/fontconfig.git] / doc / FcFontMatch.3
1 .\" auto-generated by docbook2man-spec from docbook-utils package
2 .TH "FcFontMatch" "3" "30 8月 2018" "Fontconfig 2.13.1" ""
3 .SH NAME
4 FcFontMatch \- Return best font
5 .SH SYNOPSIS
6 .nf
7 \fB#include <fontconfig/fontconfig.h>
8 .sp
9 FcPattern * FcFontMatch (FcConfig *\fIconfig\fB, FcPattern *\fIp\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 \fIp\fR; otherwise the results will not be correct.
20 If \fIconfig\fR is NULL, the current configuration is used.