Xfontcache(3)

Xfontcache(3) | Library Functions Manual | Xfontcache(3)

# 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.

X Version 11 |