doc/fccache.fncs

   1 /*
   2  * Copyright © 2007 Keith Packard
   3  *
   4  * Permission to use, copy, modify, distribute, and sell this software and its
   5  * documentation for any purpose is hereby granted without fee, provided that
   6  * the above copyright notice appear in all copies and that both that
   7  * copyright notice and this permission notice appear in supporting
   8  * documentation, and that the name of Keith Packard not be used in
   9  * advertising or publicity pertaining to distribution of the software without
  10  * specific, written prior permission.  Keith Packard makes no
  11  * representations about the suitability of this software for any purpose.  It
  12  * is provided "as is" without express or implied warranty.
  13  *
  14  * THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
  15  * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
  16  * EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
  17  * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
  18  * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
  19  * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  20  * PERFORMANCE OF THIS SOFTWARE.
  21  */
  22
  23 @RET@           const FcChar8 *
  24 @FUNC@          FcCacheDir
  25 @TYPE1@         const FcCache *                 @ARG1@          cache
  26 @PURPOSE@       Return directory of <parameter>cache</parameter>
  27 @DESC@
  28 This function returns the directory from which the cache was constructed.
  29 @@
  30
  31 @RET@           FcFontSet *
  32 @FUNC@          FcCacheCopySet
  33 @TYPE1@         const FcCache *                 @ARG1@          cache
  34 @PURPOSE@       Returns a copy of the fontset from <parameter>cache</parameter>
  35 @DESC@
  36 The returned fontset contains each of the font patterns from
  37 <parameter>cache</parameter>. This fontset may be modified, but the patterns
  38 from the cache are read-only.
  39 @@
  40
  41 @RET@           const FcChar8 *
  42 @FUNC@          FcCacheSubdir
  43 @TYPE1@         const FcCache *                 @ARG1@          cache
  44 @TYPE2@         int                             @ARG2@          i
  45 @PURPOSE@       Return the <parameter>i</parameter>'th subdirectory.
  46 @DESC@
  47 The set of subdirectories stored in a cache file are indexed by this
  48 function, <parameter>i</parameter> should range from 0 to
  49 <parameter>n</parameter>-1, where <parameter>n</parameter> is the return
  50 value from FcCacheNumSubdir.
  51 @@
  52
  53 @RET@           int
  54 @FUNC@          FcCacheNumSubdir
  55 @TYPE1@         const FcCache *                 @ARG1@          cache
  56 @PURPOSE@       Return the number of subdirectories in <parameter>cache</parameter>.
  57 @DESC@
  58 This returns the total number of subdirectories in the cache.
  59 @@
  60
  61 @RET@           int
  62 @FUNC@          FcCacheNumFont
  63 @TYPE1@         const FcCache *                 @ARG1@          cache
  64 @PURPOSE@       Returns the number of fonts in <parameter>cache</parameter>.
  65 @DESC@
  66 This returns the number of fonts which would be included in the return from
  67 FcCacheCopySet.
  68 @@