fcpatternbuild.html revision 1.1.1.7
1 1.1 mrg <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2 1.1 mrg <HTML 3 1.1 mrg ><HEAD 4 1.1 mrg ><TITLE 5 1.1 mrg >FcPatternBuild</TITLE 6 1.1 mrg ><META 7 1.1 mrg NAME="GENERATOR" 8 1.1 mrg CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK 9 1.1 mrg REL="HOME" 10 1.1 mrg HREF="t1.html"><LINK 11 1.1 mrg REL="UP" 12 1.1 mrg TITLE="FcPattern" 13 1.1.1.7 mrg HREF="x103.html#AEN242"><LINK 14 1.1 mrg REL="PREVIOUS" 15 1.1 mrg TITLE="FcPatternGet-Type" 16 1.1 mrg HREF="fcpatternget-type.html"><LINK 17 1.1 mrg REL="NEXT" 18 1.1 mrg TITLE="FcPatternDel" 19 1.1 mrg HREF="fcpatterndel.html"></HEAD 20 1.1 mrg ><BODY 21 1.1 mrg CLASS="REFENTRY" 22 1.1 mrg BGCOLOR="#FFFFFF" 23 1.1 mrg TEXT="#000000" 24 1.1 mrg LINK="#0000FF" 25 1.1 mrg VLINK="#840084" 26 1.1 mrg ALINK="#0000FF" 27 1.1 mrg ><DIV 28 1.1 mrg CLASS="NAVHEADER" 29 1.1 mrg ><TABLE 30 1.1 mrg SUMMARY="Header navigation table" 31 1.1 mrg WIDTH="100%" 32 1.1 mrg BORDER="0" 33 1.1 mrg CELLPADDING="0" 34 1.1 mrg CELLSPACING="0" 35 1.1 mrg ><TR 36 1.1 mrg ><TH 37 1.1 mrg COLSPAN="3" 38 1.1 mrg ALIGN="center" 39 1.1 mrg ></TH 40 1.1 mrg ></TR 41 1.1 mrg ><TR 42 1.1 mrg ><TD 43 1.1 mrg WIDTH="10%" 44 1.1 mrg ALIGN="left" 45 1.1 mrg VALIGN="bottom" 46 1.1 mrg ><A 47 1.1 mrg HREF="fcpatternget-type.html" 48 1.1 mrg ACCESSKEY="P" 49 1.1 mrg ><<< Previous</A 50 1.1 mrg ></TD 51 1.1 mrg ><TD 52 1.1 mrg WIDTH="80%" 53 1.1 mrg ALIGN="center" 54 1.1 mrg VALIGN="bottom" 55 1.1 mrg ></TD 56 1.1 mrg ><TD 57 1.1 mrg WIDTH="10%" 58 1.1 mrg ALIGN="right" 59 1.1 mrg VALIGN="bottom" 60 1.1 mrg ><A 61 1.1 mrg HREF="fcpatterndel.html" 62 1.1 mrg ACCESSKEY="N" 63 1.1 mrg >Next >>></A 64 1.1 mrg ></TD 65 1.1 mrg ></TR 66 1.1 mrg ></TABLE 67 1.1 mrg ><HR 68 1.1 mrg ALIGN="LEFT" 69 1.1 mrg WIDTH="100%"></DIV 70 1.1 mrg ><H1 71 1.1 mrg ><A 72 1.1 mrg NAME="FCPATTERNBUILD" 73 1.1 mrg ></A 74 1.1 mrg >FcPatternBuild</H1 75 1.1 mrg ><DIV 76 1.1 mrg CLASS="REFNAMEDIV" 77 1.1 mrg ><A 78 1.1.1.7 mrg NAME="AEN785" 79 1.1 mrg ></A 80 1.1 mrg ><H2 81 1.1 mrg >Name</H2 82 1.1 mrg >FcPatternBuild, FcPatternVaBuild, FcPatternVapBuild -- Create patterns from arguments</DIV 83 1.1 mrg ><DIV 84 1.1 mrg CLASS="REFSYNOPSISDIV" 85 1.1 mrg ><A 86 1.1.1.7 mrg NAME="AEN790" 87 1.1 mrg ></A 88 1.1 mrg ><H2 89 1.1 mrg >Synopsis</H2 90 1.1 mrg ><DIV 91 1.1 mrg CLASS="FUNCSYNOPSIS" 92 1.1 mrg ><P 93 1.1 mrg ></P 94 1.1 mrg ><A 95 1.1.1.7 mrg NAME="AEN791" 96 1.1 mrg ></A 97 1.1 mrg ><TABLE 98 1.1 mrg BORDER="0" 99 1.1 mrg BGCOLOR="#E0E0E0" 100 1.1 mrg WIDTH="100%" 101 1.1 mrg ><TR 102 1.1 mrg ><TD 103 1.1 mrg ><PRE 104 1.1 mrg CLASS="FUNCSYNOPSISINFO" 105 1.1.1.3 mrg >#include <fontconfig/fontconfig.h> 106 1.1 mrg </PRE 107 1.1 mrg ></TD 108 1.1 mrg ></TR 109 1.1 mrg ></TABLE 110 1.1 mrg ><P 111 1.1 mrg ><CODE 112 1.1 mrg ><CODE 113 1.1 mrg CLASS="FUNCDEF" 114 1.1 mrg >FcPattern * <TT 115 1.1 mrg CLASS="FUNCTION" 116 1.1 mrg >FcPatternBuild</TT 117 1.1 mrg ></CODE 118 1.1 mrg >(FcPattern *<TT 119 1.1 mrg CLASS="PARAMETER" 120 1.1 mrg ><I 121 1.1 mrg >pattern</I 122 1.1 mrg ></TT 123 1.1 mrg >, ...<TT 124 1.1 mrg CLASS="PARAMETER" 125 1.1 mrg ><I 126 1.1 mrg ></I 127 1.1 mrg ></TT 128 1.1 mrg >);</CODE 129 1.1 mrg ></P 130 1.1 mrg ><P 131 1.1 mrg ><CODE 132 1.1 mrg ><CODE 133 1.1 mrg CLASS="FUNCDEF" 134 1.1 mrg >FcPattern * <TT 135 1.1 mrg CLASS="FUNCTION" 136 1.1 mrg >FcPatternVaBuild</TT 137 1.1 mrg ></CODE 138 1.1 mrg >(FcPattern *<TT 139 1.1 mrg CLASS="PARAMETER" 140 1.1 mrg ><I 141 1.1 mrg >pattern</I 142 1.1 mrg ></TT 143 1.1 mrg >, va_list <TT 144 1.1 mrg CLASS="PARAMETER" 145 1.1 mrg ><I 146 1.1 mrg >va</I 147 1.1 mrg ></TT 148 1.1 mrg >);</CODE 149 1.1 mrg ></P 150 1.1 mrg ><P 151 1.1 mrg ><CODE 152 1.1 mrg ><CODE 153 1.1 mrg CLASS="FUNCDEF" 154 1.1 mrg >void <TT 155 1.1 mrg CLASS="FUNCTION" 156 1.1 mrg >FcPatternVapBuild</TT 157 1.1 mrg ></CODE 158 1.1 mrg >(FcPattern *<TT 159 1.1 mrg CLASS="PARAMETER" 160 1.1 mrg ><I 161 1.1 mrg >result</I 162 1.1 mrg ></TT 163 1.1 mrg >, FcPattern *<TT 164 1.1 mrg CLASS="PARAMETER" 165 1.1 mrg ><I 166 1.1 mrg >pattern</I 167 1.1 mrg ></TT 168 1.1 mrg >, va_list <TT 169 1.1 mrg CLASS="PARAMETER" 170 1.1 mrg ><I 171 1.1 mrg >va</I 172 1.1 mrg ></TT 173 1.1 mrg >);</CODE 174 1.1 mrg ></P 175 1.1 mrg ><P 176 1.1 mrg ></P 177 1.1 mrg ></DIV 178 1.1 mrg ></DIV 179 1.1 mrg ><DIV 180 1.1 mrg CLASS="REFSECT1" 181 1.1 mrg ><A 182 1.1.1.7 mrg NAME="AEN816" 183 1.1 mrg ></A 184 1.1 mrg ><H2 185 1.1 mrg >Description</H2 186 1.1 mrg ><P 187 1.1 mrg >Builds a pattern using a list of objects, types and values. Each 188 1.1 mrg value to be entered in the pattern is specified with three arguments:</P 189 1.1 mrg ><P 190 1.1 mrg ></P 191 1.1 mrg ><OL 192 1.1 mrg TYPE="1" 193 1.1 mrg ><LI 194 1.1 mrg ><P 195 1.1 mrg >Object name, a string describing the property to be added.</P 196 1.1 mrg ></LI 197 1.1 mrg ><LI 198 1.1 mrg ><P 199 1.1 mrg >Object type, one of the FcType enumerated values</P 200 1.1 mrg ></LI 201 1.1 mrg ><LI 202 1.1 mrg ><P 203 1.1 mrg >Value, not an FcValue, but the raw type as passed to any of the 204 1.1 mrg FcPatternAdd<type> functions. Must match the type of the second 205 1.1 mrg argument.</P 206 1.1 mrg ></LI 207 1.1 mrg ></OL 208 1.1 mrg ><P 209 1.1 mrg >The argument list is terminated by a null object name, no object type nor 210 1.1 mrg value need be passed for this. The values are added to `pattern', if 211 1.1 mrg `pattern' is null, a new pattern is created. In either case, the pattern is 212 1.1 mrg returned. Example</P 213 1.1 mrg ><TABLE 214 1.1 mrg BORDER="0" 215 1.1 mrg BGCOLOR="#E0E0E0" 216 1.1 mrg WIDTH="100%" 217 1.1 mrg ><TR 218 1.1 mrg ><TD 219 1.1 mrg ><PRE 220 1.1 mrg CLASS="PROGRAMLISTING" 221 1.1 mrg >pattern = FcPatternBuild (0, FC_FAMILY, FcTypeString, "Times", (char *) 0);</PRE 222 1.1 mrg ></TD 223 1.1 mrg ></TR 224 1.1 mrg ></TABLE 225 1.1 mrg ><P 226 1.1 mrg >FcPatternVaBuild is used when the arguments are already in the form of a 227 1.1 mrg varargs value. FcPatternVapBuild is a macro version of FcPatternVaBuild 228 1.1 mrg which returns its result directly in the <TT 229 1.1 mrg CLASS="PARAMETER" 230 1.1 mrg ><I 231 1.1 mrg >result</I 232 1.1 mrg ></TT 233 1.1 mrg > 234 1.1 mrg variable. 235 1.1 mrg </P 236 1.1 mrg ></DIV 237 1.1 mrg ><DIV 238 1.1 mrg CLASS="NAVFOOTER" 239 1.1 mrg ><HR 240 1.1 mrg ALIGN="LEFT" 241 1.1 mrg WIDTH="100%"><TABLE 242 1.1 mrg SUMMARY="Footer navigation table" 243 1.1 mrg WIDTH="100%" 244 1.1 mrg BORDER="0" 245 1.1 mrg CELLPADDING="0" 246 1.1 mrg CELLSPACING="0" 247 1.1 mrg ><TR 248 1.1 mrg ><TD 249 1.1 mrg WIDTH="33%" 250 1.1 mrg ALIGN="left" 251 1.1 mrg VALIGN="top" 252 1.1 mrg ><A 253 1.1 mrg HREF="fcpatternget-type.html" 254 1.1 mrg ACCESSKEY="P" 255 1.1 mrg ><<< Previous</A 256 1.1 mrg ></TD 257 1.1 mrg ><TD 258 1.1 mrg WIDTH="34%" 259 1.1 mrg ALIGN="center" 260 1.1 mrg VALIGN="top" 261 1.1 mrg ><A 262 1.1 mrg HREF="t1.html" 263 1.1 mrg ACCESSKEY="H" 264 1.1 mrg >Home</A 265 1.1 mrg ></TD 266 1.1 mrg ><TD 267 1.1 mrg WIDTH="33%" 268 1.1 mrg ALIGN="right" 269 1.1 mrg VALIGN="top" 270 1.1 mrg ><A 271 1.1 mrg HREF="fcpatterndel.html" 272 1.1 mrg ACCESSKEY="N" 273 1.1 mrg >Next >>></A 274 1.1 mrg ></TD 275 1.1 mrg ></TR 276 1.1 mrg ><TR 277 1.1 mrg ><TD 278 1.1 mrg WIDTH="33%" 279 1.1 mrg ALIGN="left" 280 1.1 mrg VALIGN="top" 281 1.1 mrg >FcPatternGet-Type</TD 282 1.1 mrg ><TD 283 1.1 mrg WIDTH="34%" 284 1.1 mrg ALIGN="center" 285 1.1 mrg VALIGN="top" 286 1.1 mrg ><A 287 1.1.1.7 mrg HREF="x103.html#AEN242" 288 1.1 mrg ACCESSKEY="U" 289 1.1 mrg >Up</A 290 1.1 mrg ></TD 291 1.1 mrg ><TD 292 1.1 mrg WIDTH="33%" 293 1.1 mrg ALIGN="right" 294 1.1 mrg VALIGN="top" 295 1.1 mrg >FcPatternDel</TD 296 1.1 mrg ></TR 297 1.1 mrg ></TABLE 298 1.1 mrg ></DIV 299 1.1 mrg ></BODY 300 1.1 mrg ></HTML 301 1.1 mrg >
Indexes created Tue Oct 27 00:25:24 UTC 2026