NAME
Xfontcache - X-TrueType font cache extension client library
SYNOPSIS
#include <X11/extensions/FontCache.h>
typedef struct {
long himark;
long lowmark;
long balance;
} FontCacheSettings, *FontCacheSettingsPtr;
struct cacheinfo {
long hits;
long misshits;
long purged;
long usage;
};
typedef struct {
long purge_runs;
long purge_stat;
long balance;
struct cacheinfo f;
struct cacheinfo v;
} FontCacheStatistics, *FontCacheStatisticsPtr;
Bool
FontCacheQueryExtension(Display * dpy, int * event_base_return,
int * error_base_return);
Status
FontCacheQueryVersion(Display * dpy, int *major_version_return,
int * minor_version_return);
Status
FontCacheGetCacheSettings(Display * dpy, FontCacheSettings * cache
info);
Status
FontCacheChangeCacheSettings(Display * dpy, FontCacheSettings *
cache info);
Status
FontCacheGetCacheStatistics(Display * dpy, FontCacheStatistics *
cache statistics info);
DESCRIPTION
FontCache is an extension that is used by X-TrueType to cache
informations about fonts.
FontCacheQueryExtension returns
True if the
FontCache
extension is available on the given display. A client must call
FontCacheQueryExtension before calling any other Xfontcache function in
order to negotiate a compatible protocol version; otherwise the client will
get undefined behavior (Xfontcache may or may not work).
FontCacheQueryVersion returns
True if the request succeeded; the
values of the major and minor protocol versions supported by the server are
returned in
major_version_return and
minor_version_return .
FontCacheGetCacheSettings should be documented here. Returns
True
on success or
False on failure.
FontCacheChangeCacheSettings should be documented here. Returns
True on success or
False on failure.
FontCacheGetCacheStatistics should be documented here. Returns
True on success or
False on failure.
ERRORS
FontCacheChangeCacheSettings will return
BadValue if passed an
illegal parameters for lowmark, himark or balance fields.
SEE ALSO
X(7)
AUTHOR
Akio Morita, X-TrueType team, Nozomi Ytow.
STABILITY
This API is considered as experimental. The Xfontcache library major revision
may be incremented whenever incompatible changes are done to the API without
notice. Use with care.