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