| Current File : //usr/man/man3/FcFontSetMatch.3 |
'\" t
.\\" auto-generated by docbook2man-spec $Revision: 1.2 $
.TH "FcFontSetMatch" "3" "18 November 2009" "" ""
.SH NAME
FcFontSetMatch \- Return the best font from a set of font sets
.SH SYNOPSIS
.nf
\fBcc\fR [ \fIflag\fR\&.\&.\&. ] \fIfile\fR\&.\&.\&. \fB\-lfontconfig\fR [ \fIlibrary\fR\&.\&.\&. ]
.fi
.sp
.nf
\fBcc\fR [ \fIflag\fR\&.\&.\&. ] `pkg-config --cflags fontconfig` \fIfile\fR\&.\&.\&. `pkg-config --libs fontconfig`
.fi
.nf
\fB#include <fontconfig.h>
.sp
FcPattern * FcFontSetMatch(FcConfig *\fIconfig\fB);
(FcFontSet **\fIsets\fB);
(int\fInsets\fB);
(FcPattern *\fIpattern\fB);
(FcResult *\fIresult\fB);
\fR.fi
.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.
.SH "VERSION"
.PP
Fontconfig version 2.8.0
.\" Begin Oracle Solaris update
.SH "ATTRIBUTES"
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp
.TS
allbox;
cw(2.750000i)| cw(2.750000i)
lw(2.750000i)| lw(2.750000i).
ATTRIBUTE TYPE ATTRIBUTE VALUE
Availability system/library/fontconfig
Interface Stability Volatile
MT-Level Unknown
.TE
.sp
.\" End Oracle Solaris update