]>
Commit | Line | Data |
---|---|---|
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 | @@ |