doc/fcfreetype.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 @SYNOPSIS@
  26 #include &lt;fontconfig.h&gt;
  27 #include &lt;fcfreetype.h&gt;
  28 @RET@           FT_UInt
  29 @FUNC@          FcFreeTypeCharIndex
  30 @TYPE1@         FT_Face%                        @ARG1@          face
  31 @TYPE2@         FcChar32%                       @ARG2@          ucs4
  32 @PURPOSE@       map Unicode to glyph id
  33 @DESC@
  34 Maps a Unicode char to a glyph index.  This function uses information from
  35 several possible underlying encoding tables to work around broken fonts.
  36 As a result, this function isn't designed to be used in performance
  37 sensitive areas; results from this function are intended to be cached by
  38 higher level functions.
  39 @@
  40
  41 @SYNOPSIS@
  42 #include &lt;fontconfig.h&gt;
  43 #include &lt;fcfreetype.h&gt;
  44 @RET@           FcCharSet *
  45 @FUNC@          FcFreeTypeCharSet
  46 @TYPE1@         FT_Face%                        @ARG1@          face
  47 @TYPE2@         FcBlanks *                      @ARG2@          blanks
  48 @PURPOSE@       compute unicode coverage
  49 @DESC@
  50 Scans a FreeType face and returns the set of encoded Unicode chars.  This scans
  51 several encoding tables to build as complete a list as possible.
  52 If 'blanks' is not 0, the glyphs in the font are examined and any blank glyphs
  53 not in 'blanks' are not placed in the returned FcCharSet.
  54 @@
  55
  56 @SYNOPSIS@
  57 #include &lt;fontconfig.h&gt;
  58 #include &lt;fcfreetype.h&gt;
  59 @RET@           FcPattern *
  60 @FUNC@          FcFreeTypeQuery
  61 @TYPE1@         const char *                    @ARG1@          file
  62 @TYPE2@         int%                            @ARG2@          id
  63 @TYPE3@         FcBlanks *                      @ARG3@          blanks
  64 @TYPE4@         int *                           @ARG4@          count
  65 @PURPOSE@       compute pattern from font file (and index)
  66 @DESC@
  67 Constructs a pattern representing the 'id'th font in 'file'.  The number
  68 of fonts in 'file' is returned in 'count'.
  69 @@
  70
  71 @SYNOPSIS@
  72 #include &lt;fontconfig.h&gt;
  73 #include &lt;fcfreetype.h&gt;
  74 @RET@           FcPattern *
  75 @FUNC@          FcFreeTypeQueryFace
  76 @TYPE1@         const FT_Face%                  @ARG1@          face
  77 @TYPE2@         const char *                    @ARG2@          file
  78 @TYPE3@         int%                            @ARG3@          id
  79 @TYPE4@         FcBlanks *                      @ARG4@          blanks
  80 @PURPOSE@       compute pattern from FT_Face
  81 @DESC@
  82 Constructs a pattern representing 'face'. 'file' and 'id' are used solely as
  83 data for pattern elements (FC_FILE, FC_INDEX and sometimes FC_FAMILY).
  84 @@