<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd"> <HTML ><HEAD ><TITLE >FcFileScan</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK REL="HOME" HREF="t1.html"><LINK REL="UP" TITLE="File and Directory routines" HREF="x102.html#AEN3660"><LINK REL="PREVIOUS" TITLE="FUNCTIONS" HREF="x102.html"><LINK REL="NEXT" TITLE="FcFileIsDir" HREF="fcfileisdir.html"></HEAD ><BODY CLASS="REFENTRY" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" ></TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="x102.html" ACCESSKEY="P" ><<< Previous</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="fcfileisdir.html" ACCESSKEY="N" >Next >>></A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><H1 ><A NAME="FCFILESCAN" ></A >FcFileScan</H1 ><DIV CLASS="REFNAMEDIV" ><A NAME="AEN3668" ></A ><H2 >Name</H2 >FcFileScan -- scan a font file</DIV ><DIV CLASS="REFSYNOPSISDIV" ><A NAME="AEN3671" ></A ><H2 >Synopsis</H2 ><DIV CLASS="FUNCSYNOPSIS" ><P ></P ><A NAME="AEN3672" ></A ><TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><PRE CLASS="FUNCSYNOPSISINFO" >#include <fontconfig/fontconfig.h> </PRE ></TD ></TR ></TABLE ><P ><CODE ><CODE CLASS="FUNCDEF" >FcBool <TT CLASS="FUNCTION" >FcFileScan</TT ></CODE >(FcFontSet *<TT CLASS="PARAMETER" ><I >set</I ></TT >, FcStrSet *<TT CLASS="PARAMETER" ><I >dirs</I ></TT >, FcFileCache *<TT CLASS="PARAMETER" ><I >cache</I ></TT >, FcBlanks *<TT CLASS="PARAMETER" ><I >blanks</I ></TT >, const FcChar8 *<TT CLASS="PARAMETER" ><I >file</I ></TT >, FcBool <TT CLASS="PARAMETER" ><I >force</I ></TT >);</CODE ></P ><P ></P ></DIV ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN3689" ></A ><H2 >Description</H2 ><P >Scans a single file and adds all fonts found to <TT CLASS="PARAMETER" ><I >set</I ></TT >. If <TT CLASS="PARAMETER" ><I >force</I ></TT > is FcTrue, then the file is scanned even if associated information is found in <TT CLASS="PARAMETER" ><I >cache</I ></TT >. If <TT CLASS="PARAMETER" ><I >file</I ></TT > is a directory, it is added to <TT CLASS="PARAMETER" ><I >dirs</I ></TT >. Whether fonts are found depends on fontconfig policy as well as the current configuration. Internally, fontconfig will ignore BDF and PCF fonts which are not in Unicode (or the effectively equivalent ISO Latin-1) encoding as those are not usable by Unicode-based applications. The configuration can ignore fonts based on filename or contents of the font file itself. Returns FcFalse if any of the fonts cannot be added (due to allocation failure). Otherwise returns FcTrue. </P ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="x102.html" ACCESSKEY="P" ><<< Previous</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="t1.html" ACCESSKEY="H" >Home</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="fcfileisdir.html" ACCESSKEY="N" >Next >>></A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >FUNCTIONS</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="x102.html#AEN3660" ACCESSKEY="U" >Up</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >FcFileIsDir</TD ></TR ></TABLE ></DIV ></BODY ></HTML >