


Xfontcache(3)					    Xfontcache(3)


NAME
       Xfontcache   -  X-TrueType  font	 cache	extension  client
       library

SYNOPSIS
       #include <X11/extension/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 cacheinfof;
	    struct cacheinfov;
       } FontCacheStatistics, *FontCacheStatisticsPtr;

       Bool	FontCacheQueryExtension(Display	    *dpy,     int
	      *event_basep, int *error_basep);

       Status FontCacheQueryVersion(Display *dpy, int *major_ver_
	      sionp, int *minor_versionp);

       Status	FontCacheGetCacheSettings(Display   *dpy,   Font
	      CacheSettings *cache info);

       Status  FontCacheChangeCacheSettings(Display  *dpy,  Font
	      CacheSettings *cache info);

       Status  FontCacheGetCacheStatistics(Display  *dpy,   Font
	      CacheStatistics *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).



XFree86			  Version 4.8.0				1





Xfontcache(3)					    Xfontcache(3)


       FontCacheQueryVersion  returns  True  if	 the request suc
       ceeded; the values of the major and  minor  protocol  ver
       sions  supported	 by the server are returned in major_ver_
       sionp and minor_versionp .

       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  bal
       ance fields.

SEE ALSO
       Xlib(1), 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  incom
       patible	changes	 are  done to the API without notice. Use
       with care.



























XFree86			  Version 4.8.0				2


