doc/fcfile.fncs

   1 /*
   2  * $Id$
   3  *
   4  * Copyright © 2003 Keith Packard
   5  *
   6  * Permission to use, copy, modify, distribute, and sell this software and its
   7  * documentation for any purpose is hereby granted without fee, provided that
   8  * the above copyright notice appear in all copies and that both that
   9  * copyright notice and this permission notice appear in supporting
  10  * documentation, and that the name of Keith Packard not be used in
  11  * advertising or publicity pertaining to distribution of the software without
  12  * specific, written prior permission.  Keith Packard makes no
  13  * representations about the suitability of this software for any purpose.  It
  14  * is provided "as is" without express or implied warranty.
  15  *
  16  * KEITH PACKARD DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
  17  * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
  18  * EVENT SHALL KEITH PACKARD BE LIABLE FOR ANY SPECIAL, INDIRECT OR
  19  * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
  20  * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
  21  * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  22  * PERFORMANCE OF THIS SOFTWARE.
  23  */
  24
  25 @RET@           FcBool
  26 @FUNC@          FcFileScan
  27 @TYPE1@         FcFontSet *                     @ARG1@          set
  28 @TYPE2@         FcStrSet *                      @ARG2@          dirs
  29 @TYPE3@         FcFileCache *                   @ARG3@          cache
  30 @TYPE4@         FcBlanks *                      @ARG4@          blanks
  31 @TYPE5@         const FcChar8 *                 @ARG5@          file
  32 @TYPE6@         FcBool%                                 @ARG6@          force
  33 @PURPOSE@       scan a font file
  34 @DESC@
  35 Scans a single file and adds all fonts found to <parameter>set</parameter>.
  36 If <parameter>force</parameter> is FcTrue, then the file is scanned even if
  37 associated information is found in <parameter>cache</parameter>.  If
  38 <parameter>file</parameter> is a directory, it is added to
  39 <parameter>dirs</parameter>. Whether fonts are found depends on fontconfig
  40 policy as well as the current configuration. Internally, fontconfig will
  41 ignore BDF and PCF fonts which are not in Unicode (or the effectively
  42 equivalent ISO Latin-1) encoding as those are not usable by Unicode-based
  43 applications. The configuration can ignore fonts based on filename or
  44 contents of the font file itself. Returns FcFalse if any of the fonts cannot be
  45 added (due to allocation failure). Otherwise returns FcTrue.
  46 @@
  47
  48 @RET@           FcBool
  49 @FUNC@          FcFileIsDir
  50 @TYPE1@         const FcChar8 *                 @ARG1@          file
  51 @PURPOSE@       check whether a file is a directory
  52 @DESC@
  53 Returns FcTrue if <parameter>file</parameter> is a directory, otherwise
  54 returns FcFalse.
  55 @@
  56
  57 @RET@           FcBool
  58 @FUNC@          FcDirScan
  59 @TYPE1@         FcFontSet *                     @ARG1@          set
  60 @TYPE2@         FcStrSet *                      @ARG2@          dirs
  61 @TYPE3@         FcFileCache *                   @ARG3@          cache
  62 @TYPE4@         FcBlanks *                      @ARG4@          blanks
  63 @TYPE5@         const FcChar8 *                 @ARG5@          dir
  64 @TYPE6@         FcBool%                                 @ARG6@          force
  65 @PURPOSE@       DEPRECATED: formerly used to scan a font directory
  66 @DESC@
  67 This function does nothing aside from returning FcFalse. It used to scan an
  68 entire directory and add all fonts found to
  69 <parameter>set</parameter>.  If <parameter>force</parameter> was FcTrue, then
  70 the directory and all files within it were scanned even if information was
  71 present in the per-directory cache file or <parameter>cache</parameter>. Any
  72 subdirectories found were added to <parameter>dirs</parameter>.
  73 @@
  74
  75 @RET@           FcBool
  76 @FUNC@          FcDirSave
  77 @TYPE1@         FcFontSet *                     @ARG1@          set
  78 @TYPE2@         FcStrSet *                      @ARG2@          dirs
  79 @TYPE3@         const FcChar8 *                 @ARG3@          dir
  80 @PURPOSE@       DEPRECATED: formerly used to save a directory cache
  81 @DESC@
  82 This function now does nothing aside from returning FcFalse. It used to creates the
  83 per-directory cache file for <parameter>dir</parameter> and populates it
  84 with the fonts in <parameter>set</parameter> and subdirectories in
  85 <parameter>dirs</parameter>. All of this functionality is now automatically
  86 managed by FcDirCacheLoad and FcDirCacheRead.
  87 @@
  88