1Xfontcache(3)              Library Functions Manual              Xfontcache(3)
2
3
4

NAME

6       Xfontcache - X-TrueType font cache extension client library
7

SYNOPSIS

9       #include <X11/extensions/FontCache.h>
10
11       typedef struct {
12            long           himark;
13            long           lowmark;
14            long           balance;
15       } FontCacheSettings, *FontCacheSettingsPtr;
16
17       struct cacheinfo {
18            long           hits;
19            long           misshits;
20            long           purged;
21            long           usage;
22       };
23
24       typedef struct {
25            long           purge_runs;
26            long           purge_stat;
27            long           balance;
28            struct cacheinfof;
29            struct cacheinfov;
30       } FontCacheStatistics, *FontCacheStatisticsPtr;
31
32       Bool   FontCacheQueryExtension(Display   *dpy,  int  *event_basep,  int
33              *error_basep);
34
35       Status FontCacheQueryVersion(Display  *dpy,  int  *major_versionp,  int
36              *minor_versionp);
37
38       Status FontCacheGetCacheSettings(Display *dpy, FontCacheSettings *cache
39              info);
40
41       Status  FontCacheChangeCacheSettings(Display  *dpy,   FontCacheSettings
42              *cache info);
43
44       Status  FontCacheGetCacheStatistics(Display  *dpy,  FontCacheStatistics
45              *cache statistics info);
46

DESCRIPTION

48       FontCache is an extension that is used by X-TrueType to cache  informa‐
49       tions about fonts.
50
51       FontCacheQueryExtension  returns  True  if  the  FontCache extension is
52       available on the given display.  A client must  call  FontCacheQueryEx‐
53       tension  before calling any other Xfontcache function in order to nego‐
54       tiate a compatible protocol version;  otherwise  the  client  will  get
55       undefined behavior (Xfontcache may or may not work).
56
57       FontCacheQueryVersion returns True if the request succeeded; the values
58       of the major and minor protocol versions supported by  the  server  are
59       returned in major_versionp and minor_versionp .
60
61       FontCacheGetCacheSettings  should  be documented here.  Returns True on
62       success or False on failure.
63
64       FontCacheChangeCacheSettings should be documented here.   Returns  True
65       on success or False on failure.
66
67       FontCacheGetCacheStatistics should be documented here.  Returns True on
68       success or False on failure.
69

ERRORS

71       FontCacheChangeCacheSettings will return BadValue if passed an  illegal
72       parameters for lowmark, himark or balance fields.
73

SEE ALSO

75       X(7)
76

AUTHOR

78       Akio Morita, X-TrueType team, Nozomi Ytow.
79

STABILITY

81       This  API  is  considered as experimental. The Xfontcache library major
82       revision may be incremented whenever incompatible changes are  done  to
83       the API without notice. Use with care.
84
85
86
87X Version 11                  libXfontcache 1.0.4                Xfontcache(3)