IABSD.fr/xenocara/lib/fontconfig/doc/FcPatternBuild.3

Branch : - branch - master - tag -

• Show log

  Commit

• Author : matthieu
  Date : 2006-12-31 14:57:18
  Hash : 98dd1c2e
  Message : Fontconfig 2.4.2

• lib/fontconfig/doc/FcPatternBuild.3

• .\" 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" "02 December 2006" "" ""
  
  .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, FcTypeString, "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.4.2