doc/fccharset.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 @RET@           FcCharSet *
  25 @FUNC@          FcCharSetCreate
  26 @TYPE1@         void
  27 @PURPOSE@       Create an empty character set
  28 @DESC@
  29 <function>FcCharSetCreate</function> allocates and initializes a new empty
  30 character set object.
  31 @@
  32
  33 @RET@           void
  34 @FUNC@          FcCharSetDestroy
  35 @TYPE1@         FcCharSet *             @ARG1@          fcs
  36 @PURPOSE@       Destroy a character set
  37 @DESC@
  38 <function>FcCharSetDestroy</function> decrements the reference count
  39 <parameter>fcs</parameter>.  If the reference count becomes zero, all
  40 memory referenced is freed.
  41 @@
  42
  43 @RET@           FcBool
  44 @FUNC@          FcCharSetAddChar
  45 @TYPE1@         FcCharSet *             @ARG1@          fcs
  46 @TYPE2@         FcChar32%               @ARG2@          ucs4
  47 @PURPOSE@       Add a character to a charset
  48 @DESC@
  49 <function>FcCharSetAddChar</function> adds a single unicode char to the set,
  50 returning FcFalse on failure, either as a result of a constant set or from
  51 running out of memory.
  52 @@
  53
  54 @RET@           FcCharSet *
  55 @FUNC@          FcCharSetCopy
  56 @TYPE1@         FcCharSet *             @ARG1@          src
  57 @PURPOSE@       Copy a charset
  58 @DESC@
  59 Makes a copy of <parameter>src</parameter>; note that this may not actually do anything more
  60 than increment the reference count on <parameter>src</parameter>.
  61 @@
  62
  63 @RET@           FcBool
  64 @FUNC@          FcCharSetEqual
  65 @TYPE1@         const FcCharSet *       @ARG1@          a
  66 @TYPE2@         const FcCharSet *       @ARG2@          b
  67 @PURPOSE@       Compare two charsets
  68 @DESC@
  69 Returns whether <parameter>a</parameter> and <parameter>b</parameter>
  70 contain the same set of unicode chars.
  71 @@
  72
  73 @RET@           FcCharSet *
  74 @FUNC@          FcCharSetIntersect
  75 @TYPE1@         const FcCharSet *       @ARG1@          a
  76 @TYPE2@         const FcCharSet *       @ARG2@          b
  77 @PURPOSE@       Intersect charsets
  78 @DESC@
  79 Returns a set including only those chars found in both
  80 <parameter>a</parameter> and <parameter>b</parameter>.
  81 @@
  82
  83 @RET@           FcCharSet *
  84 @FUNC@          FcCharSetUnion
  85 @TYPE1@         const FcCharSet *       @ARG1@          a
  86 @TYPE2@         const FcCharSet *       @ARG2@          b
  87 @PURPOSE@       Add charsets
  88 @DESC@
  89 Returns a set including only those chars found in either <parameter>a</parameter> or <parameter>b</parameter>.
  90 @@
  91
  92 @RET@           FcCharSet *
  93 @FUNC@          FcCharSetSubtract
  94 @TYPE1@         const FcCharSet *       @ARG1@          a
  95 @TYPE2@         const FcCharSet *       @ARG2@          b
  96 @PURPOSE@       Subtract charsets
  97 @DESC@
  98 Returns a set including only those chars found in <parameter>a</parameter> but not <parameter>b</parameter>.
  99 @@
 100
 101 @RET@           FcBool
 102 @FUNC@          FcCharSetHasChar
 103 @TYPE1@         const FcCharSet *       @ARG1@          fcs
 104 @TYPE2@         FcChar32%               @ARG2@          ucs4
 105 @PURPOSE@       Check a charset for a char
 106 @DESC@
 107 Returns whether <parameter>fcs</parameter> contains the char <parameter>ucs4</parameter>.
 108 @@
 109
 110 @RET@           FcChar32
 111 @FUNC@          FcCharSetCount
 112 @TYPE1@         const FcCharSet *       @ARG1@          a
 113 @PURPOSE@       Count entries in a charset
 114 @DESC@
 115 Returns the total number of unicode chars in <parameter>a</parameter>.
 116 @@
 117
 118 @RET@           FcChar32
 119 @FUNC@          FcCharSetIntersectCount
 120 @TYPE1@         const FcCharSet *       @ARG1@          a
 121 @TYPE2@         const FcCharSet *       @ARG2@          b
 122 @PURPOSE@       Intersect and count charsets
 123 @DESC@
 124 Returns the number of chars that are in both <parameter>a</parameter> and <parameter>b</parameter>.
 125 @@
 126
 127 @RET@           FcChar32
 128 @FUNC@          FcCharSetSubtractCount
 129 @TYPE1@         const FcCharSet *       @ARG1@          a
 130 @TYPE2@         const FcCharSet *       @ARG2@          b
 131 @PURPOSE@       Subtract and count charsets
 132 @DESC@
 133 Returns the number of chars that are in <parameter>a</parameter> but not in <parameter>b</parameter>.
 134 @@
 135
 136 @RET@           FcBool
 137 @FUNC@          FcCharSetIsSubset
 138 @TYPE1@         const FcCharSet *       @ARG1@          a
 139 @TYPE2@         const FcCharSet *       @ARG2@          b
 140 @PURPOSE@       Test for charset inclusion
 141 @DESC@
 142 Returns whether <parameter>a</parameter> is a subset of <parameter>b</parameter>.
 143 @@
 144
 145 @RET@           FcChar32
 146 @FUNC@          FcCharSetFirstPage
 147 @TYPE1@         const FcCharSet *       @ARG1@          a
 148 @TYPE2@         FcChar32[FC_CHARSET_MAP_SIZE]%  @ARG2@  map
 149 @TYPE3@         FcChar32 *              @ARG3@          next
 150 @PURPOSE@       Start enumerating charset contents
 151 @DESC@
 152 Builds an array of bits marking the first page of Unicode coverage of
 153 <parameter>a</parameter>. Returns the base of the array. <parameter>next</parameter> contains the next page in the
 154 font.
 155 @@
 156
 157 @RET@           FcChar32
 158 @FUNC@          FcCharSetNextPage
 159 @TYPE1@         const FcCharSet *       @ARG1@          a
 160 @TYPE2@         FcChar32[FC_CHARSET_MAP_SIZE]%  @ARG2@  map
 161 @TYPE3@         FcChar32 *              @ARG3@          next
 162 @PURPOSE@       Continue enumerating charset contents
 163 @DESC@
 164 Builds an array of bits marking the Unicode coverage of <parameter>a</parameter> for page
 165 <parameter>*next</parameter>. Returns the base of the array. <parameter>next</parameter> contains the next page in
 166 the font.
 167 @@
 168
 169 @RET@           FcChar32
 170 @FUNC@          FcCharSetCoverage
 171 @TYPE1@         const FcCharSet *       @ARG1@          a
 172 @TYPE2@         FcChar32                @ARG2@          page
 173 @TYPE3@         FcChar32[8]             @ARG3@          result
 174 @PURPOSE@       DEPRECATED return coverage for a Unicode page
 175 @DESC@
 176 DEPRECATED
 177 This function returns a bitmask in <parameter>result</parameter> which
 178 indicates which code points in
 179 <parameter>page</parameter> are included in <parameter>a</parameter>.
 180 <function>FcCharSetCoverage</function> returns the next page in the charset which has any
 181 coverage.
 182 @@
 183
 184 @RET@           FcCharSet *
 185 @FUNC@          FcCharSetNew
 186 @TYPE1@         void
 187 @PURPOSE@       DEPRECATED alias for FcCharSetCreate
 188 @DESC@
 189 <function>FcCharSetNew</function> is a DEPRECATED alias for FcCharSetCreate.
 190 @@
 191