FcFileScan.3 revision a6844aab 
1.\\" auto-generated by docbook2man-spec $Revision: 1.1.1.2 $
2.TH "FcFileScan" "3" "18 November 2009" "" ""
3.SH NAME
4FcFileScan \- scan a font file
5.SH SYNOPSIS
6.nf
7\fB#include <fontconfig.h>
8.sp
9FcBool FcFileScan(FcFontSet *\fIset\fB);
10(FcStrSet *\fIdirs\fB);
11(FcFileCache *\fIcache\fB);
12(FcBlanks *\fIblanks\fB);
13(const FcChar8 *\fIfile\fB);
14(FcBool \fIforce\fB);
15\fR.fi
16.SH "DESCRIPTION"
17.PP
18Scans a single file and adds all fonts found to \fIset\fR\&.
19If \fIforce\fR is FcTrue, then the file is scanned even if
20associated information is found in \fIcache\fR\&. If
21\fIfile\fR is a directory, it is added to
22\fIdirs\fR\&. Whether fonts are found depends on fontconfig
23policy as well as the current configuration. Internally, fontconfig will
24ignore BDF and PCF fonts which are not in Unicode (or the effectively
25equivalent ISO Latin-1) encoding as those are not usable by Unicode-based
26applications. The configuration can ignore fonts based on filename or
27contents of the font file itself. Returns FcFalse if any of the fonts cannot be
28added (due to allocation failure). Otherwise returns FcTrue.
29.SH "VERSION"
30.PP
31Fontconfig version 2.8.0
32