Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

FcFileScan (3)

Name

FcFileScan - scan a font file

Synopsis

#include <fontconfig/fontconfig.h>

FcBool FcFileScan (FcFontSet *set, FcStrSet *dirs, FcFileCache *cache, FcBlanks *blanks, const FcChar8 *file, FcBool force);

Description

FcFileScan(3)                                                    FcFileScan(3)



NAME
       FcFileScan - scan a font file

SYNOPSIS
       #include <fontconfig/fontconfig.h>

       FcBool FcFileScan (FcFontSet *set, FcStrSet *dirs, FcFileCache *cache, FcBlanks *blanks, const FcChar8 *file, FcBool force);

DESCRIPTION
       Scans  a  single  file  and  adds  all fonts found to set.  If force is
       FcTrue, then the file is scanned  even  if  associated  information  is
       found  in  cache.  If file is a directory, it is added to dirs. 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.



ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+---------------------------+
       |ATTRIBUTE TYPE |     ATTRIBUTE VALUE       |
       +---------------+---------------------------+
       |Availability   | system/library/fontconfig |
       +---------------+---------------------------+
       |Stability      | Volatile                  |
       +---------------+---------------------------+

NOTES
       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source  was  downloaded  from   https://fontconfig.org/release/fontcon-
       fig-2.14.0.tar.xz.

       Further information about this software can be found on the open source
       community website at https://fontconfig.org/.



Fontconfig 2.14.0                  31 3 2022                     FcFileScan(3)