|
Packit |
352660 |
.\" auto-generated by docbook2man-spec from docbook-utils package
|
|
Packit |
352660 |
.TH "FcPatternBuild" "3" "30 8月 2018" "Fontconfig 2.13.1" ""
|
|
Packit |
352660 |
.SH NAME
|
|
Packit |
352660 |
FcPatternBuild, FcPatternVaBuild, FcPatternVapBuild \- Create patterns from arguments
|
|
Packit |
352660 |
.SH SYNOPSIS
|
|
Packit |
352660 |
.nf
|
|
Packit |
352660 |
\fB#include <fontconfig/fontconfig.h>
|
|
Packit |
352660 |
.sp
|
|
Packit |
352660 |
FcPattern * FcPatternBuild (FcPattern *\fIpattern\fB, \&...\fI\fB);
|
|
Packit |
352660 |
.sp
|
|
Packit |
352660 |
FcPattern * FcPatternVaBuild (FcPattern *\fIpattern\fB, va_list \fIva\fB);
|
|
Packit |
352660 |
.sp
|
|
Packit |
352660 |
void FcPatternVapBuild (FcPattern *\fIresult\fB, FcPattern *\fIpattern\fB, va_list \fIva\fB);
|
|
Packit |
352660 |
.fi\fR
|
|
Packit |
352660 |
.SH "DESCRIPTION"
|
|
Packit |
352660 |
.PP
|
|
Packit |
352660 |
Builds a pattern using a list of objects, types and values. Each
|
|
Packit |
352660 |
value to be entered in the pattern is specified with three arguments:
|
|
Packit |
352660 |
.IP 1.
|
|
Packit |
352660 |
Object name, a string describing the property to be added.
|
|
Packit |
352660 |
.IP 2.
|
|
Packit |
352660 |
Object type, one of the FcType enumerated values
|
|
Packit |
352660 |
.IP 3.
|
|
Packit |
352660 |
Value, not an FcValue, but the raw type as passed to any of the
|
|
Packit |
352660 |
FcPatternAdd<type> functions. Must match the type of the second
|
|
Packit |
352660 |
argument.
|
|
Packit |
352660 |
.PP
|
|
Packit |
352660 |
The argument list is terminated by a null object name, no object type nor
|
|
Packit |
352660 |
value need be passed for this. The values are added to `pattern', if
|
|
Packit |
352660 |
`pattern' is null, a new pattern is created. In either case, the pattern is
|
|
Packit |
352660 |
returned. Example
|
|
Packit |
352660 |
.PP
|
|
Packit |
352660 |
.sp
|
|
Packit |
352660 |
.nf
|
|
Packit |
352660 |
pattern = FcPatternBuild (0, FC_FAMILY, FcTypeString, "Times", (char *) 0);
|
|
Packit |
352660 |
.sp
|
|
Packit |
352660 |
.fi
|
|
Packit |
352660 |
.PP
|
|
Packit |
352660 |
FcPatternVaBuild is used when the arguments are already in the form of a
|
|
Packit |
352660 |
varargs value. FcPatternVapBuild is a macro version of FcPatternVaBuild
|
|
Packit |
352660 |
which returns its result directly in the \fIresult\fR
|
|
Packit |
352660 |
variable.
|
|
Packit |
352660 |
.PP
|