fcdirscan.html revision a6844aab 
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd">
2<HTML
3><HEAD
4><TITLE
5>FcDirScan</TITLE
6><META
7NAME="GENERATOR"
8CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
9REL="HOME"
10HREF="t1.html"><LINK
11REL="UP"
12TITLE="File and Directory routines"
13HREF="x102.html#AEN3706"><LINK
14REL="PREVIOUS"
15TITLE="FcFileIsDir"
16HREF="fcfileisdir.html"><LINK
17REL="NEXT"
18TITLE="FcDirSave"
19HREF="fcdirsave.html"></HEAD
20><BODY
21CLASS="REFENTRY"
22BGCOLOR="#FFFFFF"
23TEXT="#000000"
24LINK="#0000FF"
25VLINK="#840084"
26ALINK="#0000FF"
27><DIV
28CLASS="NAVHEADER"
29><TABLE
30SUMMARY="Header navigation table"
31WIDTH="100%"
32BORDER="0"
33CELLPADDING="0"
34CELLSPACING="0"
35><TR
36><TH
37COLSPAN="3"
38ALIGN="center"
39></TH
40></TR
41><TR
42><TD
43WIDTH="10%"
44ALIGN="left"
45VALIGN="bottom"
46><A
47HREF="fcfileisdir.html"
48ACCESSKEY="P"
49>&#60;&#60;&#60; Previous</A
50></TD
51><TD
52WIDTH="80%"
53ALIGN="center"
54VALIGN="bottom"
55></TD
56><TD
57WIDTH="10%"
58ALIGN="right"
59VALIGN="bottom"
60><A
61HREF="fcdirsave.html"
62ACCESSKEY="N"
63>Next &#62;&#62;&#62;</A
64></TD
65></TR
66></TABLE
67><HR
68ALIGN="LEFT"
69WIDTH="100%"></DIV
70><H1
71><A
72NAME="FCDIRSCAN"
73></A
74>FcDirScan</H1
75><DIV
76CLASS="REFNAMEDIV"
77><A
78NAME="AEN3771"
79></A
80><H2
81>Name</H2
82>FcDirScan&nbsp;--&nbsp;scan a font directory without caching it</DIV
83><DIV
84CLASS="REFSYNOPSISDIV"
85><A
86NAME="AEN3774"
87></A
88><H2
89>Synopsis</H2
90><DIV
91CLASS="FUNCSYNOPSIS"
92><P
93></P
94><A
95NAME="AEN3775"
96></A
97><TABLE
98BORDER="0"
99BGCOLOR="#E0E0E0"
100WIDTH="100%"
101><TR
102><TD
103><PRE
104CLASS="FUNCSYNOPSISINFO"
105>#include &#60;fontconfig.h&#62;
106	</PRE
107></TD
108></TR
109></TABLE
110><P
111><CODE
112><CODE
113CLASS="FUNCDEF"
114>FcBool <TT
115CLASS="FUNCTION"
116>FcDirScan</TT
117></CODE
118>(FcFontSet *<TT
119CLASS="PARAMETER"
120><I
121>set</I
122></TT
123>, FcStrSet *<TT
124CLASS="PARAMETER"
125><I
126>dirs</I
127></TT
128>, FcFileCache *<TT
129CLASS="PARAMETER"
130><I
131>cache</I
132></TT
133>, FcBlanks *<TT
134CLASS="PARAMETER"
135><I
136>blanks</I
137></TT
138>, const FcChar8 *<TT
139CLASS="PARAMETER"
140><I
141>dir</I
142></TT
143>, FcBool <TT
144CLASS="PARAMETER"
145><I
146>force</I
147></TT
148>);</CODE
149></P
150><P
151></P
152></DIV
153></DIV
154><DIV
155CLASS="REFSECT1"
156><A
157NAME="AEN3792"
158></A
159><H2
160>Description</H2
161><P
162>If <TT
163CLASS="PARAMETER"
164><I
165>cache</I
166></TT
167> is not zero or if <TT
168CLASS="PARAMETER"
169><I
170>force</I
171></TT
172>
173is FcFalse, this function currently returns FcFalse.  Otherwise, it scans an
174entire directory and adds all fonts found to <TT
175CLASS="PARAMETER"
176><I
177>set</I
178></TT
179>.
180Any subdirectories found are added to <TT
181CLASS="PARAMETER"
182><I
183>dirs</I
184></TT
185>.  Calling
186this function does not create any cache files.  Use FcDirCacheRead() if
187caching is desired.
188	    </P
189></DIV
190><DIV
191CLASS="REFSECT1"
192><A
193NAME="AEN3799"
194></A
195><H2
196>Version</H2
197><P
198>Fontconfig version 2.8.0
199
200	    </P
201></DIV
202><DIV
203CLASS="NAVFOOTER"
204><HR
205ALIGN="LEFT"
206WIDTH="100%"><TABLE
207SUMMARY="Footer navigation table"
208WIDTH="100%"
209BORDER="0"
210CELLPADDING="0"
211CELLSPACING="0"
212><TR
213><TD
214WIDTH="33%"
215ALIGN="left"
216VALIGN="top"
217><A
218HREF="fcfileisdir.html"
219ACCESSKEY="P"
220>&#60;&#60;&#60; Previous</A
221></TD
222><TD
223WIDTH="34%"
224ALIGN="center"
225VALIGN="top"
226><A
227HREF="t1.html"
228ACCESSKEY="H"
229>Home</A
230></TD
231><TD
232WIDTH="33%"
233ALIGN="right"
234VALIGN="top"
235><A
236HREF="fcdirsave.html"
237ACCESSKEY="N"
238>Next &#62;&#62;&#62;</A
239></TD
240></TR
241><TR
242><TD
243WIDTH="33%"
244ALIGN="left"
245VALIGN="top"
246>FcFileIsDir</TD
247><TD
248WIDTH="34%"
249ALIGN="center"
250VALIGN="top"
251><A
252HREF="x102.html#AEN3706"
253ACCESSKEY="U"
254>Up</A
255></TD
256><TD
257WIDTH="33%"
258ALIGN="right"
259VALIGN="top"
260>FcDirSave</TD
261></TR
262></TABLE
263></DIV
264></BODY
265></HTML
266>