manpagez: man pages & more
man FcPatternVaBuild(3)
Home | html | info | man
FcPatternBuild(3)                                            FcPatternBuild(3)




NAME

       FcPatternBuild,  FcPatternVaBuild,  FcPatternVapBuild - Create patterns
       from arguments


SYNOPSIS

       #include <fontconfig.h>

       FcPattern * FcPatternBuild (FcPattern *pattern, ...);

       FcPattern * FcPatternVaBuild (FcPattern *pattern, va_list va);

       void FcPatternVapBuild (FcPattern *result, FcPattern *pattern,  va_list
       va);


DESCRIPTION

       Builds a pattern using a list of objects, types and values.  Each value
       to be entered in the pattern is specified with three arguments:

       1. Object name, a string describing the property to be added.

       2. Object type, one of the FcType enumerated values

       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.

       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

       pattern = FcPatternBuild (0, FC_FAMILY, FcTypeString, "Times", (char *) 0);

       FcPatternVaBuild  is used when the arguments are already in the form of
       a varargs  value.  FcPatternVapBuild  is  a  macro  version  of  FcPat-
       ternVaBuild which returns its result directly in the result variable.


VERSION

       Fontconfig version 2.9.0



                                  11 3ae 2012                FcPatternBuild(3)

fontconfig 2.9.0 - Generated Mon Apr 2 19:29:17 CDT 2012
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.