1FcPatternBuild(3)                                            FcPatternBuild(3)
2
3
4

NAME

6       FcPatternBuild, FcPatternVaBuild - Create patterns from arguments
7

SYNOPSIS

9       #include <fontconfig.h>
10
11       FcPattern * FcPatternBuild (FcPattern *orig, ...);
12
13       FcPattern * FcPatternVaBuild (FcPattern *orig, va_list va);
14

DESCRIPTION

16       Builds a pattern using a list of objects, types and values.  Each value
17       to be entered in the pattern is specified with three arguments:
18
19       1. Object name, a string describing the property to be added.
20
21       2. Object type, one of the FcType enumerated values
22
23       3. Value, not an FcValue, but the raw type as  passed  to  any  of  the
24          FcPatternAdd<type>  functions.   Must  match  the type of the second
25          argument.
26
27       The argument list is terminated by a null object name, no  object  type
28       nor  value need be passed for this.  The values are added to `pattern',
29       if `pattern' is null, a new pattern is created.  In  either  case,  the
30       pattern is returned. Example
31
32       pattern = FcPatternBuild (0, FC_FAMILY, FcTypeString, "Times", (char *) 0);
33
34       FcPatternVaBuild  is used when the arguments are already in the form of
35       a varargs value.
36

VERSION

38       Fontconfig version 2.4.2
39
40
41
42                                  11 May 2007                FcPatternBuild(3)