doc/fontconfig-devel/fcdirscan.html

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