aboutsummaryrefslogtreecommitdiff
path: root/nx-X11/extras/fontconfig/doc/FcPatternBuild.3
blob: daa3ad92eb306641611c5d808dd370b7773f4117 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "FcPatternBuild" "3" "27 April 2005" "" ""

.SH NAME
FcPatternBuild, FcPatternVaBuild \- Create patterns from arguments
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcPattern * FcPatternBuild (FcPattern *\fIorig\fB, \&...\fI\fB);
.sp
FcPattern * FcPatternVaBuild (FcPattern *\fIorig\fB, va_list\fIva\fB);
\fR
.SH "DESCRIPTION"
.PP
Builds a pattern using a list of objects, types and values.  Each
value to be entered in the pattern is specified with three arguments:
.TP 3
1. 
Object name, a string describing the property to be added.
.TP 3
2. 
Object type, one of the FcType enumerated values
.TP 3
3. 
Value, not an FcValue, but the raw type as passed to any of the
FcPatternAdd<type> functions.  Must match the type of the second
argument.
.PP
The argument list is terminated by a null object name, no object type nor
value need be passed for this.  The values are added to `pattern', if
`pattern' is null, a new pattern is created.  In either case, the pattern is
returned. Example

.nf
pattern = FcPatternBuild (0, FC_FAMILY, FtTypeString, "Times", (char *) 0);
.fi
.PP
FcPatternVaBuild is used when the arguments are already in the form of a
varargs value.
.SH "VERSION"
.PP
Fontconfig version 2.3.2