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

NAME

6       FcPatternBuild,  FcPatternVaBuild,  FcPatternVapBuild - Create patterns
7       from arguments
8

SYNOPSIS

10       #include <fontconfig.h>
11
12       FcPattern * FcPatternBuild(FcPattern *pattern);
13       (...);
14
15       FcPattern * FcPatternVaBuild(FcPattern *pattern);
16       (va_list va);
17
18       void FcPatternVapBuild(FcPattern *result);
19       (FcPattern *pattern);
20       (va_list va);
21       .fi
22

DESCRIPTION

24       Builds a pattern using a list of objects, types and values. Each  value
25       to be entered in the pattern is specified with three arguments:
26
27       1.     Object name, a string describing the property to be added.
28
29       2.     Object type, one of the FcType enumerated values
30
31       3.     Value,  not an FcValue, but the raw type as passed to any of the
32              FcPatternAdd<type> functions. Must match the type of the  second
33              argument.
34
35       The  argument  list is terminated by a null object name, no object type
36       nor value need be passed for this. The values are added  to  `pattern',
37       if  `pattern'  is  null,  a new pattern is created. In either case, the
38       pattern is returned. Example
39
40       pattern = FcPatternBuild (0, FC_FAMILY, FcTypeString, "Times", (char *) 0);
41
42
43       FcPatternVaBuild is used when the arguments are already in the form  of
44       a  varargs  value.  FcPatternVapBuild  is  a  macro  version  of FcPat‐
45       ternVaBuild which returns its result directly in the result variable.
46

VERSION

48       Fontconfig version 2.8.0
49
50
51
52                               18 November 2009              FcPatternBuild(3)
Impressum